MCP Server Documentation

Connect FantasyBot to Claude for real-time fantasy sports data with rich interactive widgets.

Setup

Connect to Claude

Open Claude.ai and click on your account menu in the bottom-left corner.
Go to Settings, then select Connectors.
Click Add custom connector.
Enter a name (e.g. "FantasyBot") and paste the server URL:
https://api.fantasybot.ai/claude/mcp
Click Add, then click Connect next to the new connector.
You'll be redirected to sign in. Create an account or log in with your existing credentials.
Once connected, open any chat, click the + button at the bottom-left, select Connectors, and toggle FantasyBot on.

Server Details

Server URL	`https://api.fantasybot.ai/claude/mcp`
Protocol	MCP over Streamable HTTP
Authentication	OAuth 2.0 (PKCE)
Sports	NFL, NBA, MLB, NHL
Rate Limit	100 tool calls per day

Tools

All 7 tools are read-only and return both structured data and an interactive widget rendered inline in the chat. No league linking is required — just ask about any player by name.

Get Player Stats

get_player_stats

Look up any player's fantasy stats across NFL, NBA, MLB, or NHL. Returns season totals, PPG, key stats, trends, current matchup, and recent news.

Try"How is Patrick Mahomes doing this season?"

Parameter	Type	Required	Description
`player_name`	`string`	Yes	Player name to look up
`sport`	`nfl \| nba \| mlb \| nhl`	No	Auto-detected if omitted
`scoring`	`ppr \| half \| non-ppr`	No	NFL scoring format

Analyze Trade

analyze_trade

Evaluate a fantasy trade by comparing deep stats for all players on both sides. Returns PPG, trends, projections, matchups, and news for each player.

Try"Should I trade Tyreek Hill for Ja'Marr Chase and Travis Kelce?"

Parameter	Type	Required	Description
`side_a_players`	`string[]`	Yes	Player names on Side A
`side_b_players`	`string[]`	Yes	Player names on Side B
`sport`	`nfl \| nba \| mlb \| nhl`	No	Auto-detected if omitted

Start/Sit Analysis

start_sit_analysis

Compare 2-5 players and rank them by projected performance. Uses projections, recent trends, and matchup difficulty to recommend who to start, flex, or sit.

Try"Start Achane, Gibbs, or Drake London at flex?"

Parameter	Type	Required	Description
`players`	`string[]`	Yes	2-5 player names to compare
`sport`	`nfl \| nba \| mlb \| nhl`	No	Auto-detected if omitted
`scoring`	`ppr \| half_ppr \| standard`	No	Defaults to PPR

Get Trending Players

get_trending_players

See which players are being added or dropped the most across fantasy leagues. Useful for waiver wire decisions.

Try"Who is trending up on waivers?"

Parameter	Type	Required	Description
`sport`	`nfl \| nba \| mlb \| nhl`	No	Defaults to NFL
`type`	`add \| drop`	No	Defaults to add
`limit`	`number (1-25)`	No	Number of players to return
`lookback_hours`	`number (1-168)`	No	Defaults to 24 hours

Get Player Value

get_player_value

Get a deep breakdown of a player's trade value including season stats, PPG, trends, projections, matchup grade, and latest news.

Try"What's Bijan Robinson's trade value?"

Parameter	Type	Required	Description
`player_name`	`string`	Yes	Player name to evaluate
`sport`	`nfl \| nba \| mlb \| nhl`	No	Auto-detected if omitted

Get Position Rankings

get_position_rankings

Rank the top players at any position by fantasy points. Supports season stats or weekly projections across all four sports.

Try"Rank the top 10 wide receivers"

Parameter	Type	Required	Description
`position`	`string`	Yes	e.g. QB, RB, WR, TE, PG, SP, C, LW
`sport`	`nfl \| nba \| mlb \| nhl`	No	Auto-detected from position
`limit`	`number (5-20)`	No	Defaults to 20
`type`	`stats \| projected`	No	Season stats or weekly projections
`week`	`number`	No	Required if type is projected
`scoring`	`ppr \| half_ppr \| standard`	No	Defaults to PPR

Compare Players

compare_players

Head-to-head comparison of two players with side-by-side stats, trends, projections, and matchups. Shows an overall winner.

Try"CeeDee Lamb vs Justin Jefferson"

Parameter	Type	Required	Description
`player_a`	`string`	Yes	First player name
`player_b`	`string`	Yes	Second player name
`sport`	`nfl \| nba \| mlb \| nhl`	No	Auto-detected if omitted

Troubleshooting

"Player not found"

Try using the player's full name (e.g. "Patrick Mahomes" instead of "Mahomes"). The search is fuzzy but works best with full names. If a player was recently traded or is a rookie, data updates every 24 hours.

"Rate limit exceeded"

Each account is limited to 100 tool calls per day. The limit resets at midnight UTC. If you hit the limit, the widget will show a fallback message with the reset time.

Connector not showing tools

Make sure the connector is toggled on for your current conversation. Click the + button at the bottom-left of the chat, select Connectors, and ensure FantasyBot is enabled.

Authentication errors

If you see a 401 error, try disconnecting and reconnecting the connector in Settings > Connectors. This will refresh your OAuth tokens.

Widget not rendering

Widgets require a modern browser. Make sure you're using the latest version of Claude.ai. If the widget doesn't appear, the tool response will still include a text summary with all the data.

Support

Need help? Reach out at support@fantasybot.ai or visit our contact page.