# Papertrade Alerts

> Unofficial, self-hostable alerting service for Papertrade (papertrade.xyz) wallets on Cloudflare Workers + D1, with an MCP server for AI agents. Not affiliated with Papertrade. High leverage can lose your whole margin. Alerts are best effort. Nothing here signs, sends funds or places orders.

- MCP endpoint (Streamable HTTP, stateless): https://papertrade-alerts.ninabrekkerese.workers.dev/mcp
- MCP server card: https://papertrade-alerts.ninabrekkerese.workers.dev/.well-known/mcp/server-card.json
- Agent card: https://papertrade-alerts.ninabrekkerese.workers.dev/.well-known/agent-card.json
- OpenAPI 3.1: https://papertrade-alerts.ninabrekkerese.workers.dev/openapi.json
- Full documentation in one file: https://papertrade-alerts.ninabrekkerese.workers.dev/llms-full.txt
- Source: https://github.com/nirholas/papertrade-alerts
- Auth: POST /api/accounts (or the MCP create_subscription tool) returns a one-time bearer token (ptal_...). Send Authorization: Bearer <token>.

## Docs

- [Overview](https://papertrade-alerts.ninabrekkerese.workers.dev/docs/index.md): What Papertrade Alerts does, who it is for, and how the pieces fit together.
- [Quickstart](https://papertrade-alerts.ninabrekkerese.workers.dev/docs/quickstart.md): Create a subscription, connect a destination and watch a wallet in five minutes.
- [Concepts](https://papertrade-alerts.ninabrekkerese.workers.dev/docs/concepts.md): Thresholds, seeding, edge-triggering, delivery retries and the Papertrade rules that shape alerts.
- [API reference](https://papertrade-alerts.ninabrekkerese.workers.dev/docs/api.md): Every HTTP endpoint, with authentication and examples. The machine-readable form is /openapi.json.
- [MCP server](https://papertrade-alerts.ninabrekkerese.workers.dev/docs/mcp.md): The /mcp endpoint, its ten tools with schemas, authentication, limits and examples.
- [Connect your AI](https://papertrade-alerts.ninabrekkerese.workers.dev/docs/connect.md): Copy-paste setup for Claude, Codex, ChatGPT, Gemini, Cursor, VS Code, Windsurf, Zed, Cline, Goose, Continue and any OpenAI-compatible agent.
- [Agent discovery](https://papertrade-alerts.ninabrekkerese.workers.dev/docs/discovery.md): The well-known files, llms.txt, OpenAPI and headers that let agents find and understand this service.
- [Self-hosting](https://papertrade-alerts.ninabrekkerese.workers.dev/docs/self-hosting.md): Deploy your own Papertrade Alerts to Cloudflare Workers with D1.
- [Security and limits](https://papertrade-alerts.ninabrekkerese.workers.dev/docs/security.md): Threat model, SSRF guard, token handling, rate limits and what the service never does.
- [FAQ](https://papertrade-alerts.ninabrekkerese.workers.dev/docs/faq.md): Common questions about alerts, tokens, delivery and the MCP server.
- [Changelog](https://papertrade-alerts.ninabrekkerese.workers.dev/docs/changelog.md): Release notes.