F/01Language
Ask, don't query
“Live Premier League totals” becomes get_events then get_event_odds. The model picks the tool; you read the answer.
Module 01 — Interface
Why an MCP server instead of pasting JSON
A soccer board is megabytes of JSON. Paste it into a chat and the model spends its context reading alternate lines it will never use. The MCP server answers the question that was asked — a filtered list of events, the five lines around the main line, the ten biggest drops — and tells the model how to narrow further when a result was cut. Every call still goes through your key, your plan and your rate limit; nothing is proxied under a shared account.
| Pasting REST responses | pinnodds MCP server | |
|---|---|---|
| Context used | Whole board, every line | Capped rows, main lines, trailer says what was hidden |
| Quota | One call per paste, no reuse | One live request per tool call, identical simultaneous calls merged, 429 answered locally |
| Freshness | Whenever you last pasted | Live prices at the moment of the question |
| Setup | Copy, paste, repeat | One config entry per client |
Module 02 — Handshake
Connect in one command
The endpoint is a stateless Streamable HTTP MCP server at https://mcp.pinnodds.com/mcp.
Authenticate with your pinnodds API key as a Bearer token. Every client that supports remote MCP servers
has a field for it; the docs show the exact snippet for Claude Code, Claude Desktop,
Cursor, VS Code, Codex CLI and the Claude API.
# one line — then /mcp inside Claude Code shows pinnodds connected
claude mcp add --transport http pinnodds https://mcp.pinnodds.com/mcp \
--header "Authorization: Bearer $PINNODDS_KEY"{
"mcpServers": {
"pinnodds": {
"url": "https://mcp.pinnodds.com/mcp",
"headers": { "Authorization": "Bearer YOUR_PINNODDS_KEY" }
}
}
}TOOLget_eventslive or prematch, filter by team/league
TOOLget_event_oddsmoneyline · spreads · totals
TOOLget_prematch_linesevery alternate line
TOOLget_odds_dropssharp moves, last N minutes
TOOLget_feed_status · get_account_usagehealth · quota left
TOOLlist_sports · search_pinnodds_docsno quota
Module 03 — Payload
What you get
F/02Identity
Your key, your plan
The assistant never sees or asks for the key; it rides on the connection. Calls appear in your panel like any REST request.
F/03Context
Trimmed responses
Rows are capped, alternate lines centred on the main line, and a trailer tells the model how to narrow instead of dumping more.
F/04Quota
Always live
Every tool call is a live request — no cached odds. Identical calls fired at the same instant are merged, and after a 429 the server stops calling upstream until the window resets.
F/05Signal
Odds drops built in
The same steam detection behind /api/drops, one tool call away: sport, market, period, size and age filters.
F/06Docs
Self-documenting
search_pinnodds_docs answers questions about the API itself, so the assistant can explain a parameter without leaving the chat.
Module 04 — Query log
Frequently asked questions
Which clients work?
claude.ai (OAuth), Claude Code, Claude Desktop, Cursor, VS Code, Codex CLI and the Claude API's MCP connector — any client that can call a remote Streamable HTTP server. Exact snippets are in the docs.
Does the claude.ai website connector work?
Yes. Add
https://mcp.pinnodds.com/mcp as a custom connector; claude.ai sends you to the pinnodds authorization page where you enter your API key once. It then holds a short-lived OAuth token that refreshes itself — the key never leaves pinnodds.Does it cost extra?
No. It is included with every key, trial included. Each tool call is one live request against your plan, so a Trial key's 100 requests a day will run out during a long session —
get_account_usage shows what is left.Is my API key exposed to the model?
No. The key travels in the HTTP header of the connection, not in the conversation. Tool schemas carry no identity arguments, and the account tool returns your plan and usage only — never your email or billing details.
Can it stream odds?
MCP is request/response, so the tools return the current state when asked. For push delivery use the SSE drop streams or the WebSocket feed directly.
Give your assistant Pinnacle odds
Free 3-day full demo, no card required. One config entry and the tools show up in your client.