Fantasy Pundit / Public contract

Quickstart

Connect once, provide a public FPL league, and ask for the weekly verdict.CHATGPT · CLAUDE · MCP

Reference / 02

1. Connect Fantasy Pundit

Add the remote MCP server to a compatible client:

https://api.fantasypundit.lol/mcp

Use the guided connection page to copy the server URL and open ChatGPT’s Plugins page, launch Claude’s prefilled custom connector, or use page-local tools in a supported agent browser. Finding Fantasy Pundit through web search does not connect the tools; the user must add or approve the connection before an assistant can call them.

2. Provide a league

Use one of the following:

  • A numeric public classic-league ID.
  • A public Fantasy Premier League league URL containing that ID.
  • A league name, followed by a selection if more than one match is found.

Private league access and Fantasy Pundit accounts are not part of this contract.

3. Ask naturally

Try:

Get the latest Fantasy Pundit commentary for [public league URL or ID].

Has Fantasy Pundit published this week’s verdict for this league URL?

Generate this week’s Fantasy Pundit commentary for my league, then give me the share link.

The first two requests are read-only. The last request explicitly authorises the connected client to create or reuse the official weekly edition.

4. Follow the lifecycle

Clients should call get_league_commentary first. If an edition is missing, they should only call generate_weekly_commentary after the user asks to create it. At full-time the request may be saved until FPL scoring is ready. Poll get_commentary_result using the returned job ID and suggested delay; do not gate the create call solely on the official lastCompletedGameweek value.

5. Preserve the published edition

When the status is completed, present the returned commentary and links as the Fantasy Pundit edition. Do not ask another model to rewrite it, add invented facts, or create a second official version.

6. Never miss the next roast

Every public league has an account-free calendar feed:

https://api.fantasypundit.lol/api/leagues/{seasonId}/{leagueId}/calendar.ics

It lists each upcoming FPL deadline (with a reminder 90 minutes before), the time each roast usually lands—the morning after the final match, around 10:00 UK time—and the headline of every published roast. Subscribe with webcal:// in Apple Calendar, add the https URL by link in Google Calendar or Outlook, or use the Add to calendar buttons on the league page. The feed is read-only and never creates commentary.

Leagues that keep coming back have their weekly edition written automatically once the Gameweek is settled, so get_league_commentary may already return the latest verdict.