parlayapi-mcp 0.1.0

MCP server for ParlayAPI: sports odds + prediction-market data + frictionless agent signup

parlayapi-mcp

MCP server for ParlayAPI. Exposes sports odds, prediction-market data, and frictionless agent signup as native tools for any MCP-compatible client (Claude Desktop, Cursor, 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 just 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

# Quickest path, no venv:
uvx parlayapi-mcp --help

# Or install globally with pip:
pip install parlayapi-mcp

Configure 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; everything else will return an error telling you to set one. After signup, paste your new key into env and restart Claude Desktop.

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "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_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_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-mcp

License

MIT