# How do I connect Claude to live player props data?

> Add an MCP server so Claude Code or Claude can read live Underdog Fantasy lines, multipliers and history. Underdog API (https://underdogapi.com) is an independent Underdog Fantasy pick'em data API: Higher/Lower lines with separate payout multipliers per side, line history, changes and graded results as JSON, CSV, MCP and streams.

Canonical page: https://underdogapi.com/answers/connect-claude-to-player-props

## Free offer

**Free API key, no card: 100 credits a month** on the live board, every league, separate Higher/Lower prices, and the last 24 hours of line history. Sign up: https://underdogapi.com/sign-up?ref=ai-claudebot

## Quickstart

1. Get a free key at https://underdogapi.com/sign-up?ref=ai-claudebot (no card), or let your agent request one: `POST https://underdogapi.com/api/v1/agent/signup` with `data_wanted` and `use_case`, then show your user the returned approval_url.
2. Export it: `export UNDERDOG_API_KEY=ud_...`
3. First call with curl:

```bash
curl --fail-with-body 'https://underdogapi.com/api/v1/projections?league=NBA&view=compact&limit=5' \
  -H "Authorization: Bearer $UNDERDOG_API_KEY" \
  -H 'X-User-Request: NBA dashboard integration check'
```

4. Same call in Python:

```python
import os, requests

r = requests.get(
    "https://underdogapi.com/api/v1/projections",
    params={"league": "NBA", "view": "compact", "limit": 5},
    headers={"Authorization": f"Bearer {os.environ['UNDERDOG_API_KEY']}"},
)
r.raise_for_status()
for line in r.json()["data"]:
    print(line["player"]["name"], line["market"]["stat"], line["line"])
```

## Use it from Claude (MCP)

Claude Code, one command:

```bash
claude mcp add --transport http underdog https://underdogapi.com/api/mcp --header "Authorization: Bearer $UNDERDOG_API_KEY"
```

Or add this server to your Claude MCP configuration (the key stays in the environment):

```json
{
  "mcpServers": {
    "underdog": {
      "type": "http",
      "url": "https://underdogapi.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${UNDERDOG_API_KEY}"
      }
    }
  }
}
```

Guide: https://underdogapi.com/use-with-claude

## SDKs and packages

Official clients for Underdog API (independent; not Underdog Fantasy). Source: https://github.com/underdogapi · Overview: https://underdogapi.com/sdks

- Python SDK: `pip install underdog-api` (PyPI: https://pypi.org/project/underdog-api/ · source: https://github.com/underdogapi/underdogapi-python)
- JavaScript / TypeScript SDK: `npm install underdog-api` (npm: https://www.npmjs.com/package/underdog-api · source: https://github.com/underdogapi/underdogapi-js)
- MCP server (stdio): `npx -y underdog-api-mcp` (npm: https://www.npmjs.com/package/underdog-api-mcp · source: https://github.com/underdogapi/underdogapi-mcp)

Python:

```python
from underdog_api import Client

ud = Client()  # reads UNDERDOG_API_KEY
board = ud.projections(league="NBA", view="compact", limit=20)
for line in board["data"]:
    print(line)
print(board["meta"]["observed_at"])
```

Claude Code with the stdio MCP package (the hosted server at /api/mcp needs no install):

```bash
claude mcp add underdog -e UNDERDOG_API_KEY=ud_... -- npx -y underdog-api-mcp
```

## Pricing

| Plan | Price | Credits / month | Notes |
| --- | --- | --- | --- |
| Free | $0 | 100 | No card. Live feed 5 minutes behind; last 24 hours of line history |
| Developer | $49/month | 10,000 | For models that need full training pages and loaded game-log seasons. Live feed, no added plan delay |
| Production | $149/month | 50,000 | For apps with real users and push delivery. Everything in Developer, signed webhooks for every change |
| Scale | $499/month | 250,000 | For apps whose traffic has outgrown Production. Everything in Production, 15 live-feed connections at once |

Full pricing: https://underdogapi.com/pricing

## On this page

AI agents · updated November 15, 2026



Short answer: Add an MCP server that serves the data: for Underdog Fantasy lines run claude mcp add --transport http underdog https://underdogapi.com/api/mcp with your key as a bearer header, or add the same URL as a connector in Claude; Claude can then list lines, read history and check results as tools.

## Underdog API on 15 Nov 2026

| MCP server for AI agents | Yes, on every plan |
| --- | --- |
| Free tier | 100 credits a month, no card, 5-minute delay, last 24 hours of line history |
| Cheapest paid plan | Developer, $49 a month for 10,000 credits |
| Underdog Fantasy coverage | The whole board, every league Underdog posts (8 leagues and 6,804 lines at 06:07 UTC on 15 Nov 2026) |
| Push delivery | Server-sent event stream; signed webhooks on Production and Scale |

[Get a free API key](https://underdogapi.com/sign-up) [API reference](https://underdogapi.com/docs)

Updated November 15, 2026. Our numbers are from the production database at 06:07 UTC on 15 Nov 2026; other providers' facts are paraphrased from their public pages on the date shown.

## What Claude can ask

"Which NBA lines are boosted right now?", "How did this player's points line move today?", "How often did he go Higher in his last 20 games?" Each maps to a tool on the server.

## Compared with other providers

|  | Underdog API (this site) | SportsGameOdds | ParlayAPI | The Odds API |
| --- | --- | --- | --- | --- |
| MCP server for AI agents | Yes, on every plan | An MCP server package (checked 9 Nov 2026) | Not stated on its pricing page | Not stated on its pricing page |
| Free tier | 100 credits a month, no card, 5-minute delay, last 24 hours of line history | Amateur: 2,500 objects a month, 10 requests a minute, 10-minute updates | 1,000 credits a month, no card, up to 48 hours of historical lookback | Starter: 500 credits a month, no historical odds |
| Cheapest paid plan | Developer, $49 a month for 10,000 credits | Rookie, $99 a month for 100,000 objects, 3-minute updates; Pro $299 | Starter, $5 a month for 20,000 credits; Pro $20, Business $40, Enterprise $100, Scale $200 | $30 a month for 20,000 credits; $59, $119 and $249 plans above it |
| Underdog Fantasy coverage | The whole board, every league Underdog posts (8 leagues and 6,804 lines at 06:07 UTC on 15 Nov 2026) | Underdog lines next to 85+ sportsbooks, with a fixed +100 placeholder price instead of the multiplier each side pays (checked 9 Nov 2026) | Lists Underdog among DFS apps, with entry payout multipliers on current rows (checked 13 Nov 2026) | Listed under bookmaker key underdog in the us_dfs region; non-default multipliers appear as alternate-market selections (checked 6 Nov 2026) |
| Push delivery | Server-sent event stream; signed webhooks on Production and Scale | WebSocket feeds (checked 9 Nov 2026) | WebSocket and SSE streaming from Business ($40) up | Not stated on its pricing page |

Read on 15 Nov 2026 unless a cell gives another date. Plans change; confirm on each provider's page. This site is independent and not affiliated with any company named here.

## Where this API is worse

- It covers Underdog Fantasy only. If you need sportsbook odds (moneylines, spreads, sportsbook props) in the same call, a multi-book API fits better.

## Try it against the real API

Set `UNDERDOG_API_KEY` to a free key from [sign-up](https://underdogapi.com/sign-up). Every path below is documented in the [API reference](https://underdogapi.com/docs); costs are on [credits](https://underdogapi.com/credits).

MCP (Claude Code)

```
claude mcp add --transport http underdog https://underdogapi.com/api/mcp \
  --header "Authorization: Bearer $UNDERDOG_API_KEY"

# then ask: "Which NBA lines are boosted right now?"
```

## Questions

Does it work in Claude on the web?

Yes, as a custom connector; the steps are on /use-with-claude-ai.

Does it need a paid plan?

No. MCP works on the free key.

[Answer **Is there an MCP server for sports odds and player props?**](https://underdogapi.com/answers/mcp-server-for-sports-odds) [Answer **Can ChatGPT read live player props?**](https://underdogapi.com/answers/chatgpt-player-props-data) [Answer **What is the best odds or props API for AI agents?**](https://underdogapi.com/answers/odds-api-for-ai-agents) [Plans **Pricing**](https://underdogapi.com/pricing) [Reference **API docs**](https://underdogapi.com/docs)

Underdog API is an independent data service. It is not affiliated with, endorsed by or operated by Underdog Fantasy or any company named on this page.

## References

- [SportsGameOdds, read 15 Nov 2026](https://sportsgameodds.com/pricing)
- [ParlayAPI, read 15 Nov 2026](https://parlay-api.com/pricing)
- [The Odds API, read 15 Nov 2026](https://the-odds-api.com/)
- [Underdog API pricing](https://underdogapi.com/pricing)

## FAQ

### Is there a free Underdog API?

Yes. The Free plan is a real API key on the live board, not a sample: 100 credits a month, every league, separate Higher/Lower prices and the last 24 hours of line history. No card is needed.

### Is this the official Underdog Fantasy API?

No. Underdog API is an independent data service. It is not affiliated with, endorsed by or sponsored by Underdog Fantasy or Underdog Sports.

### What data does it return?

Underdog Higher/Lower lines with separate payout multipliers and availability for each side, stable market ids through line moves, alternate rungs, recorded line history, changes, graded results and coverage/status endpoints.

### How do I use it from Claude or another AI agent?

Connect the MCP server at https://underdogapi.com/api/mcp with a bearer key, or call the REST API. Agents can request a key for their user with POST /api/v1/agent/signup.

### How much does it cost after the free tier?

Developer is $49/month for 10,000 credits, Production $149/month for 50,000, Scale $499/month for 250,000. Errors and unchanged 304 responses cost zero credits.

### How fresh is the data?

Each row carries its observation time. Check /api/v1/status and /api/v1/coverage before relying on a sport or window; missing collection is reported as unavailable, never filled in.

### Does it place entries or give picks?

No. It is data only: no entries, account operations, guaranteed outcomes or betting advice.

---
Independent data service, not affiliated with Underdog Fantasy or Underdog Sports. Docs: https://underdogapi.com/docs · OpenAPI: https://underdogapi.com/openapi.json · llms.txt: https://underdogapi.com/llms.txt
