{
  "markdown": "# MADDOG MCP Server\n\n[![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/maddogfinance/maddog-mcp)\n\nPrice-action session reads for AI agents — **measured statistics, not opinions**.\n\n**Endpoint:** `https://api.maddog.finance/mcp` · stateless streamable HTTP · plain-JSON responses, no session to manage.\n\n```bash\nclaude mcp add --transport http maddog https://api.maddog.finance/mcp\n```\n\nMADDOG reads a market session the way a price action trader does, and every number it\nreturns is a **historical frequency with a published measurement behind it** — never a\nforecast, never a recommendation:\n\n- a five-class **day-type probability distribution** — 66% top-1 accuracy over a complete\n  US day session against a 37% majority-class baseline, with a confidence grade whose\n  published accuracy ranges from 95% (best grade) to 41% (worst);\n- the window's first **range breakout** with a calibrated per-event failure estimate\n  (AUC 0.646, calibration error 5.1%, n=2,637, validated on held-out NQ);\n- from the 90-minute mark, the **measured odds that a new session high or low still\n  prints** before the close (69% by day type vs a 48% base rate, held out on 576\n  sessions the model never saw).\n\nCovers US stocks and ETFs, futures (`ES=F`), FX, crypto, Hong Kong and China A-shares.\n\n## Tools\n\n| Tool | Auth | What it does |\n|---|---|---|\n| `get_scoreboard` | none | The service's **public forward record**: every 11:00 ET read for ES=F/NQ=F/QQQ, snapshotted verbatim and scored after each close. Ties score against the model; days with no live read stay visible as gaps; no row is ever edited. Check this before trusting anything else. |\n| `price_action_read` | optional | The full session read for one symbol. Anonymous callers get one first-look response per UTC day; quota errors carry machine-readable next steps. |\n| `request_free_key` | none | Emails a free evaluation key (10 successful calls per UTC day, no card, no account) so an agent can get its own allowance without leaving the conversation. |\n\n## Connecting\n\n**Claude Code**\n\n```bash\nclaude mcp add --transport http maddog https://api.maddog.finance/mcp\n# with a key:\nclaude mcp add --transport http maddog https://api.maddog.finance/mcp \\\n  --header \"X-API-Key: qd_your_key\"\n```\n\n**Any streamable-HTTP MCP client:** point it at `https://api.maddog.finance/mcp`.\nKeys go in the `X-API-Key` header; `Authorization: Bearer qd_…` also works for\nclients that only speak bearer auth.\n\n**Raw JSON-RPC** (the endpoint is stateless — one message per POST):\n\n```bash\ncurl -s https://api.maddog.finance/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\n       \"params\":{\"name\":\"get_scoreboard\",\"arguments\":{\"limit\":5}}}'\n```\n\n## Access & pricing\n\n- **Free, forever:** `get_scoreboard`, one anonymous `price_action_read` per UTC day,\n  and a free evaluation key (10 calls/day) via `request_free_key` or\n  `POST https://api.maddog.finance/v1/access/free-key`.\n- **Full access:** $99.90/month, first 3 days free on a card collected at checkout —\n  cancelling within the trial costs nothing. A human must complete the card step\n  (3-D Secure); agents cannot and should not.\n\n## Why trust the numbers\n\nThe claims above were **pre-registered before being published** and the live model is\nscored in public every trading day: the [scoreboard](https://maddog.finance/scoreboard)\nshows each 11:00 ET call next to what the session actually did, including the days the\nmodel was wrong and the days no read was taken. The same data is served raw and keyless\nat [`/v1/scoreboard`](https://api.maddog.finance/v1/scoreboard).\n\n## Links\n\n- Site: https://maddog.finance\n- API reference: https://maddog.finance/docs · [interactive spec](https://api.maddog.finance/docs)\n- Forward record: https://maddog.finance/scoreboard\n\n---\n\nThis repository documents the hosted MCP server; the service itself is closed-source.\nIndependent research — not affiliated with or endorsed by Al Brooks.\n**Educational analytics, not investment advice.**\n",
  "bytes": 4063,
  "sha": "c109272db596da9d243770862d4a5afb69dd13c9ecf9f2e1cd44973356e76fa7",
  "repo_slug": "maddogfinance/maddog-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_finance_maddog_mcp_44779894/readme"
}