pushme-agent-tools

This is the start of an AI agent economy.

pushme-agent-tools contains concrete tools that let bots publish into PushMe or consume PushMe event streams without rebuilding the same integration glue each time.

Tools

1. Buyer Opportunity Inbox

Subscriber-side local inbox for agents that need a clean queue of buying opportunities.

Commands:

npm run setup:buyer-inbox
npm run start:buyer-inbox

Local API:

• GET /health
• GET /api/context
• GET /api/opportunities
• GET /api/opportunities/next
• POST /api/opportunities/:id/ack

2. Deal Publisher

Publisher-side product monitor that watches one product page and emits normalized commercial events into PushMe.

Commands:

npm run setup:deal-publisher
npm run start:deal-publisher -- --once --dry-run
npm run start:deal-publisher

Best event types:

• price.dropped
• discount.started
• discount.changed
• stock.available
• launch.available

3. Webhook Forwarder

Subscriber-side bridge that turns PushMe events into direct webhook calls for another agent or workflow engine.

Commands:

npm run setup:webhook-forwarder
npm run start:webhook-forwarder -- --once --dry-run
npm run start:webhook-forwarder

The forwarder signs outgoing payloads with x-pushme-signature when WEBHOOK_FORWARDER_SECRET is set.

4. CrabbitMQ Forwarder

Subscriber-side bridge that turns PushMe events into queue jobs for a CrabbitMQ ingress endpoint.

Commands:

npm run setup:crabbitmq-forwarder
npm run start:crabbitmq-forwarder -- --once --dry-run
npm run start:crabbitmq-forwarder

Outgoing POSTs include:

• x-pushme-event-id
• x-pushme-event-type
• x-pushme-topic
• x-pushme-delivery-kind: crabbitmq
• x-pushme-signature when CRABBITMQ_FORWARDER_SECRET is set

The JSON body wraps the canonical PushMe event in a queue envelope so agents can consume outside-world events through the same queue interface they already use for internal jobs.

5. PushMe Bot Hub MCP Server

MCP wrapper for PushMe Bot Hub so agent frameworks can:

• register a bot org
• publish structured events
• subscribe to event streams
• preview netnode coverage
• inspect balances and netnode status

Commands:

cd mcp/pushme-bot-hub-mcp
npm install
npm start

Docs:

• mcp/pushme-bot-hub-mcp/README.md
• Remote endpoint: https://pushme.site/mcp
• OpenAPI: https://pushme.site/openapi/pushme-bot-hub.yaml

Quickstart

git clone https://github.com/yodakohl/pushme-agent-tools.git
cd pushme-agent-tools
npm install

Then choose one tool:

npm run setup:buyer-inbox
npm run setup:deal-publisher
npm run setup:webhook-forwarder
npm run setup:crabbitmq-forwarder

Why this repo exists

A lot of agents do not need more generic wrappers. They need small runnable components with narrow, useful behavior:

• publish one good event
• consume one useful stream
• forward matched events into action
• bridge external events into queues agents already trust

PushMe provides the event network. This repo provides the agent-side building blocks.