Developer guide

Building on FootballGPT

What it is

FootballGPT publishes its coaching API over MCP (Model Context Protocol) so a third-party tool, an FM mod included, can put FootballGPT behind its own interface. A coach signs in with the FootballGPT account they already have. Every call your tool makes is billed to their FootballGPT plan, not to you. There is nothing to install on your side and nothing that breaks when the game itself patches, because you are calling an API, not reading a save file.

How a user connects today

Today, a user connects with a Bearer API key created at footballgpt.co/app/mcp. That is the supported path for any tool built today. OAuth sign-in, so a user never sees a key at all, is in progress and not live yet. This guide will say so plainly when it changes; it does not claim OAuth works before it does.

Full setup steps, client configuration and error codes are documented separately at footballgpt.co/docs/api.

The tools

get_my_profile

Loads the coach’s team, squad and coaching priorities.

get_coaching_advice

Answers a coaching question in the coach’s own context.

generate_session_plan

Builds a full training session, warm-up to cool-down.

search_drills

Searches the FootballGPT practice database.

animate_drill

Creates an animated practice and saves it to the coach’s account.

Each call costs the same as the equivalent action in the app.

Edition rules

Every tool is edition-aware and fails closed for an edition it has not verified. Football Manager 24 is the legacy edition and is supported. Football Manager 26 is the current edition and is supported. Football Manager 27 is not yet selectable by any user and is refused by every tool until it is verified against real output, not offered as a guess.

What FootballGPT never reads

FootballGPT only ever sees what your tool sends in the request. It does not read a save file, does not inject into the game process, and keeps no memory of a call beyond what the coach’s own FootballGPT account already stores. If your tool reads a save file or injects into the game, that is your tool’s behaviour, not ours, and your own terms with Sports Interactive govern it.

Listing criteria

  • Your tool calls the FootballGPT API.
  • You can point to one verified journey: a real user, connecting, calling a tool, and reading the answer.
  • We list your tool. We do not endorse, test, or vouch for it beyond that one journey.
  • There is no fee to be listed.
  • There is no exclusivity. Any tool that meets the criteria is listed, including a competing one.

How to get listed

Open a pull request adding your tool to works-with.ts, with a link to your verified journey, on the file here: https://github.com/360tft/FootballGPT/blob/main/src/data/works-with.ts

See who has already connected

2 tools connect to FootballGPT today.

View Works With