Skip to main content

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 .

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

Metadata

Release files for fc26-mcp 0.2.26

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fc26-mcp 0.2.26
File Size Uploaded
fc26_mcp-0.2.26.tar.gz 139.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for fc26-mcp 0.2.26
File Interpreter ABI Platform
fc26_mcp-0.2.26-py3-none-any.whl Python 3 none any Details

Total release size: 291.8 kB

Release files / fc26_mcp-0.2.26.tar.gz

Download URL fc26_mcp-0.2.26.tar.gz
Size 139.0 kB
Tags Source
SHA-256 checksum
How to use checksums
fa67a3385a93dd8582f70e4cb27005054e8eb83ac0acfe9b98552a39638512bc
BLAKE2b-256 checksum
How to use checksums
44e93bfa0f7cdb4f8dabfc6a4acf99ea9679a1119ea9cfe438a160a2a5af0596
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.10

Release files / fc26_mcp-0.2.26-py3-none-any.whl

Download URL fc26_mcp-0.2.26-py3-none-any.whl
Size 152.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d2f0d9d09158e7e86828d5d5fb41fb7c3750c1738f44cfc82f46f0101cf67837
BLAKE2b-256 checksum
How to use checksums
a8a031b900ec592c2d2bdf4dce52b525c75e6dd031b018c8b8dc1404f4b2e54c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.10
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page