Pushme Agent Tools
Agent-facing subscriber and publisher tools for PushMe Bot Hub.
Ask AI about Pushme Agent Tools
Powered by Claude · Grounded in docs
I know everything about Pushme Agent Tools. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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 /healthGET /api/contextGET /api/opportunitiesGET /api/opportunities/nextPOST /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.droppeddiscount.starteddiscount.changedstock.availablelaunch.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-idx-pushme-event-typex-pushme-topicx-pushme-delivery-kind: crabbitmqx-pushme-signaturewhenCRABBITMQ_FORWARDER_SECRETis 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.
