# Use Underdog data in ChatGPT.

> Get live Underdog lines into a ChatGPT chat. Exact steps to paste the board, connect the MCP server, or add a GPT Action, and which ChatGPT plans each one needs. 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-chatgpt

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

Guide



Four ways to get lines into a chat. Pick by your ChatGPT plan. Plan details and steps follow OpenAI's documentation as of 1 November 2026.

Short answer: ChatGPT cannot send a custom API key to an MCP server: connect https://underdogapi.com/api/mcp with no authentication for the keyless search, fetch and demo tools, paste a board you exported, or use a GPT Action with your key.

## Which one to use

| Route | What ChatGPT gets | ChatGPT plan |
| --- | --- | --- |
| [Paste the board](https://underdogapi.com/use-with-chatgpt#paste) | Latest collected lines, with observation times | Any |
| [Point it at a public page](https://underdogapi.com/use-with-chatgpt#public-page) | What the page shows, including a player's current lines | Any with web search |
| [Connect the MCP server](https://underdogapi.com/use-with-chatgpt#mcp) | Search and read of public pages, no key | Business, Enterprise and Edu. Pro with read-only tools |
| [GPT Action](https://underdogapi.com/use-with-chatgpt#gpt-action) | The live API, called with your key | Existing GPTs, and workspaces that can still create them. Ends 11 December 2026 |

## Paste the board

One request, one short line per offer: 200 rows by default, up to 1,000.

1. [Create a free account](https://underdogapi.com/sign-up), or [sign in](https://underdogapi.com/sign-in).
2. On your workspace [Overview](https://underdogapi.com/dashboard), find **Send to ChatGPT**, choose a league, add a stat if you want one, and select **Get board**.
3. Select **Copy**, then paste it into ChatGPT with the prompt below.

Prompt to paste with it

```
Below is an Underdog board exported from underdogapi.com. Use only these rows for lines. Quote the read time from the header when you state a line, and tell me if it is more than an hour old. Side availability is independent of its multiplier; check selections[].available. This is information for analysis, not betting advice.

[paste the board here]

My question:
```

From a terminal, the same text costs one API request. On a Mac this puts it on your clipboard:

Copy a board with your key

```
curl -s "https://underdogapi.com/api/v1/export?league=NBA&stat=Points&format=text" \
  -H "Authorization: Bearer $UNDERDOG_API_KEY" \
  -H "X-User-Request: Export NBA points board for chat analysis" | pbcopy
```

To see the format first, open [the sample board](https://underdogapi.com/api/v1/demo/export?format=text). It needs no key and its rows are fictional. A board is a snapshot. Its observation times show when collection confirmed each line, not when you copied it. Paste a new export when you need newer observations. For a spreadsheet-style analysis, [export a CSV](https://underdogapi.com/docs#export) and upload the file instead.

## Point it at a public page

Every league and player page renders as plain text, and our robots rules allow ChatGPT's crawlers.

Paste a link into the chat and ask about it. Find links from [props by league](https://underdogapi.com/props), for example [https://underdogapi.com/props/nba](https://underdogapi.com/props/nba). Ask ChatGPT to use the page and to state when the lines were last seen.

## Connect the MCP server

For ChatGPT accounts that can add a custom MCP server. This route needs no key and reads public pages only.

1. On ChatGPT web, go to [Plugins](https://chatgpt.com/plugins), select the plus button, then **Add custom MCP server**.
2. Name it `Underdog` and enter the server URL below.
3. Set authentication to **No authentication**.
4. Review the risk warning, select **I understand and want to continue**, then **Create as a plugin**.
5. Install the plugin, start a new chat, type `@` and select it.
6. Try: `Use the search and fetch tools to find Jayson Tatum's current lines.`

Server URL

```
https://underdogapi.com/api/mcp
```

The `search`, `fetch`, sample data and feedback tools work this way. The other data tools need a key, which ChatGPT connections cannot send, so they answer with a message saying so. You can switch those tools off in the plugin's settings. Claude Code, Cursor and Codex send a key and get every tool: see the [agent setup](https://underdogapi.com/agents.md).

## GPT Action

The live API, inside a GPT. Use it with a GPT you already have or if your workspace can still create one.

OpenAI says personal accounts (Free, Go, Plus and Pro) can no longer create GPTs, custom GPTs retire on 11 December 2026 on the standard schedule, and actions do not carry over when a GPT migrates to a plugin.

1. Open [GPTs](https://chatgpt.com/gpts), then edit your GPT from **My GPTs**, or select **Create** if your workspace allows it.
2. In the configuration view, go to **Actions** and select **Create new action**.
3. Under **Authentication**, choose **API key**, then **Bearer**, and paste your key from your [workspace](https://underdogapi.com/dashboard/keys).
4. Under **Schema**, import from the URL below.
5. Set the privacy policy URL to [https://underdogapi.com/privacy](https://underdogapi.com/privacy). OpenAI requires one for GPTs shared by link.
6. Paste the instructions below into the GPT's **Instructions**, then test in **Preview**: `What NBA points lines are on the board?`

Schema URL

```
https://underdogapi.com/openapi-chatgpt.json
```

GPT instructions

```
Answer Underdog questions from the actions, not from memory.
For the current board call LiveProjections with view=compact and a league. Add stat or search whenever the question allows it. Keep limit at 200 or lower.
Follow meta.next_cursor only when the rows so far do not answer the question.
Use LiveHistory for one market over time, and LiveResults and LiveHitRates for recorded outcomes.
Quote observed_at when you state a line. If meta.source_status is not fresh, say so.
Higher and Lower carry separate payout multipliers. Unavailable side prices are null.
This data is independent of Underdog. Give information, not betting advice.
```

The key belongs to you, so anyone you share the GPT with uses your monthly allowance. Keep it private unless you mean that. OpenAI caps an action response at 100,000 characters, so this schema allows 200 compact rows a call. Ask for a league and a stat rather than the whole board.

## Questions

What is the fastest way to get Underdog lines into ChatGPT?

Copy the board as text and paste it into the chat. It works on any ChatGPT plan, takes one API request, and ChatGPT never holds your key.

Can ChatGPT call the API with my key through the MCP connector?

No. OpenAI lists OAuth and no authentication as the options for a custom MCP server, and says ChatGPT cannot present custom API keys. Connected with no authentication, ChatGPT can search and read our public pages, including current lines per player.

Should I build a custom GPT?

Only if you already have one or your workspace can still create them. OpenAI says personal accounts can no longer create GPTs, custom GPTs retire on 11 December 2026 on the standard schedule, and actions do not carry over when a GPT is migrated.

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

[Guide **Use with Lovable** *A prompt that wires the API into your app, with the key as a secret.*](https://underdogapi.com/use-with-lovable) [Docs **API reference** *Endpoints, filters and errors.*](https://underdogapi.com/docs) [Pricing **Plans and request limits**](https://underdogapi.com/pricing)

## References

- [OpenAI: Connecting custom MCP servers in ChatGPT](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt)
- [OpenAI: Add custom MCP server](https://developers.openai.com/api/docs/guides/custom-mcp-server)
- [OpenAI: Authenticate users](https://developers.openai.com/plugins/build/auth)
- [OpenAI: Configuring actions in GPTs](https://help.openai.com/en/articles/9442513-configuring-actions-in-gpts)
- [OpenAI: Production notes on GPT Actions](https://developers.openai.com/api/docs/actions/production)
- [OpenAI: Custom GPT retirement and migration FAQ](https://help.openai.com/en/articles/20001519-custom-gpt-retirement-and-migration-faq)

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