# Show HN: Agentic FC – a football management SIM played by AI agents over MCP

> Source: <https://github.com/gaemi/agentic-fc>
> Published: 2026-07-09 10:28:47+00:00

Agentic FC is a football management simulation designed to be **played by AI
agents through MCP** and **watched by humans through a terminal console**.

Instead of clicking through menus, an agent shapes the Mindset of an autonomous in-game Manager. The Manager runs a club continuously: reading the world, making probabilistic football decisions, reacting to news, transfers, injuries, board pressure, and matches, and leaving an auditable history behind.

The project is written in Go and currently ships three commands:

`agenticfc`

: core daemon, simulation loop, Console API, and MCP gateway.`agenticfc-console`

: Bubble Tea TUI for spectators and operators.`agenticfc-calibrate`

: deterministic match-model calibration reports.

Agentic FC is under active development. The core loop is playable: worlds are seeded and persistent, seasons roll forward, league and cup matches resolve, managers keep careers, players age and move through contracts/markets, and MCP agents can observe and shape their Manager through a Focus-limited tool surface.

The public API and save format may still change before a stable release.

**AI-first management**: agents use MCP tools to observe, plan, and shape a Manager's Mindset rather than issuing every individual click.** Living seeded worlds**: the seed fixes the initial world; future history is produced by current state, queued events, ordered inputs, and labelled RNG.**Football simulation**: key-moment match engine, tactical chance types, player attributes, injuries, substitutions, discipline, form, careers, contracts, youth intake, transfer market, board confidence, and sackings.**Human spectator console**: a full-screen TUI with media desk, league table, club dossiers, fixtures/results, live ASCII pitch, commentary, replay logs, and public match diagnostics.**Determinism-first engineering**: same seed, config, and input log should reproduce the same world trajectory. Randomness is routed through internal RNG streams and accepted MCP inputs are logged.**Visibility boundaries**: MCP is the play surface and exposes only public or scoutable football information. Hidden traits and exact formulas stay inside the simulation.**Multilingual-ready presentation**: human-facing text flows through locale catalogs and message keys; the current supported catalogs are English and Korean.

Requirements:

- Go 1.26 or newer
- A terminal with UTF-8 support

Build everything:

```
make build
```

Start a new compact world and run immediately:

```
./bin/agenticfc \
  -data ./data \
  -preset compact \
  -profile fast \
  -seed 42 \
  -start
```

Open the spectator console in another terminal:

```
./bin/agenticfc-console -server http://127.0.0.1:7420
```

The daemon also starts an MCP Streamable HTTP endpoint at
`http://127.0.0.1:7421`

. Manager tokens are written to
`./data/manifest.json`

; use one as the bearer token when connecting an MCP
client.

Run a match-model calibration sample:

```
./bin/agenticfc-calibrate -seeds 1,2,3,4,5 -days 365
make fmt      # gofmt
make verify   # format check, vet, build, test, docs/workflow checks
make security # govulncheck and gitleaks
make ci       # verify + security
make vet      # go vet ./...
make test     # go test ./...
make build    # builds all packages and bin/ commands
```

Direct Go equivalents also work:

```
go test ./...
go vet ./...
go build ./...
```

CI also checks formatting, Markdown links, Go vulnerability reports, secret patterns, and cross-platform builds.

Maintainers can create draft GitHub Releases with the manual `draft-release`

workflow. See [docs/13-operations.md](/gaemi/agentic-fc/blob/main/docs/13-operations.md) for the versioning
and packaging policy.

Start with [docs/README.md](/gaemi/agentic-fc/blob/main/docs/README.md).

Key documents:

[Concept](/gaemi/agentic-fc/blob/main/docs/01-concept.md)[Game Introduction](/gaemi/agentic-fc/blob/main/docs/15-game-introduction.md)[Game Design](/gaemi/agentic-fc/blob/main/docs/02-game-design.md)[Simulation Engine](/gaemi/agentic-fc/blob/main/docs/03-simulation-engine.md)[Agent Interface](/gaemi/agentic-fc/blob/main/docs/04-agent-interface.md)[Architecture](/gaemi/agentic-fc/blob/main/docs/05-architecture.md)[Console Design](/gaemi/agentic-fc/blob/main/docs/07-console-design.md)[Attribute Model](/gaemi/agentic-fc/blob/main/docs/08-attributes.md)[World Generation](/gaemi/agentic-fc/blob/main/docs/09-world-generation.md)[Mindset Schema](/gaemi/agentic-fc/blob/main/docs/10-mindset-schema.md)[MCP Tools](/gaemi/agentic-fc/blob/main/docs/11-mcp-tools.md)[Match Model](/gaemi/agentic-fc/blob/main/docs/12-match-model.md)[Operations Guide](/gaemi/agentic-fc/blob/main/docs/13-operations.md)[Roadmap](/gaemi/agentic-fc/blob/main/docs/99-roadmap.md)

```
cmd/agenticfc/             core daemon
cmd/agenticfc-console/     spectator TUI
cmd/agenticfc-calibrate/   match calibration CLI
internal/engine/           single-writer simulation engine
internal/worldgen/         world config, generation, world state
internal/mcpserver/        MCP gateway and play surface
internal/consoleapi/       HTTP/SSE API for the TUI
internal/tui/              Bubble Tea console
internal/narrative/        message catalogs and rendering
docs/                      public design and operating docs
```

Contributions are welcome. Read [CONTRIBUTING.md](/gaemi/agentic-fc/blob/main/CONTRIBUTING.md) before
opening an issue or pull request.

Important project rules:

- Keep docs and code in sync.
- Preserve deterministic simulation behavior.
- Do not expose hidden attributes or exact private formulas through MCP, Console API, logs, or UI.
- Add entries for every currently supported locale catalog when introducing new human-facing text.
- Register gameplay tunables in
[docs/98-tunables.md](/gaemi/agentic-fc/blob/main/docs/98-tunables.md).

Do not publish real Manager/Admin tokens from local worlds. See
[SECURITY.md](/gaemi/agentic-fc/blob/main/SECURITY.md) for supported reporting channels and the security
model.

Agentic FC is licensed under the [MIT License](/gaemi/agentic-fc/blob/main/LICENSE).
