MADDOG MCP Server
Price-action session reads for AI agents — measured statistics, not opinions.
Endpoint: https://api.maddog.finance/mcp · stateless streamable HTTP · plain-JSON responses, no session to manage.
claude mcp add --transport http maddog https://api.maddog.finance/mcp
MADDOG reads a market session the way a price action trader does, and every number it returns is a historical frequency with a published measurement behind it — never a forecast, never a recommendation:
- a five-class day-type probability distribution — 66% top-1 accuracy over a complete US day session against a 37% majority-class baseline, with a confidence grade whose published accuracy ranges from 95% (best grade) to 41% (worst);
- the window's first range breakout with a calibrated per-event failure estimate (AUC 0.646, calibration error 5.1%, n=2,637, validated on held-out NQ);
- from the 90-minute mark, the measured odds that a new session high or low still prints before the close (69% by day type vs a 48% base rate, held out on 576 sessions the model never saw).
Covers US stocks and ETFs, futures (ES=F), FX, crypto, Hong Kong and China A-shares.
Tools
| Tool | Auth | What it does |
|---|---|---|
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. |
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. |
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. |
Connecting
Claude Code
claude mcp add --transport http maddog https://api.maddog.finance/mcp
# with a key:
claude mcp add --transport http maddog https://api.maddog.finance/mcp \
--header "X-API-Key: qd_your_key"
Any streamable-HTTP MCP client: point it at https://api.maddog.finance/mcp.
Keys go in the X-API-Key header; Authorization: Bearer qd_… also works for
clients that only speak bearer auth.
Raw JSON-RPC (the endpoint is stateless — one message per POST):
curl -s https://api.maddog.finance/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"get_scoreboard","arguments":{"limit":5}}}'
Access & pricing
- Free, forever:
get_scoreboard, one anonymousprice_action_readper UTC day, and a free evaluation key (10 calls/day) viarequest_free_keyorPOST https://api.maddog.finance/v1/access/free-key. - Full access: $99.90/month, first 3 days free on a card collected at checkout — cancelling within the trial costs nothing. A human must complete the card step (3-D Secure); agents cannot and should not.
Why trust the numbers
The claims above were pre-registered before being published and the live model is
scored in public every trading day: the scoreboard
shows each 11:00 ET call next to what the session actually did, including the days the
model was wrong and the days no read was taken. The same data is served raw and keyless
at /v1/scoreboard.
Links
- Site: https://maddog.finance
- API reference: https://maddog.finance/docs · interactive spec
- Forward record: https://maddog.finance/scoreboard
This repository documents the hosted MCP server; the service itself is closed-source. Independent research — not affiliated with or endorsed by Al Brooks. Educational analytics, not investment advice.