ffxiai
A Windower 4 addon for Final Fantasy XI that lets your AI assistant see your game.
Install / Use
claude mcp add mattwells -- npx -y github:mattwells/ffxiaiIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Tags
Our assessment of ffxiai
ffxiai scores 71/100 on our quality scale, 861st of 944 AI & Machine Learning skills we index.
Its MCP Server is 6.6 KB long, well organised into 12 sections and no code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 11 days ago, so ffxiai is actively maintained.
- Our last check on 2026-11-12 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 87/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-13. Automated pattern scan on 2026-11-13. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
ffxiai compared with similar skills
All 4 of these similar skills score higher than ffxiai; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| ffxiai (this skill)by mattwells | 71 | 3 | 11d ago | MCP Server |
| claude-memby thedotmack | 100 | 118.5k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 93.3k | 1d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 87.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install ffxiai?
- Run
claude mcp add mattwells -- npx -y github:mattwells/ffxiai. The install tabs above show the steps for each supported agent. - Which AI agents does ffxiai work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is ffxiai safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 87/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is ffxiai still maintained?
- The repository was last updated 11 days ago, so ffxiai is actively maintained.
Skill content
View source on GitHubFFXI-AI
A Windower 4 addon for Final Fantasy XI that lets your AI assistant see your game. Ask things like:
- "What's in my Mog Safe? Do I have any Hi-Potions anywhere?"
- "Who in my party is low on MP?"
- "What am I wearing, and what augments are on it?"
- "How long until Convert is back up?"
- "What did my linkshell just say?"
It is read-only: it reads what your game client already knows, and it never sends anything to the game server unless you turn on requests.
Technically it's an MCP server (Model Context Protocol, the standard way AI apps connect to tools), so it works with Claude, ChatGPT and other MCP apps.
Install
- Put this folder in
Windower/addons/so the files are atWindower/addons/ffxiai/ffxiai.lua. - In game:
//lua load ffxiai. To load it every time, addlua load ffxiaitoWindower/scripts/init.txt.
If you play several characters at once, load it on each of them. They all work together, and the AI can see every one.
Connect your AI app
This only works with an AI app installed on the PC that's running the game. The web versions, such as claude.ai or chatgpt.com in a browser, and the phone apps can't reach it.
Claude desktop app
- Download FFXI-AI.mcpb. It's also in the addon folder if you downloaded the whole addon.
- In the Claude app, open Settings → Desktop app, scroll to the bottom, and click Manage next to Extensions. Drag the file onto that page. (Or click Advanced settings → Install Extension… there and pick the file.) Click Install when Claude asks.
- Start the game with FFXI-AI loaded, then ask Claude about your characters.
You don't need to install anything else, and nothing needs typing. If Claude was open before the game, it picks up the tools once the game is running. If it doesn't, restart Claude.
ChatGPT desktop app
Open Settings → Plugins → Add → Add MCP server, choose Streamable HTTP, and enter:
- Name:
FFXI-AI - URL:
http://127.0.0.1:19750/mcp
Other apps
Add an MCP server with the address http://127.0.0.1:19750/mcp. Apps call this "HTTP" or "Streamable HTTP". The address only works on the PC running the game.
What the AI can see
| Tool | What it reads |
|---|---|
| list_characters | Every character running the addon: job, zone, status, HP/MP, TP |
| get_player | Jobs and levels, HP/MP/TP, status, buffs and debuffs with time left, every job's level |
| get_target | Target, sub-target, battle target and pet: HP %, distance, who has claim |
| get_party | Party and alliance: HP/MP, TP, zone, distance, leader |
| get_inventory | A bag's items, counts and augments, plus gil. Can search every bag and storage slip, optionally by whole word |
| get_equipment | What's in each slot, which bag it's from, augments, path and rank |
| get_recasts | Abilities and spells on cooldown |
| get_location | Zone, position, weather, Vana'diel time and day, moon, server |
| get_merits | Merit points and limit points, merits spent, and per job: capacity points, job points and categories |
| get_currencies | Both Currencies pages (Sparks, Bayld, seals, beads, Gallimaufry and so on), with how old they are |
| get_skills | Combat and magic skills, and crafting levels and ranks, with whether each is capped |
| get_stats | STR, DEX and the rest (base and from gear), attack, defense, resistances, EXP, Master Level, title, nation rank, Unity |
| get_job_setup | Blue magic set; automaton head, frame, attachments, skills and stats; or Monstrosity species |
| get_treasure_pool | What's in the treasure pool, how long is left and the highest lot |
| get_nearby | Monsters, players or NPCs nearby, nearest first, with HP, distance and who has claim |
| get_missions | Mission progress in every storyline, from the nations to The Voracious Resurgence: current mission, finished or not, and every mission's status. The game sends this when you zone |
| get_quests | Quest progress in every area (the nations, Jeuno, Other Areas, Outlands, Aht Urhgan, Crystal War, Abyssea, Adoulin, Coalition): counts, what's in progress, and each quest's status. Searchable by name. Also sent when you zone |
| lookup | Game data from Windower's resources: item stats, spells, abilities, weapon skills, buffs, key items, job traits, zones. Can search item descriptions and limit results to what a character has |
| get_chat | Recent chat, only if you turn it on |
With several characters logged in, the AI picks one by name or asks all of them at once.
Chat
Chat reading is off by default. Settings are per character:
//ffxiai chat onlets the AI read chat received from then on (the last 200 lines).//ffxiai tells onalso includes tells, which stay out otherwise.
Turning chat off clears what was kept.
Requests to the game server
The game server doesn't send some information until you open a menu for it. Currencies are the main example: your Sparks, seals, Bayld and so on only reach your game when you open Menu → Profile → Currencies (or Currencies 2). Each page arrives separately.
With requests off (the default), FFXI-AI never sends anything to the game server. When you ask about currencies, it shows what the game sent the last time you opened that menu, and how long ago that was. If you haven't opened the menu since logging in, there's nothing to show yet.
//ffxiai requests onlets FFXI-AI get current values itself. It sends the same request the game sends when you open the menu. It only asks for information and never does anything in game.//ffxiai requests offturns it back off.
The setting is saved per character, like chat.
Checking on it
You shouldn't need to type anything. //ffxiai shows whether this character is hosting or connected, which characters are connected and how many requests the AI has made. //ffxiai log on prints connection events in the chat log.
If another program already uses port 19750, the addon says so once. Change port in data/settings.xml (in the global section), set the same port on every character and in your AI app, then reload.
Privacy
The server only listens on 127.0.0.1, so nothing else on your network can reach it. It rejects requests from web pages and from any address that isn't local.
Credits
Mission names, quest titles and how to read the game's quest and mission log come from Chronicle by Jintawk, a quest and mission tracker for Windower. missions.lua and quests.lua are copies of Chronicle's mission and quest name tables and keep its copyright notice.
Related Skills
claude-mem
118.5kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
113.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
93.3kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
hyperframes
87.1kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
