PremAnalytics MCP

Premier League data, in your AI.

Connect PremAnalytics to Claude or ChatGPT and it can answer from the table, player stats, match data and analysis reports directly. Just ask “who leads for tackles won?” — no code, just one URL to register.

Want to fetch data from your own code instead? See the Web API.

Plans & limits

PlanMCP accessRate limitMonthly tool calls
Data Fan planNot available––
Data Supporter plan✓60 calls/min1,000/mo (resets on the 1st, UTC)
Data Ultras plan✓240 calls/minUnlimited*

* Because “unlimited” is an open-ended resource, we may pause access for a safety check even within the limits — contact us and we will lift it right away. There is no daily cap — MCP runs inside your AI client, so spend your month however you like. Only actual tool calls count — the connection handshake is free. An AI typically makes 1–5 calls per question, so 1,000 calls ≈ 200–500 questions/month. Counted separately from the Web API quota. The connection stops working on cancellation or downgrade to Data Fan (it works again if you re-subscribe). Quotas are subject to change.

See pricing →

Eight tools. The AI picks and calls them as needed. All read-only — none of them can modify data.

Standings & stats

The table plus club and player season stats. Sortable, so “top 5 for X” works directly.

  • league_table
    Position, points, goal difference
  • player_stats
    Per-player goals, assists, shooting, defending, minutes
  • squad_stats
    Club-level aggregates for team comparison

Matches

Results, fixtures and per-match detail — what actually happened in a game.

  • fixtures
    Results and fixtures, filterable by matchweek
  • match_detail
    Score, xG, team stats, goals and cards

Reports & news

AI pre/post-match analysis and published news. Responses state when content is a prediction or AI-generated.

  • search_reports
    Pre-match previews (predictions) and post-match reports
  • search_news
    Published news articles

Season context

Answers “which matchweek is it?” and grounds the other tools.

  • season_context
    Current season, matchweeks played, data freshness

Pre-match previews are predictions and post-match narratives are AI-generated. The tool responses say so explicitly, so the AI does not present them as fact.

Server URL
https://premie-backend-lvuzwxd3aq-uc.a.run.app/mcp/

Copy it including the trailing slash

Auth
Sign-in or API key

No key needed for Claude / ChatGPT

Transport
Streamable HTTP

All tools are read-only

How to connect

Claude

browser / desktop

No API key — you sign in and approve when connecting.

  1. Open Settings (desktop: Ctrl+, / browser: profile → Settings)
  2. “Connectors” in the sidebar
  3. “Add” → “Add custom connector”
  4. Paste the server URL above
  5. Sign in, approve, done

※ Leave the OAuth client ID / secret fields empty — registration is automatic.

ChatGPT

developer mode

No API key — enable developer mode first.

  1. Settings → Apps → Advanced settings
  2. Turn on “Developer mode”
  3. Add a custom connector with the server URL above
  4. Choose OAuth for authentication
  5. Sign in, approve, done

※ Developer mode is available on Plus / Pro / Business / Enterprise / Education, from the web app.

Claude Code

API key

Issue a key in Settings → Web API & MCP.

claude mcp add --transport http premanalytics \
  https://premie-backend-lvuzwxd3aq-uc.a.run.app/mcp/ \
  --header "Authorization: Bearer pak_..."

Cursor / others

config JSON

The standard format for MCP-capable clients.

{
  "mcpServers": {
    "premanalytics": {
      "type": "http",
      "url": "https://premie-backend-lvuzwxd3aq-uc.a.run.app/mcp/",
      "headers": {
        "Authorization": "Bearer pak_..."
      }
    }
  }
}

Menu names change over time (“Connectors” was renamed to “Plugins” in ChatGPT in July 2026). If the screens differ, please let us know.

If it does not connect

Status codes

  • 401 Unauthorized
    Not authenticated, or the token/key is invalid or revoked
  • 403 Forbidden
    Authenticated but the plan is not eligible (Fan / cancelled)
  • 429 Too Many Requests
    Per-minute rate or monthly quota exceeded

How to narrow it down

  1. First check the key itself — 200 means it is fine
    curl -s -o /dev/null -w "%{http_code}\n" \
      -H "X-API-Key: pak_..." \
      https://premie-backend-lvuzwxd3aq-uc.a.run.app/v1/league-table/overall
  2. Omitting the trailing slash causes one redirect — include it if your client dislikes redirects
  3. Still stuck? Please contact us

Give your AI the Premier League

MCP is available on Data Supporter ($6/mo) and above.