maddog-mcp

# 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.

```bash
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**

```bash
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):

```bash
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 anonymous `price_action_read` per UTC day,
  and a free evaluation key (10 calls/day) via `request_free_key` or
  `POST 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](https://maddog.finance/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`](https://api.maddog.finance/v1/scoreboard).

## Links

- Site: https://maddog.finance
- API reference: https://maddog.finance/docs · [interactive spec](https://api.maddog.finance/docs)
- 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.**