Dalamud plugin · Model Context Protocol
An MCP server inside FFXIV
A Model Context Protocol server inside the game. AI clients on your machine, such as Claude Code, Codex or Almanac, can look up items, read your location and inventory, and flag your map. Anything that would change your game waits for your approval, in game.
The plugin builds against Dalamud API 15, and the MCP runtime and the logic that needs no game (approval service, chat rules, IPC payloads, map maths) have host-side tests. The plugin has not yet been observed running in the game: treat the in-game behaviour described here as the design, not as verified results. It has a stable release (v0.1.0) and a newer test build.
MCP is the protocol AI clients use to call tools. XivMcp is an MCP server that lives inside the game client as a Dalamud plugin and listens on loopback (http://127.0.0.1:41800/mcp), protected by a bearer token it generates on first load. Under Wine, loopback inside the game is the host's loopback, so a client on the same machine connects directly.
The v0.1.0 release offers 86 tools, 14 resources and templates and 6 prompts (the v0.1.1 test build: 155, 19 and 10): searching game data (items, recipes, quests, duties, actions, any Excel sheet), reading your character, inventory, party, location, weather forecast and chat, and local-only effects such as map flags, toasts and an in-game board where agents post what they are doing.
Combat rotations, movement and input automation of any kind are out of scope, by design.
Everything below is built; none of it has been observed in game yet. The server-side logic is covered by host tests.
Read and Ui are on by default. Action (targeting, gearsets, teleport, slash commands) and Chat (text other players can see) are off until you turn them on. A disabled tier is hidden from the client and rejected on call.
unverified in gameEach Action or Chat call waits for a confirmation window showing the tool, the client and its arguments: Allow, Deny, or Allow this tool for 10 min. Unanswered calls are denied after 20 seconds.
unverified in gameItems, recipes, quests, duties and actions by name, ranked; any Excel sheet by row. Works at the title screen.
unverified in gamePlayer, target, job gauge and levels, equipment, inventory, retainers, currencies, party, collections, quest progress, aetherytes, nearby objects and FATEs.
unverified in gameAgents call post_status to show progress bars inside your game, with a notification when one finishes or fails.
Binds 127.0.0.1. Any other host is shown with a red warning, and the server refuses to start on a non-loopback host without a token. Cross-origin browser requests are refused.
tools/claude-mcp-add.sh registers it with Claude Code through a helper that reads the token at connect time, so the token is never printed or stored in the client's config.
An optional Umbra toolbar widget with server status and the agent board.
unverified in gamePlanned shots. Empty frames are placeholders for screenshots and clips that will be captured in game.
Loading the shot list…
Two ways, and both are kept on purpose: one click from the plugin repository, or build it from source and load it as a dev plugin.
Add the repository once; every mod here installs and updates like any other plugin.
https://spacegho.st/mods/ffxiv/plugins.json
/xlsettings → the Experimental tab./xlplugins → All Plugins → search XivMcp → Install.XivMcp has a stable release, so it shows under All Plugins straight away. For the newer test build ahead of the next release, tick Get plugin testing builds in the same tab, then Receive plugin testing versions on its entry.
Dalamud will warn you that this is a third-party repository nobody but its author has reviewed. That is true. The repository page says more, including how test builds work.
The dev plugin path: exactly the code in your checkout, no repository, no auto-update. It is how the author runs it, and the honest way to read the code before you trust it.
git clone https://github.com/Spaceghost/xivmcp-dalamud
cd xivmcp-dalamud
tools/install-dev.sh # or: dotnet build XivMcp.slnx -c Releasetools/install-dev.sh (Linux) builds Release, stages it outside the checkout so Dalamud never sees a half-written build, and prints the Wine path. It never edits Dalamud's configuration./xlsettings → Experimental → Dev Plugin Locations → add the path of the built XivMcp.dll (under Wine, a Z:\… path) → + → Save and Close./xlplugins → Dev Tools → Installed Dev Plugins → enable XivMcp. Dev plugins are added disabled.If you later switch to the one-click install, disable the dev plugin first so the two copies cannot fight over the same name. The README has the details.
mcpServers block.Screenshots of XivMcp shared by players. Every one is reviewed by the site owner before it is shown here. Every mod's are in the gallery, and what XivMcp should do next is up for a vote.
Loading…
Sharing a screenshot needs a sign-in, so that everything sent to this site comes from an account.
Signing in with FFXIV needs an XIVAuth account and shares no character.
Hide your own name and chat first, and never share a terminal showing tokens or private paths. Metadata is stripped from the image before it is stored. Your upload is linked to your GitHub or XIVAuth account id, which the site owner can see; the public sees only the image and the credit you typed. To have a shot removed, contact the owner through github.com/Spaceghost.