Skip to main content
Glama

FC 26 MCP

Python 3.8+

MCP servers for EA SPORTS FC 26. Works with Claude, Codex, Pi, Cursor, Cline, Windsurf, and any other agent that supports the Model Context Protocol.

Two servers are included:

  1. fc26-mcp-file — parses and edits raw Squads* files in FBCHUNKS/T3DB format.

  2. fc26-mcp-live — controls FC 26 through xAranaktu's Live Editor Lua API while the game runs.


Install

From PyPI:

pip install fc26-mcp

From GitHub:

pip install git+https://github.com/INSANE0777/Fc26-live-editor-mcp.git

From source:

git clone https://github.com/INSANE0777/Fc26-live-editor-mcp.git
cd fc26-mcp
pip install -e .

GUI editor

A desktop GUI (tkinter, no extra dependencies) for opening a squad file and editing it entirely in the UI — no MCP client or Live Editor needed:

fc26-mcp-gui                      # open via file dialog
fc26-mcp-gui "path/to/Squads..."  # open a specific squad file directly

Features:

  • Browse / search / edit / delete rows in all 78 DB tables (filter box per table)

  • Player search by name or ID, showing current club and loan status

  • One-click transfers — pick a player + target team, applies to all club links (national team links are preserved automatically)

  • Terminate loans — removes the playerloans row(s)

  • Auto-backup before you save, plus a manual Backup button

  • Unsaved-changes indicator; Save writes back to the same file (or a copy)

Note: the squad file's dcplayernames table is incomplete (~6k of ~22k players), so many players show ? as their name — search by player ID for those.


Paths

The package uses placeholder paths. Set your actual paths via command-line flags or environment variables:

What

Flag

Environment Variable

Example

Squad file

--squad-file

FIFA_SQUAD_FILE

C:\Path\To\Your\SquadsFile

Live Editor bridge folder

--bridge-root

FC26_BRIDGE_ROOT

C:\Path\To\Your\FC 26 LE\le_bridge

Live Editor scripts folder

--install-lua

C:\Path\To\Your\FC 26 LE\lua\scripts

Quick start

1. Squad file MCP

fc26-mcp-file --squad-file "C:\Path\To\SquadsFile"

The bundled FC 26 metadata is used automatically. You can override it with --meta-file.

2. Live Editor MCP bridge

  1. Launch FC 26 and inject Live Editor.

  2. Load Career Mode.

  3. Install the Lua bridge into Live Editor once:

fc26-mcp-live --install-lua "C:\Path\To\Your\FC 26 LE\lua\scripts"
  1. In Live Editor, go to Features → Lua Engine and run le_bridge.lua.

  2. Start the MCP server:

fc26-mcp-live --bridge-root "C:\Path\To\Your\FC 26 LE\le_bridge"

Tools

File parser

  • list_clubs

  • search_players

  • get_player_club

  • plan_transfers

  • apply_transfers

Live Editor bridge (28 tools)

  • Core: le_ping, le_list_clubs, le_search_players, le_get_player_club

  • Transfers/loans: le_transfer_player, le_loan_player, le_release_player, le_terminate_loan

  • Lists: le_add_to_transfer_list, le_add_to_loan_list, le_remove_from_lists, le_is_transfer_listed, le_is_loan_listed

  • Player state: le_set_player_sharpness, le_set_player_morale, le_set_player_form, le_set_player_fitness

  • Budget: le_get_transfer_budget, le_set_transfer_budget

  • Database editor: le_get_db_tables, le_get_db_fields, le_get_db_rows, le_edit_db_field, le_insert_db_row, le_delete_db_row

  • Stats: le_get_players_stats, le_get_player_stats

  • Power user: le_execute_lua

See README_LE_BRIDGE.md for detailed Live Editor docs.


MCP client config

Use mcp_config.json as a template, or add these servers manually:

{
  "mcpServers": {
    "fc26-file": {
      "command": "fc26-mcp-file",
      "args": [
        "--squad-file",
        "C:\Path\To\SquadsFile"
      ]
    },
    "fc26-live": {
      "command": "fc26-mcp-live",
      "args": [
        "--bridge-root",
        "C:\Path\To\Your\FC 26 LE\le_bridge"
      ]
    }
  }
}

Claude Desktop

Open claude_desktop_config.json and add the server blocks above.

Cursor

Open Cursor Settings → MCP → Add MCP Server, paste the command and args.

Cline / Roo Code

Add the JSON to your MCP settings file.

Pi

Pi detects stdio MCP servers from mcp_config.json or your workspace settings.


Environment variables

Variable

Purpose

FIFA_SQUAD_FILE

Default squad file path for fc26-mcp-file

FIFA_META_FILE

Override bundled FC 26 metadata XML

FC26_BRIDGE_ROOT

Bridge folder for fc26-mcp-live


Safety

  • Always back up your squad files and Career Mode saves before editing.

  • Career Mode tools only work inside Career Mode.

  • le_execute_lua can run arbitrary code — use it carefully.


License

MIT