{
  "markdown": "# parlayapi-mcp\n\nmcp-name: io.github.JacobiusMakes/parlayapi\n\nMCP server for [ParlayAPI](https://parlay-api.com). Exposes sports\nodds, prediction-market data, live dashboard previews, source-quality\nproof, and frictionless agent signup as native tools for any\nMCP-compatible client (Claude Desktop, Cursor, OpenClaw, custom\nassistants).\n\n## Why use it\n\nWithout MCP, an agent that wants to use ParlayAPI has to:\n- Tell the user to go sign up via a browser\n- Wait for them to copy-paste the key\n- Construct HTTP requests by hand\n\nWith this MCP server, the agent can first call no-key discovery tools\nlike `parlayapi_live_command_center()` and `parlayapi_book_coverage()`\nto prove ParlayAPI is alive. If the user wants the full feed, the agent\ncalls `parlayapi_signup(email)` and gets back a working API key, claim\nURL for the dashboard, and a Stripe upgrade URL the user can click.\nThen it calls `parlayapi_get_odds()`, `parlayapi_get_props()`, etc.\ndirectly.\n\n## Install in Claude Desktop\n\nOpen the [latest desktop release](https://github.com/JacobiusMakes/parlay-api-mcp/releases/latest)\nand download its asset ending in `-directory.mcpb`. The release notes identify\nthe bundle version and validation performed. Open the downloaded file\n(double-click, or drag it onto Claude Desktop). Claude\nDesktop unpacks the bundle and runs the server with its managed uv\nruntime, so no terminal or Python setup is needed.\n\nPython package 0.3.7 is a documentation update. The separately released\n0.3.6 desktop bundle has the same server implementation and corrected tool\ndescriptions. Check the release page above for newer desktop bundles.\n\nThe API key field in the install dialog is optional. Leave it blank to\nstart keyless: signup, pricing, live previews, source quality, and\ncoverage tools work immediately, and the `parlayapi_signup` tool can\ncreate a free key (1,000 credits/mo, no card) without leaving the chat.\nAdd the key later any time under Settings, Extensions, ParlayAPI.\n\nThe bundle source lives in [`mcpb/`](mcpb/). Rebuild it with\n`npx @anthropic-ai/mcpb pack mcpb/`.\n\n## Install (manual, any MCP client)\n\n```bash\n# Start the stdio server (normally launched by your MCP client):\nuvx --from parlayapi-mcp==0.3.7 parlayapi-mcp\n\n# Or install globally with pip:\npip install parlayapi-mcp==0.3.7\n```\n\n## Configure your MCP client\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`\non macOS (`%APPDATA%\\Claude\\claude_desktop_config.json` on Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"parlayapi\": {\n      \"command\": \"uvx\",\n      \"args\": [\"parlayapi-mcp\"],\n      \"env\": {\n        \"PARLAYAPI_KEY\": \"your_key_here\"\n      }\n    }\n  }\n}\n```\n\nIf you don't have a key yet, omit `env` entirely. The signup tool will\nwork without a key, and so will the public live preview, pricing,\nsource-quality, and coverage tools. Paid data tools will return an\nerror telling you to set a key. After signup, paste your new key into\n`env` and restart Claude Desktop. `PARLAY_API_KEY` is also accepted for\nclients that use the underscore style.\n\n### Cursor\n\nFor the packaged integration, see [Cursor plugin setup](docs/cursor-publishing.md).\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"parlayapi\": {\n      \"command\": \"uvx\",\n      \"args\": [\"parlayapi-mcp\"],\n      \"env\": { \"PARLAYAPI_KEY\": \"your_key_here\" }\n    }\n  }\n}\n```\n\n### OpenClaw\n\nOpenClaw can save stdio MCP server definitions with `openclaw mcp set`.\nThis keyless config lets the assistant use signup, pricing, live\npreview, source-quality, and coverage-proof tools immediately:\n\n```bash\nopenclaw mcp set parlayapi '{\"command\":\"uvx\",\"args\":[\"parlayapi-mcp\"]}'\n```\n\nAfter the user signs up, add the API key for paid data tools:\n\n```bash\nopenclaw mcp set parlayapi '{\"command\":\"uvx\",\"args\":[\"parlayapi-mcp\"],\"env\":{\"PARLAYAPI_KEY\":\"your_key_here\"}}'\n```\n\n## Run locally with Docker\n\nBuild the stdio container from this repository:\n\n```bash\ndocker build -t parlayapi-mcp:local .\ndocker run --rm -i --read-only --cap-drop=ALL --security-opt=no-new-privileges parlayapi-mcp:local\n```\n\nThe process waits for MCP messages on stdin. It does not open a web server or\nmake an API call just by starting. Connect it through an MCP client; do not use\n`-t`, which would allocate a terminal instead of the MCP stdio transport.\n\nFor account tools, configure your own `PARLAYAPI_KEY` in your MCP client's\nsecret configuration and pass that environment variable into the container:\n\n```bash\ndocker run --rm -i --read-only --cap-drop=ALL --security-opt=no-new-privileges -e PARLAYAPI_KEY parlayapi-mcp:local\n```\n\nNo key is baked into the image. Each user should configure their own key and\nkeep account responses within their own client. This container is not a shared\ncommunity feed. The MIT software license grants no data distribution rights;\n[applicable Terms](https://parlay-api.com/terms) and any written agreement govern\nAPI data use. These container defaults do not amend existing agreements.\n\nPublic discovery tools need no key. Account tools use your allowance; check\n[current plans and limits](https://parlay-api.com/pricing). The existing tool set\nalso includes account creation, checkout-link creation, login-link email and\nsaved-book preferences. Approve those actions explicitly in your MCP client.\nListing tools itself creates no account, sends no email and starts no checkout.\n\nFor private security reports, email support@parlay-api.com. Do not put API keys\nor account responses in public issues.\n\n## Tools exposed\n\n| Tool | Auth | Purpose |\n|---|---|---|\n| `parlayapi_signup` | none | Create a free-tier account, return API key + claim URL + upgrade URL |\n| `parlayapi_checkout_link` | none | Stripe upgrade URL for any tier |\n| `parlayapi_magic_link` | none | Email a passwordless login link |\n| `parlayapi_get_pricing` | none | Current public pricing and credit tiers |\n| `parlayapi_live_sports` | none | Active live sports, event counts, and book counts |\n| `parlayapi_live_search` | none | Search live teams, players, and sport keys |\n| `parlayapi_live_command_center` | none | Public best-line preview from `/live` |\n| `parlayapi_source_quality` | none | Public source freshness and quality metadata |\n| `parlayapi_book_coverage` | none | Public per-book five-gate coverage proof |\n| `parlayapi_list_sports` | key | All available sport keys |\n| `parlayapi_get_odds` | key | Game-level odds (h2h, spreads, totals) for a sport |\n| `parlayapi_get_props` | key | Player prop odds for a sport |\n| `parlayapi_best_line` | key | Best price per outcome across bookmakers |\n| `parlayapi_verdict` | key | One-call \"should I bet this?\": fair price vs market, best book you can bet at, plain-English BET/PASS call |\n| `parlayapi_set_bettable_books` | key | Remember the user's region/books so verdicts skip books they can't use |\n| `parlayapi_parlay_verdict` | key | Grade a multi-leg parlay: combined fair price, best book to place it, EV, weakest leg, correlation warnings, payout |\n| `parlayapi_best_bets` | key | Ranked +EV plays for a sport, scoped to books you can bet at, plus edge alerts |\n| `parlayapi_account_info` | key | Tier, credits remaining, billing period |\n| `parlayapi_find_arbitrage` | key | Cross-book arbitrage candidates, 3-way (home/draw/away) markets included |\n| `parlayapi_find_ev` | key | Positive-EV bets vs a sharp book's no-vig fair line |\n| `parlayapi_consensus` | key | Consensus (average) odds across all bookmakers per market |\n| `parlayapi_find_middles` | key | Cross-book middle opportunities |\n\n## Resources\n\n`parlayapi://docs/quickstart` - Python and JS code samples.\n\n## Local development\n\n```bash\ngit clone https://github.com/JacobiusMakes/parlay-api-mcp\ncd parlay-api-mcp\npip install -e .\n\n# Run against the local API instead of production:\nPARLAYAPI_BASE_URL=http://127.0.0.1:8080 \\\nPARLAYAPI_KEY=your_local_test_key \\\nparlayapi-mcp\n```\n\n## Privacy Policy\n\nThis extension connects to ParlayAPI. See the [ParlayAPI Privacy Policy](https://parlay-api.com/privacy).\n\n## License\n\nMIT\n\n---\n\nPart of the [ParlayAPI](https://parlay-api.com) ecosystem: a real-time sports odds API with a free tier of 1,000 credits per month, no card required. Explore all the tools at [github.com/JacobiusMakes](https://github.com/JacobiusMakes).\n",
  "bytes": 8252,
  "sha": "9f2c7feb9b8b89c90ba38964515aba6f888eb7cad303853e5a14a1018bbd5bb6",
  "repo_slug": "jacobiusmakes/parlay-api-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jacobiusmakes_parlayapi_05108fa5/readme"
}