Skip to main content

MCP servers for EA SPORTS FC 26 squad editing and Live Editor control

Project description

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 .

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\FC 26 LE v26.3.5\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\FC 26 LE v26.3.5\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\FC 26 LE v26.3.5\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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fc26_mcp-0.2.3.tar.gz (136.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fc26_mcp-0.2.3-py3-none-any.whl (150.7 kB view details)

Uploaded Python 3

File details

Details for the file fc26_mcp-0.2.3.tar.gz.

File metadata

  • Download URL: fc26_mcp-0.2.3.tar.gz
  • Upload date:
  • Size: 136.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.10

File hashes

Hashes for fc26_mcp-0.2.3.tar.gz
Algorithm Hash digest
SHA256 238aad6b302ab543d33b6ba5cddaab4b590cfbaaa2d31801af79c2991b0bdfd4
MD5 49f5493406a56c1ca269616e08a9698d
BLAKE2b-256 4afe9c531cc6945b24db775384e86d6c5b7dd2dfc5b5a6eed66e4febdd22fac7

See more details on using hashes here.

File details

Details for the file fc26_mcp-0.2.3-py3-none-any.whl.

File metadata

  • Download URL: fc26_mcp-0.2.3-py3-none-any.whl
  • Upload date:
  • Size: 150.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.10

File hashes

Hashes for fc26_mcp-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 f45ddffc1bd8d84c9ada97b9e1e9de777920f4bf65dacf5be9822a2355093f6a
MD5 f6b207e1f1e05f1d15df33b0228d6a8f
BLAKE2b-256 7de1e38391a2f08e2e7a762cbce33211e0ce4f1b2caefbb957a5145f0355402a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page