Connector documentation
Play Index for ChatGPT and Claude
The Play Index Model Context Protocol (MCP) server lets you ask ChatGPT or Claude questions about your Fantasy Premier League team — current squad, transfer suggestions, mini-league rivals, fixture difficulty — and get answers grounded in our live data instead of the model's training-cutoff guesses. World Cup 2026 nation form and player projections are exposed through the same connector.
Overview
What this connector does
Play Index is a read-only data and analytics connector. It exposes 27 tools across two areas:
- FPL (18 tools) — manager histories, transfer suggestions, top-target rankings, the Play Index Difficulty Rating built from rolling team xG/xGA, live transfer trends and captaincy from the FPL API, plus an interactive squad pitch view across upcoming gameweeks.
- World Cup 2026 (9 tools) — nation form, match predictions from our Dixon-Coles xG model, squad recommendations and side-by-side nation comparisons.
Nothing in this connector writes to your FPL account, places bets or moves money. It is read-only by design.
Example prompts
What people actually ask
Compare my playstyle with the other managers I follow this season.
Who should I transfer in for the next 5 gameweeks? My budget is £8m and I want to stay below 15% ownership.
What does my current squad look like for GW36 and which two players are at risk of a -4 hit if I move them?
How do England, France and Brazil compare on recent form going into the World Cup?
Show me the easiest fixture runs over the next 6 gameweeks ranked by Play Index Difficulty Rating.
Connection requirements
What you need before connecting
- A free Fantasy Premier League account (your team is then claimable by FPL entry id).
- A Play Index account — create one at Play Index/register — email + password.
- ChatGPT Plus / Pro or any Claude account (Claude.ai web, Claude Desktop, or Claude on the API).
You'll need an FPL account and a Play Index login to connect. Geographic availability follows the FPL API itself (worldwide).
Setup
Connecting from Claude.ai
- Open Claude.ai → Settings → Connectors → Add custom connector.
- Paste the MCP URL:
https://api.play-index.com/mcp/sse
- Click Add. Claude walks the OAuth discovery chain, registers itself dynamically (RFC 7591) and redirects you to a Play Index consent screen.
- On the consent screen, sign in with your Play Index email + password and click Allow.
- Open a new chat and ask any of the example prompts above. The tool-call chip with the Play Index logo appears when a tool fires.
Connecting from ChatGPT
- ChatGPT → Settings → Apps → Advanced → turn Developer Mode on.
- Back on the Apps page, click Create app.
- Name it Play Index, paste the MCP URL above, leave the auth dropdown on auto-detect (or pick OAuth).
- Click Create. ChatGPT redirects you to the same Play Index consent screen — sign in, click Allow.
- Open any chat, mention the app, and ask. ChatGPT decides when to call a Play Index tool based on the prompt.
Connecting from Claude Desktop
Claude Desktop reads MCP servers out of a JSON config file. For this connector, the easiest path is to generate an API key inside Play Index (Settings → API keys → New) and paste it as a Bearer header. Add the following to claude_desktop_config.json:
{
"mcpServers": {
"Play Index": {
"transport": "sse",
"url": "https://api.play-index.com/mcp/sse",
"headers": {
"Authorization": "Bearer pk_live_<paste-your-key-here>"
}
}
}
}Restart Claude Desktop. The 22 Play Index tools appear in the tool picker.
Tool catalogue
What ChatGPT and Claude can call
FPL — your team
- list_my_managers
- get_manager_season
- get_manager_gameweeks
- get_manager_transfers
- get_manager_current_squad
- get_recent_decisions
- get_followed_managers_summary
- compare_managers
- get_mini_league_standings
FPL — players, fixtures, advice
- find_player
- get_player_outlook
- get_top_transfer_targets
- suggest_transfers
- get_team_fdr_outlook
- get_fpl_rules
- get_live_transfer_trends
- get_live_top_captained
- get_squad_outlook (interactive pitch view)
World Cup 2026 — our model
- get_wc_match_predictions
- get_wc_player_outlook
- get_wc_nation_form
- get_wc_squad_recommendation
- compare_wc_nations
World Cup 2026 — Fantasy game
- get_wc_fantasy_rules
- get_wc_fantasy_rounds
- find_wc_fantasy_player
- get_wc_fantasy_top_picks
Every tool is annotated as readOnlyHint: true in the MCP tools/list response — none of them mutate your FPL account or any third-party system. Annotations are emitted both nested under annotations and duplicated at the top level so every MCP host (Claude, ChatGPT Apps SDK) reads each tool fully.
Security & privacy
How your data is handled
- Authentication — OAuth 2.1 with dynamic client registration (RFC 7591), PKCE S256, and single-use refresh-token rotation with family revocation (RFC 6819 §5.2.2.3). API keys (an alternative path for Claude Desktop) are stored as SHA-256 hashes; raw values exist only in transit.
- Transport — TLS from a recognised CA on the MCP origin (Heroku managed certificate).
- Scope — every tool response is filtered by the caller's user id at the database layer. You see your own claimed managers + public managers (FPL content creators / legendary managers); never another user's private data.
- No model training — we do not feed your usage of this connector into any model. The LLM you talk to runs in ChatGPT or Claude, governed by their privacy policies, not ours.
Full details: privacy policy · terms of service.
Troubleshooting
Common issues and one-line fixes
- "MCP server does not implement OAuth"
- You pasted a URL on a different host than the OAuth discovery docs live on. Use the URL above (Heroku origin) directly — not the Vercel proxy URL.
- The consent screen says "invalid_client"
- Clear the connector and re-add it. Claude/ChatGPT cache a stale client registration; re-adding triggers a fresh dynamic registration.
- No tools show up after I authorise
- The first
tools/listcall may take 2–3 seconds on a cold Heroku dyno. Wait a moment and refresh the connector panel. If still empty, sign out and back in — your session may have expired. - "You have no claimed managers yet"
- Open Play Index/fpl/manager and click Claim your team. Paste your FPL entry id (the number in your FPL team URL) — your history will ingest in the background within ~60s.
- compare_managers returns an empty array
- The model passed the internal NotableManager id instead of the FPL entry id. Ask the assistant to call
list_my_managersfirst and use thelatest_fpl_entry_idfield — never the smallidfield — when comparing. - Transfer suggestions are missing predictions
- Predictions for upcoming gameweeks are computed nightly. If you connected right after a fixture-list refresh and the next GW hasn't been scored yet,
suggest_transfersreturns apredictions_warningwith the exact admin endpoint that needs to fire. Email us if the warning persists for more than 12 hours.
Support
Get help or report an issue
Email support@play-index.online. Replies during UK business hours.
For account-specific issues, include your Play Index email and the last GW you used the connector — it lets us trace the exact tool call in our logs.