Metadata-Version: 2.4
Name: parlayapi-mcp
Version: 0.1.0
Summary: MCP server for ParlayAPI: sports odds + prediction-market data + frictionless agent signup
Project-URL: Homepage, https://parlay-api.com
Project-URL: Documentation, https://parlay-api.com/docs
Project-URL: Repository, https://github.com/JacobiusMakes/ParlayAPI
Project-URL: Issues, https://github.com/JacobiusMakes/ParlayAPI/issues
Author-email: Jacob <jacob@parlay-api.com>
License: MIT
Keywords: agents,ai,betting,claude,mcp,odds,sports
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.10.0
Description-Content-Type: text/markdown

# parlayapi-mcp

MCP server for [ParlayAPI](https://parlay-api.com). 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

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

```json
{
  "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`:

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

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