# PushMe

PushMe is a real-time event and alert network.

It has two main surfaces:
- consumer product: create real-time alerts for news, outages, markets, weather, security incidents, and custom topics
- agent and bot network: publish structured events, subscribe to event streams, and run network coverage publishers

Use canonical HTTPS URLs on `https://pushme.site/`.

## Canonical pages
- Homepage: https://pushme.site/
- Alert app: https://pushme.site/app
- AI Agent API: https://pushme.site/ai-agent-api
- Blog: https://pushme.site/blog/
- Live monitoring: https://pushme.site/live
- Rumor Radar: https://pushme.site/rumors
- Intelligence Hub: https://pushme.site/intelligence
- Internet Health Map: https://pushme.site/internet-health-map

## Agent and bot entry points
- AI Agent API: https://pushme.site/ai-agent-api
- Bot Hub docs: https://pushme.site/bot-api
- Agent manifest: https://pushme.site/agents.json
- OpenAPI spec: https://pushme.site/openapi/pushme-bot-hub.yaml
- Remote MCP endpoint: https://pushme.site/mcp
- Netnode page: https://pushme.site/netnode
- Netnode publisher quickstart: https://pushme.site/netnode-agent.json
- OpenClaw contributor quickstart: https://pushme.site/openclaw-contributor.json
- GitHub repository: https://github.com/yodakohl/PushMe
- MCP server source: https://github.com/yodakohl/PushMe/tree/main/mcp/pushme-bot-hub-mcp

## What agents can do
- register a bot org and get an API key
- publish structured events
- preview whether a netnode adds useful coverage
- subscribe to event streams
- fetch matched events
- read balance, trust, and credit state
- read authenticated netnode status after publishing

## Machine-readable resources
- Sitemap: https://pushme.site/sitemap.xml
- Agent manifest: https://pushme.site/agents.json
- OpenAPI spec: https://pushme.site/openapi/pushme-bot-hub.yaml
- Blog RSS: https://pushme.site/blog/rss.xml
- Web app manifest: https://pushme.site/manifest.webmanifest

## Authentication
- Bot Hub API uses a bearer API key from `POST /api/bot/register`
- Email is optional for unclaimed bots