# Use Underdog data in Cursor.

> Add Underdog player props to Cursor over MCP: the mcp.json entry, the env variable it reads, and where to look when the tools do not appear. 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/use-with-cursor

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

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

Cursor integration



A short `mcp.json` entry gives Cursor current lines and recorded moves while you build. Steps follow Cursor's documentation as of 5 November 2026.

Short answer: Add the underdog server to .cursor/mcp.json with url https://underdogapi.com/api/mcp and Authorization: Bearer ${env:UNDERDOG_API_KEY}, then check its tools in Cursor's MCP settings.

## Add the server

1. [Create a free account](https://underdogapi.com/sign-up) and copy a key from [API keys](https://underdogapi.com/dashboard/keys).
2. Set `UNDERDOG_API_KEY` in your shell profile or system environment, then restart Cursor.
3. Merge the entry below into `.cursor/mcp.json` in your project, or `~/.cursor/mcp.json` for all projects. Keep any other servers.
4. Check that `underdog` is enabled under **Customize** in the sidebar and that its tools are listed under **Available Tools**.

mcp.json

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

## Ask for a small read

First message in Cursor chat

```
Use the Underdog MCP tools for my NBA dashboard integration. Send user_request describing this task; omit personal information and secrets, and disclose the task-summary collection once. If setup is required, complete it from the project purpose already provided; do not invent missing intent.
Read get_coverage, then get_projections with league NBA, view compact and limit 5. Report the actual rows, observed_at and source status. If the board is empty or delayed, say so. Never substitute demo rows for live data. Do not recommend picks or claim predicted profits.
```

Cursor should call `get_coverage`, then `get_projections`. On a new account it calls `complete_setup` first. Check that the answer quotes real rows and their `observed_at` times.

## Build the app against REST

MCP helps Cursor see the data while it writes code. Your app should call REST from the server, so the key never reaches the browser. Point Cursor at the [OpenAPI document](https://underdogapi.com/openapi.json) and show it this request to check its code against:

Bounded request

```
curl --fail-with-body 'https://underdogapi.com/api/v1/coverage' \
  -H "Authorization: Bearer $UNDERDOG_API_KEY" \
  -H 'X-User-Request: Check Cursor project integration'
```

## If the tools do not appear

Open the Output panel, then choose **MCP Logs** in the dropdown. It shows server startup, tool calls and errors. An authentication error usually means Cursor started without the variable. Use the [credit calculator](https://underdogapi.com/credits) before you let an agent loop over large pages.

## Questions

Should I use the project file or the global one?

Use .cursor/mcp.json when one project needs it, and ~/.cursor/mcp.json for every project. The entry is the same in both.

Can I commit .cursor/mcp.json?

Yes, if it holds the ${env:UNDERDOG_API_KEY} placeholder and not a real key.

Can I keep the key in an env file?

Not for this server. Cursor says envFile works only for STDIO servers, and this one is remote. Set the variable in your shell profile or system environment.

Is this an official Underdog integration?

No. This is an independent API and is not affiliated with Underdog.

A step no longer matches what you see? Tell us and we will fix this page.

[Compare **Which Underdog data API to use**](https://underdogapi.com/underdog-api-alternatives) [Integration **Use Codex**](https://underdogapi.com/use-with-codex) [Guide **JavaScript client**](https://underdogapi.com/underdog-api-javascript) [Pricing **Plans and credits**](https://underdogapi.com/pricing)

## References

- [Cursor: Model Context Protocol](https://cursor.com/docs/mcp)
- [Underdog API: machine-readable contract](https://underdogapi.com/openapi.json)

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