Stellaris Companion MCP

Talk to Your Stellaris Save in Claude Desktop or Codex.

Stellaris Companion MCP brings your local campaign briefing into Claude Desktop, Codex, and other MCP clients, so they can answer strategy questions, draft AARs, and help write your empire's Chronicle.

Download Stellaris Companion How It Works
What It Does

A briefing Claude can actually use.

Stellaris Companion MCP is a local server that gives Claude Desktop structured campaign context from your Companion archive: current empire state, recent events, strategy briefing data, and Chronicle material.

Strategy

Ask what to fix next, from economy to wars.

AARs

Draft session recaps and after-action reports.

Chronicle

Write, revise, then save final prose back to Companion.

Setup Guides

Set up Stellaris Companion MCP.

Choose your AI client, copy the right setup from Stellaris Companion, then ask it to use your campaign briefing.

Claude Desktop

How to connect Stellaris Companion MCP to Claude Desktop

Claude Desktop has the fastest setup path because Stellaris Companion can install the local MCP relay configuration for you.

  1. 01

    Open Stellaris Companion and load a campaign

    Choose the campaign you want Claude to understand, then open Settings.

  2. 02

    Run the MCP Relay check, then install Claude

    In the MCP Relay panel, run the health check and click Install Claude.

  3. 03

    Restart Claude Desktop and ask for your briefing

    Restart Claude Desktop, open a new chat, and start with: "Use Stellaris Companion."

Codex

How to use Stellaris Companion MCP with Codex

Codex can use the same local campaign briefing through the Codex setup command in Stellaris Companion.

  1. 01

    Open Settings and find MCP Relay

    Load your campaign, open Settings, and confirm the MCP Relay health check passes.

  2. 02

    Copy the Codex setup command

    Use the Codex setup action from the MCP Relay panel to copy the local MCP command.

  3. 03

    Add the command to Codex and ask for context

    Add the command to your Codex MCP configuration, then ask Codex to use Stellaris Companion.

Cursor / Claude Code

How to use MCP with Cursor or Claude Code

Cursor, Claude Code, and similar local MCP clients can use the generic MCP configuration from Stellaris Companion.

  1. 01

    Copy the generic MCP configuration

    Open Settings, find the MCP Relay panel, and copy the generic local MCP JSON.

  2. 02

    Add it as a local MCP server

    Paste the configuration into Cursor, Claude Code, or another compatible local MCP client.

  3. 03

    Reload the client and request the campaign briefing

    Restart or reload the client, then ask it to use Stellaris Companion for your current campaign.

Questions

Common questions.

The practical bits: Claude setup, Codex support, ChatGPT limits, and what never touches your save file.

What is Stellaris Companion MCP?
Stellaris Companion MCP is a local MCP server for Stellaris Companion. It gives Claude Desktop, Codex, and compatible local MCP clients structured campaign context from your Companion archive, including current empire state, recent events, strategy briefing data, and Chronicle material.
Can I use Claude Desktop with Stellaris?
Yes. Stellaris Companion MCP lets you use Claude Desktop with Stellaris by connecting Claude to your local Companion campaign briefing. You can ask for strategy advice, review recent events, draft AARs, and work on your empire's Chronicle.
How do I install the Claude MCP relay?
Setup is built into Stellaris Companion. Open the app, go to Settings, run the MCP Relay health check, click Install Claude, restart Claude Desktop, and start a chat with: "Use Stellaris Companion."
What does Stellaris Companion give Claude?
Stellaris Companion gives Claude a structured local briefing rather than a raw save file. The briefing can include your current campaign state, economy, fleets, diplomacy, recent events, strategy context, and Chronicle source material.
Can I use Stellaris Companion MCP with Codex?
Yes. Stellaris Companion MCP also works with Codex and other local MCP clients. Copy the Codex setup command from Settings to connect the same local Stellaris campaign context.
Which other MCP clients can use it?
The local MCP relay is designed for Claude Desktop, Claude Code, Codex, Cursor, and other compatible local MCP clients. Claude Desktop has the easiest setup path; other clients usually use the copied MCP configuration or command from Settings.
Can I use this with ChatGPT?
ChatGPT web does not currently support this local MCP workflow. Stellaris Companion MCP is built for Claude Desktop, Codex, and compatible local MCP clients. If ChatGPT adds local MCP support in the future, the same local server standard should be a good fit.
Is my Stellaris save file uploaded?
No. The relay reads the local Stellaris Companion archive and shares structured campaign context with the MCP client you choose. It does not upload raw Stellaris save files through a cloud relay.
Can Claude edit my Stellaris save?
No. Claude cannot edit your Stellaris save file through Stellaris Companion MCP. Chronicle save-back only updates Companion's local Chronicle cache, and only after you explicitly tell the AI to save the final draft back to Stellaris Companion.
Can this help write Stellaris AARs and Chronicles?
Yes. Stellaris Companion MCP can give Claude or Codex Chronicle source material from your campaign, making it useful as a Stellaris AAR generator or Stellaris Chronicle generator. You can revise the writing in chat, then save the finished Chronicle text back to Companion when ready.