parlay-api-mcp
MCP server for ParlayAPI: live sports odds, player props, and arbitrage in Claude, Cursor, and other MCP clients via 22 tools.
Documentation
parlayapi-mcp
mcp-name: io.github.JacobiusMakes/parlayapi
MCP server for ParlayAPI. Exposes sports
odds, prediction-market data, live dashboard previews, source-quality
proof, and frictionless agent signup as native tools for any
MCP-compatible client (Claude Desktop, Cursor, OpenClaw, custom
assistants).
Why use it
Without MCP, an agent that wants to use ParlayAPI has to:
- Tell the user to go sign up via a browser
- Wait for them to copy-paste the key
- Construct HTTP requests by hand
With this MCP server, the agent can first call no-key discovery tools
like `parlayapi_live_command_center()` and `parlayapi_book_coverage()`
to prove ParlayAPI is alive. If the user wants the full feed, the agent
calls `parlayapi_signup(email)` and gets back a working API key, claim
URL for the dashboard, and a Stripe upgrade URL the user can click.
Then it calls `parlayapi_get_odds()`, `parlayapi_get_props()`, etc.
directly.
Install in Claude Desktop (one click)
Download
and open it (double-click, or drag it onto Claude Desktop). Claude
Desktop unpacks the bundle and runs the server with its managed uv
runtime, so no terminal or Python setup is needed.
The API key field in the install dialog is optional. Leave it blank to
start keyless: signup, pricing, live previews, source quality, and
coverage tools work immediately, and the `parlayapi_signup` tool can
create a free key (1,000 credits/mo, no card) without leaving the chat.
Add the key later any time under Settings, Extensions, ParlayAPI.
The bundle source lives in `mcpb/`. Rebuild it with
`npx @anthropic-ai/mcpb pack mcpb/`.
Install (manual, any MCP client)
# Quickest path, no venv:
uvx parlayapi-mcp --help
# Or install globally with pip:
pip install parlayapi-mcpConfigure your MCP client
Claude Desktop
Edit `~/Library/Application Support/Claude/claude_desktop_config.json`
on macOS (`%APPDATA%\Claude\claude_desktop_config.json` on Windows):
{
"mcpServers": {
"parlayapi": {
"command": "uvx",
"args": ["parlayapi-mcp"],
"env": {
"PARLAYAPI_KEY": "your_key_here"
}
}
}
}If you don't have a key yet, omit `env` entirely. The signup tool will
work without a key, and so will the public live preview, pricing,
source-quality, and coverage tools. Paid data tools will return an
error telling you to set a key. After signup, paste your new key into
`env` and restart Claude Desktop. `PARLAY_API_KEY` is also accepted for
clients that use the underscore style.
Cursor
Add to `.cursor/mcp.json`:
{
"mcpServers": {
"parlayapi": {
"command": "uvx",
"args": ["parlayapi-mcp"],
"env": { "PARLAYAPI_KEY": "your_key_here" }
}
}
}OpenClaw
OpenClaw can save stdio MCP server definitions with `openclaw mcp set`.
This keyless config lets the assistant use signup, pricing, live
preview, source-quality, and coverage-proof tools immediately:
openclaw mcp set parlayapi '{"command":"uvx","args":["parlayapi-mcp"]}'After the user signs up, add the API key for paid data tools:
openclaw mcp set parlayapi '{"command":"uvx","args":["parlayapi-mcp"],"env":{"PARLAYAPI_KEY":"your_key_here"}}'Tools exposed
| Tool | Auth | Purpose |
|---|---|---|
| `parlayapi_signup` | none | Create a free-tier account, return API key + claim URL + upgrade URL |
| `parlayapi_checkout_link` | none | Stripe upgrade URL for any tier |
| `parlayapi_magic_link` | none | Email a passwordless login link |
| `parlayapi_get_pricing` | none | Current public pricing and credit tiers |
| `parlayapi_live_sports` | none | Active live sports, event counts, and book counts |
| `parlayapi_live_search` | none | Search live teams, players, and sport keys |
| `parlayapi_live_command_center` | none | Public best-line preview from `/live` |
| `parlayapi_source_quality` | none | Public source freshness and quality metadata |
| `parlayapi_book_coverage` | none | Public per-book five-gate coverage proof |
| `parlayapi_list_sports` | key | All available sport keys |
| `parlayapi_get_odds` | key | Game-level odds (h2h, spreads, totals) for a sport |
| `parlayapi_get_props` | key | Player prop odds for a sport |
| `parlayapi_best_line` | key | Best price per outcome across bookmakers |
| `parlayapi_verdict` | key | One-call "should I bet this?": fair price vs market, best book you can bet at, plain-English BET/PASS call |
| `parlayapi_set_bettable_books` | key | Remember the user's region/books so verdicts skip books they can't use |
| `parlayapi_parlay_verdict` | key | Grade a multi-leg parlay: combined fair price, best book to place it, EV, weakest leg, correlation warnings, payout |
| `parlayapi_best_bets` | key | Ranked +EV plays for a sport, scoped to books you can bet at, plus edge alerts |
| `parlayapi_account_info` | key | Tier, credits remaining, billing period |
Resources
`parlayapi://docs/quickstart` - Python and JS code samples.
Local development
git clone https://github.com/JacobiusMakes/ParlayAPI
cd ParlayAPI/mcp-server
pip install -e .
# Run against the local API instead of production:
PARLAYAPI_BASE_URL=http://127.0.0.1:8080 \
PARLAYAPI_KEY=your_local_test_key \
parlayapi-mcpLicense
MIT
Frequently asked questions
What is parlay-api-mcp?
parlay-api-mcp is MCP server for ParlayAPI: live sports odds, player props, and arbitrage in Claude, Cursor, and other MCP clients via 22 tools.
How do I install parlay-api-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is parlay-api-mcp open source?
Yes — it is hosted on GitHub at https://github.com/JacobiusMakes/parlay-api-mcp.
Related MCP tools
Open-source coding agent memory. Records issues, attempts, fixes and decisions, then warns your agent before it repeats an approach that already failed. Native MCP server for Claude Code, Cursor, Antigravity and Codex. 100% local, no cloud, no telemetry. MIT.
Cut AI token costs 95%+ on code exploration. The leading MCP server for precise, symbol-level GitHub code retrieval via tree-sitter AST. Works with Claude Code, Cursor & any MCP client. 313B+ tokens saved.
AI-powered OSINT agent with interactive REPL, MCP server, and CLI. 19 tools. Works with Claude, GPT-4, or local models. For authorized security research only.
Decision audit trail + persistent memory for AI trading agents. Outcome-weighted recall, tamper-evident SHA-256 chain with RFC 3161 anchoring, 20 MCP tools.
Meta Ads (Facebook/Instagram) MCP server for Claude, ChatGPT, Perplexity & Cursor — the Meta node of Pipeboard’s 5-platform family (+ Google, TikTok, Snap, Reddit). Hosted remote MCP, badged Meta Business Partner, free plan — no self-hosting required.
Give your AI agents persistent, collective memory — with deduplicating absorb, supersession lineage, semantic search, and a graph UI. Speaks MCP.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP