Spaceghost/xivmcp-dalamud:为《最终幻想14》提供 MCP 工具集
Spaceghost/xivmcp-dalamud
Spaceghost/xivmcp-dalamud 是一个面向《最终幻想14》的 MCP 工具集,提供装备套装、热键栏、宏、目标、传送等游戏内操作,以及审批票据、Laya 决策模型查询和 XivDesktop、XivHud、GhosttyDalamud 等桥接状态读取。工具按 Read、Action、Ui 等层级划分,Action 类操作需玩家审批后才执行。
list_gearsets
Read
actions
yes
—
—
Lists the character's saved gear sets.
list_hotbars
Read
actions
yes
—
—
What is on the player's hotbars for the current job, as the HUD shows them. bars: standard (hotbars 1-10, 12 slots), cross (cross hotbar sets 1-8, 16 slots), pet, petCross, or all; number picks one standard/cross bar.
list_macros
Read
actions
yes
—
—
Lists the user's macros from the in-game User Macros window: set individual (this character) or shared (all characters on the account), 100 slots each.
clear_macro
Action
actions
yes
yes
—
Empties one User Macros slot (set individual or shared, index 0-99): title, icon and lines are removed, as with Delete in the User Macros window.
clear_target
Action
actions
yes
yes
—
Clears the user's current target (like pressing Escape on a target).
equip_gearset
Action
actions
yes
yes
—
Equips one of the character's saved gear sets (which also changes class/job when the set belongs to another job), exactly like /gearset change.
set_focus_target
Action
actions
yes
yes
—
Sets the user's focus target (the secondary tracked target shown in the Focus Target bar), or clears it with clear=true.
set_target
Action
actions
yes
yes
—
Sets the user's current target, like clicking an object.
target_party_member
Action
actions
yes
yes
—
Targets one member of the user's own party, like clicking their row in the party list.
teleport
Action
actions
yes
yes
—
Starts the Teleport spell to one of the character's attuned aetherytes (or free-company/private estate and apartment entries), exactly like choosing it in the Teleport window.
write_macro
Action
actions
yes
yes
—
Writes one slot of the User Macros window, replacing whatever is in it: set individual (this character) or shared (all characters), index 0-99 as in list_macros, title (at most 20 characters), optional iconId (an icon…
laya_query
Read
ai
no
—
—
Ask the local Laya typed-decision model one or more typed questions about supplied state.
get_ticket
Read
approvals
no
—
—
Returns one of your approval tickets: state (pending, approved, executed, failed, denied, cancelled, expired), who decided, your resumeToken, and once it ran the tool result (result, same shape as a tools/call result)…
list_tickets
Read
approvals
no
—
—
Lists your approval tickets, oldest first. state filters: open (pending or approved, the default), pending, final, all.
cancel_ticket
Ui
approvals
no
—
—
Withdraws one of your pending tickets so the player is no longer asked about it.
request_action
Ui
approvals
no
—
—
Files an Action- or Chat-tier tool call (e.g. teleport, execute_command, send_chat) as an approval ticket and returns immediately with its id and state pending; nothing runs until the player approves it in the XivMcp…
desktop_query
Read
bridges
no
—
—
Reads XivDesktop's view of the host desktop. method is status (bridge health), windows (open windows with id, title, app, workspace, focused), apps (launchable applications) or palette (ranked command-palette entries…
get_almanac_benchmark
Read
bridges
no
—
—
For a runId from run_almanac_benchmark: its progress (state, done, total, currentTask) while it runs, or once done the results summary (score, successRate, toolCallValidity, tokensPerSecond, ttftMs and per-task rows).…
get_almanac_model_status
Read
bridges
no
—
—
Which model answers in Almanac: setupComplete, model, source, baseUrlHost (host and port only, never a key), toolMode, xivMcpLinked (whether it uses this XivMcp server for tools), busy; plus backends (each model serve…
get_almanac_status
Read
bridges
no
—
—
Whether Almanac (the in-game assistant plugin) is installed, loaded and answering IPC, its ApiVersion, whether ask_almanac can work (askGate) and whether it offers the JSON call gate the thread, turn, benchmark and mo…
get_almanac_thread
Read
bridges
no
—
—
The turns of one Almanac conversation (role, text capped at 8000 characters, state, tools called, time), newest last.
get_almanac_turn
Read
bridges
no
—
—
The state of one Almanac turn (queued|running|done|failed) and its answer text so far, by the threadId and turn ask_almanac returned.
get_bridge_state
Read
bridges
no
—
—
Reads one bridge's read-only IPC gates and returns each as {field, description, value, error}: for Penumbra the enabled state, mod list and collections; for Glamourer the saved design list; for Lifestream/AutoRetainer…
get_desktop_panels
Read
bridges
no
—
—
What the player currently sees in XivDesktop: the launcher (open, search text, view, category, page, selected and visible app ids), favourites in order, whether the palette is open and the assistant's state (summoned,…
get_desktop_status
Read
bridges
no
—
—
XivDesktop's health: ghostty (launching is possible), ghosttyStatus, apps (catalogue size), scanning, scannedAt, lastLaunch, lastError, summary, plus apiVersion (null until XivDesktop offers an ApiVersion gate).
get_hud_family_status
Read
bridges
no
—
—
Read all XivHud modules independently: installed/loaded versions, versioned IPC capabilities, native HUD requested/applied visibility, Journal selection/search/bookmarks, Character page, data readiness, requested vers…
get_hud_module_status
Read
bridges
no
—
—
Read one XivHud module's capabilities and immutable state snapshot, including window hosting, UI selection, controller focus and data errors.
get_hud_request
Read
bridges
no
—
—
Poll a HUD module request by requestId.
get_terminal_capture_status
Read
bridges
no
—
—
Whether GhosttyDalamud is recording, and its last screenshot or clip (kind, path, size, time, error).
get_terminal_layout
Read
bridges
no
—
—
The current arrangement of GhosttyDalamud panels as a layout description: per panel its view, pet order and, where the snapshot allows, the pin argument that would put a panel there again (pin, for place_terminal_pane…
get_terminal_layouts
Read
bridges
no
—
—
GhosttyDalamud's saved, named layouts (panels with kind, profile or run/match, view, exact pin arguments, order, size) and which is current; name narrows to one.
get_terminal_leakwatch_report
Read
bridges
no
—
—
GhosttyDalamud's leak watch: memory samples per core load and the growth per load.
get_terminal_request
Read
bridges
no
—
—
The outcome of a queued GhosttyDalamud change, by the request id a terminal tool returned: state done (with result, e.g. {id: panel}), failed (with GhosttyDalamud's error text) or unknown (not run yet, or no longer am…
get_terminal_selftest_report
Read
bridges
no
—
—
GhosttyDalamud's last self-test report (build stamp, per-suite pass/fail/skip counts, failed cases) and whether a run is in progress.
get_terminal_status
Read
bridges
no
—
—
GhosttyDalamud's health in one call: status (its one-line text, e.g. "ghostty 3"), agent (the desktop agent that streams windows: connected, version, windows_ok, agent address, window_lists), focus (the world panel wi…
ghostty_query
Read
bridges
yes
—
—
Reads GhosttyDalamud's state over IPC. method is one of: window.list (every terminal panel with id, title, app, size, state, kind, anchor, hidden, focused, plus the last request results), agent.status, agent.windows,…
list_almanac_benchmarks
Read
bridges
no
—
—
Earlier benchmark runs, newest first: runId, mode, model, finishedAt, score, successRate, state.
list_almanac_threads
Read
bridges
no
—
—
Almanac's conversations, newest first: id, title, turns, updatedAt and which is current.
list_bridges
Read
bridges
no
—
—
Every other Dalamud plugin XivMcp can read through IPC, with installed, loaded, version, ipcAvailable, apiVersion and (when it cannot be used) unavailable explaining why — not installed, not loaded, or the plugin's IP…
list_desktop_apps
Read
bridges
no
—
—
The applications XivDesktop can launch on the player's computer, filtered and paged here: id (the desktop-file id launch_desktop_app takes), name, generic name, categories, favourite, terminal (runs in a terminal), la…
list_desktop_windows
Read
bridges
no
—
—
The desktop windows shown as panels in game, as XivDesktop tracks them: available (GhosttyDalamud's call gate is there), rev, workspace (current, 1-9), target (the window id actions without an id apply to) and windows…
list_terminal_panels
Read
bridges
no
—
—
Every GhosttyDalamud panel, oldest first: terminals (in the dropdown, floating, minimized or in the world), remote desktop windows, adopted plugin windows and the chat.
list_terminal_themes
Read
bridges
no
—
—
The theme names set_terminal_theme accepts and the current one.
search_desktop_palette
Read
bridges
no
—
—
XivDesktop's command-palette ranking for a query (at most 10): applications, open windows, actions, calculator results and commands, each with provider, title, subtitle, score, enabled/reason and the command running i…
apply_terminal_layout
Action
bridges
yes
yes
—
Applies a saved layout by name: existing panels move to their saved places and missing ones are opened (which may start the programs the layout names); nothing is closed.
ask_almanac
Action
bridges
no
yes
—
Hands a question to Almanac: its chat window opens on the player's screen and its configured model (possibly a remote service) starts answering.
ask_npc_assistant
Action
bridges
no
yes
—
What follows XivDesktop's /ask: a question (summons the speaker if needed and asks it), "" (only summon), "bye" (dismiss), or "as <preset|npc:ID|minion:ID|mount:ID|pet:ID|self> [question]" to switch speaker first.
bookmark_hud_quest
Action
bridges
yes
yes
—
Set or remove a local XivHud Journal bookmark for an accepted quest.
capture_terminal_clip
Action
bridges
yes
yes
—
Asks GhosttyDalamud to record a short clip (1-30 seconds, gif or mp4) of the game frame, or of the focused panel only, optionally with the game's own UI hidden.
capture_terminal_screenshot
Action
bridges
yes
yes
—
Asks GhosttyDalamud for a PNG of the frame the game just drew, including its world panels: target full (the whole frame) or panel (just the focused terminal's window); clean=true hides the game's own UI for that frame.
close_terminal_panel
Action
bridges
yes
yes
—
Closes a panel as its close button does (panel.close): a terminal's shell and every program in it END, a remote window's stream stops, an adopted plugin window goes back to its plugin and the chat back to the game.
control_hud_window
Action
bridges
no
yes
—
Explicit HUD UI operation: open, close, settings, original, or mode. hud supports settings/close only; Journal/Character support every operation. mode selects screen, native_frame (KamiToolKit), or world (optional Gho…
desktop_command
Action
bridges
no
yes
—
Acts on the host desktop through XivDesktop. method launch starts an application (argument: the app id or a search text); method window sends a window action (argument: JSON such as {"action":"focus","id":12} — action…
desktop_window_action
Action
bridges
no
yes
—
One action on a desktop window panel: focus, close (closes the window's stream and panel), pet (make it a pet), pin (pin it where the character stands), toggle (pet ↔ pin in place), place (needs pin, as /term pin take…
focus_terminal_panel
Action
bridges
yes
yes
—
Gives a panel the keyboard and brings it forward (panel.focus): a hidden panel is shown, a dropdown tab opens the dropdown, a minimized terminal is restored.
ghostty_command
Action
bridges
yes
yes
—
Changes a GhosttyDalamud terminal panel. method is one of: window.open (params: run | match | wid, optional pin such as "here", "me 2 1.7", "target", "orbit 3.5", "hud X Y", "pet"), window.close {id}, window.focus {id…
launch_desktop_app
Action
bridges
no
yes
—
Starts an application on the player's computer through XivDesktop and shows its window as a panel in game. app is a desktop-file id from list_desktop_apps ("org.gnome.TextEditor", with or without ".desktop") or search…
open_terminal
Action
bridges
yes
yes
—
Opens a new GhosttyDalamud panel in the game world.
order_terminal_panel
Action
bridges
yes
yes
—
Moves a pet panel within the lineup beside the character (panel.order): to is "left" or "right" (swap with that neighbour), "first", "last" or a place from 1.
place_terminal_panel
Action
bridges
yes
yes
—
Moves a panel (panel.place): pin is "pet", "here" (fixed where the character stands), "me 2 1.7", "target", "orbit 3.5", "hud [X Y [DIST]]" (docked to the screen, X/Y as 0..1 fractions from the top left), "hide" or "h…
rescan_desktop_apps
Action
bridges
no
yes
—
Starts XivDesktop's background scan of installed applications so a newly installed one appears in list_desktop_apps; get_desktop_status shows scanning and scannedAt.
run_almanac_benchmark
Action
bridges
no
yes
—
Starts Almanac's model benchmark: mode mock (no model is called; checks the harness) or live (the model answers every task, which takes minutes and, with a paid remote model, costs money). model overrides the configur…
run_terminal_selftest
Action
bridges
yes
yes
—
Starts GhosttyDalamud's own in-game checks ("/term selftest SUITES"): suites is "all", "list" or suite names separated by spaces.
select_hud_quest
Action
bridges
yes
yes
—
Open the illustrated Journal on an accepted quest, clearing its UI search/filter to reveal the selection.
set_hud_character_page
Action
bridges
yes
yes
—
Open the illustrated Character record on Equipment, Attributes, ClassesAndJobs or GearSets.
set_hud_enabled
Action
bridges
no
yes
—
Explicitly enable XivHud's reversible native HUD suppression or restore the game HUD.
set_terminal_panel_hidden
Action
bridges
yes
yes
—
Hides or shows a world panel (window.hide): hidden panels are neither drawn nor streamed, lose the keyboard and sleep; hidden=false shows it again where its anchor puts it.
set_terminal_theme
Action
bridges
no
yes
—
Switches the colours of the terminals and the glass around them to a named theme and saves it, as "/term theme NAME" does (names may contain spaces, e.g. "Gruvbox Light").
share_terminal_capture
Action
bridges
yes
yes
—
Uploads one screenshot or clip from GhosttyDalamud's capture folder to its online gallery and returns the link (result.url). path is a file path from get_terminal_capture_status, or "last" for the most recent capture.
show_hud_quest_on_map
Action
bridges
yes
yes
—
Ask the Journal's existing native map handoff to show an accepted quest, closing the illustrated Journal.
switch_desktop_workspace
Action
bridges
no
yes
—
Switches XivDesktop's current workspace (1-9): window panels assigned to other workspaces are hidden, this one's are shown.
get_attributes
Read
character
yes
—
—
Every attribute the client tracks for the logged-in character, as {baseParamId, name, value} — including the crafter and gatherer stats an agent needs before planning a craft: craftsmanship, control, CP, gathering, pe…
get_character_sheet
Read
character
yes
—
—
One condensed snapshot for 'summarise my character': identity (name, home world and data center, title, grand company and rank, free company tag), job (abbreviation, name, role, level, synced level, max HP/MP), attrib…
get_conditions
Read
character
no
—
—
The game's condition flags (what state the client is in).
get_enmity_list
Read
character
yes
—
—
The HUD's enmity information, as a one-off snapshot. enemies: the on-screen enemy list in display order {position, name, entityId, enmityPercent (the player's own enmity on that enemy; 100 = it is attacking the player…
get_job_gauge
Read
character
yes
—
—
The current job's gauge (the job-specific resource UI: e.g. PLD oath, WAR beast gauge, BLM astral fire/umbral ice and polyglot, SAM sen/kenki, VPR rattling coils/serpent offerings, PCT palette/canvas/motifs).
get_job_levels
Read
character
yes
—
—
Every combat class/job, crafter and gatherer with the logged-in character's level and experience.
get_player
Read
character
yes
—
—
Snapshot of the logged-in player character.
get_target
Read
character
yes
—
—
What the player is targeting.
read_chat
Read
chat
no
—
—
Returns chat lines the plugin has captured since it loaded (not older history), oldest first.
print_echo
Ui
chat
yes
—
—
Prints a line into the user's OWN chat log only (tagged [MCP]); nobody else can see it and nothing is sent to the server.
execute_command
Action
chat
yes
yes
—
Runs one slash command as if the user typed it into the chat box, e.g. "/gearset change 3", "/hudlayout 2", "/xlplugins" or another installed plugin's command.
send_chat
Chat
chat
yes
yes
—
Sends one line of text that OTHER PLAYERS WILL SEE, on the chosen channel, exactly as if the user typed it into the chat box.
get_dalamud_info
Read
dalamud
no
—
—
Returns environment facts about this game client: dalamudVersion, dalamudApiLevel, dalamudScmVersion/gitHash/betaTrack when known, dalamudTrack (the beta track name, or "release" when Dalamud reports none), clientStru…
get_plugin_stats
Read
dalamud
no
—
—
Best-effort copy of Dalamud's Plugin Statistics window (/xlstats). draw: per loaded plugin the UI draw time in milliseconds (lastMs, averageMs over Dalamud's rolling window, maxMs), sorted by averageMs descending. fra…
get_troubleshooting_summary
Read
dalamud
no
—
—
A compact overview like the header of Dalamud's troubleshooting pack: dalamudVersion, dalamudTrack, dalamudApiLevel, gameVersion, clientLanguage, dalamudUiLanguage, hostPlatform and isWine, pluginSafeMode, installed/l…
get_ui_info
Read
dalamud
no
—
—
Returns how Dalamud draws plugin windows: globalScale (Dalamud's global UI scale, 1.0 = 100 %; not the game's HUD scale, which get_dalamud_info reports as globalUiScale), defaultFont (English description of the defaul…
list_plugin_repositories
Read
dalamud
no
—
—
Lists the custom (third-party) plugin repositories configured in Dalamud's settings (Experimental tab): url and enabled for each, in the configured order; Dalamud's own main repository is not part of this list.
list_plugins
Read
dalamud
no
—
—
Lists the Dalamud plugins installed in this game client.
read_plugin_log
Read
dalamud
no
—
—
Returns the newest matching entries of dalamud.log (Dalamud's and every plugin's log), oldest first so the newest is last.
open_dalamud_window
Ui
dalamud
no
yes
—
Opens one of Dalamud's own windows in front of the player: window='installer' (the plugin installer; tab is allPlugins, installedPlugins, updateablePlugins, changelogs or dalamudChangelogs) or window='settings' (Dalam…
open_plugin_ui
Ui
dalamud
no
yes
—
Opens the main window or the settings window of an installed, loaded Dalamud plugin, exactly like the buttons in the plugin installer (IExposedPlugin.OpenMainUi / OpenConfigUi). plugin is the internal name from list_p…
add_plugin_repository
Action
dalamud
no
yes
—
ASSISTED, not automatic: a custom repository can ship code that runs inside the game, so adding one is the player's supply-chain decision and this tool never writes Dalamud's configuration.
reload_plugin
Action
dalamud
no
yes
—
Unloads and loads again one installed, currently loaded Dalamud plugin (Dalamud's LocalPlugin.ReloadAsync, what a dev plugin's automatic reload uses): the same files are loaded again, nothing is downloaded or updated,…
set_plugin_enabled
Action
dalamud
no
yes
—
Enables (loads) or disables (unloads) an INSTALLED Dalamud plugin and records the choice the way the plugin installer's toggle does, so it persists across restarts: disabling unloads the plugin and then marks it not w…
get_duty_state
Read
duty
yes
—
—
Instanced-content status.
get_duty_unlocks
Read
duty
yes
—
—
Which Duty Finder duties this character has unlocked and cleared, as far as the client knows.
get_roulette_status
Read
duty
yes
—
—
Which Duty Finder roulettes have already given their daily completion bonus this reset.
get_events
Read
events
no
—
—
Polls the plugin's bounded stream of game events and returns them oldest first.
list_event_kinds
Read
events
no
—
—
The event kinds currently in the buffer with how many of each, plus the current cursor and the buffer size.
compare_items
Read
gamedata
no
—
yes
Compares 2-6 pieces of equipment from game data side by side: per item the itemLevel, equipLevel, category, jobs, materiaSlots, canBeHq, weapon damage / defence and every substat (critical hit, determination, direct h…
find_weather_windows
Read
gamedata
no
—
yes
When a wanted weather next occurs in a zone, in real time.
get_action
Read
gamedata
no
—
yes
Details for one action id: name, tooltip description (plain text; dynamic values such as potency may appear as placeholders), icon, class/job and which classes/jobs can use it, level acquired, category (Spell, Weapons…
get_duty
Read
gamedata
no
—
yes
Details for one duty (ContentFinderCondition id): name, description, content type, required level and item level, level/item-level sync, party size and role composition (tanks/healers/dps per party, number of parties)…
get_duty_unlock
Read
gamedata
no
—
yes
How to unlock one duty (ContentFinderCondition id from search_duties): required level and item level, level and item-level sync, expansion, and unlockQuests: each quest the game data ties to the duty (its unlock crite…
get_gathering_info
Read
gamedata
no
—
yes
Where a gatherable item is found and, for timed nodes, when.
get_item
Read
gamedata
no
—
yes
Full game-data record for one item id: name, description, icon, UI and market categories, item level, equip level and jobs, equip slots, rarity, stack size, flags (unique, untradable, marketable, HQ-able, collectable,…
get_item_sources
Read
gamedata
no
—
yes
Where an item comes from, as far as the game data says.
get_item_uses
Read
gamedata
no
—
yes
What an item is good for, so the player can decide whether to keep, sell or turn it in.
get_quest
Read
gamedata
no
—
yes
Static details for one quest id: name, level, allowed classes/jobs, expansion, journal genre/category/section, place name, issuer NPC with zone and map X/Y coordinates (when the issuer has a placement in game data), p…
get_recipe
Read
gamedata
no
—
yes
Crafting recipe for an item (itemId) or a specific recipe (recipeId): craft type (Carpentry, Smithing, ...
get_recipe_tree
Read
gamedata
no
—
yes
Everything needed to craft quantity of an item (itemId) or of one recipe (recipeId), expanded all the way down: every craftable ingredient is expanded into its own sub-recipe until only raw materials remain (maxDept…
get_sheet_row
Read
gamedata
no
—
yes
Reads one row of any game Excel sheet by sheet name and row id and returns it as JSON: numbers/bools as values, text as plain strings, RowRef links as {rowId, sheet, name} (name is the linked row's Name/Singular when…
get_zone_info
Read
gamedata
no
—
yes
Static details of one zone (territoryId, or zone = a name): name, region, internalName (the level path id such as s1f1), kind (city, field, inn, housing, duty, pvp, other) with the raw intendedUse id, expansion, the d…
list_roulettes
Read
gamedata
no
—
yes
Every Duty Roulette in the game data (ContentRoulette): id, name, category, dutyType, description, requiredLevel, itemLevelRequired, itemLevelSync, partySize, rewardTomeA/B/C (the sheet's three tomestone reward amount…
list_sheets
Read
gamedata
no
—
yes
Lists game Excel sheets that have typed column definitions (Lumina.Excel.Sheets), optionally filtered by nameContains, with row count, whether rows have subrows, and column names with types (string, uint8..int64, floa…
search_actions
Read
gamedata
no
—
yes
Searches actions players can learn (weaponskills, spells, abilities, role actions, gathering abilities, PvP actions; from the Action sheet — crafting actions such as Basic Synthesis live in the CraftAction sheet, see…
search_duties
Read
gamedata
no
—
yes
Searches duties from the Duty Finder data (ContentFinderCondition: dungeons, guildhests, trials, raids, alliance raids, PvP, deep dungeons, variant/criterion, etc.) by name (ranked exact > prefix > word > substring; n…
search_items
Read
gamedata
no
—
yes
Searches every item in the game data (not the player's inventory; use find_owned_items for that) by name in the client language, ranked exact match > prefix > word prefix > substring > all words present; a numeric que…
search_quests
Read
gamedata
no
—
yes
Searches quests by name (ranked exact > prefix > word > substring; a numeric query matches the quest id).
search_recipes
Read
gamedata
no
—
yes
Searches crafting recipes by the crafted item's name (ranked exact > prefix > word > substring; numeric query matches the recipe id), optionally filtered by craftType (crafter name like "Weaving"/"Weaver", abbreviatio…
search_sheet
Read
gamedata
no
—
yes
Scans one column of any Excel sheet and returns matching rows as {rowId, subrowId, label, value}, where label is the row's Name/Singular when it has one.
search_zones
Read
gamedata
no
—
yes
Searches zones (TerritoryType rows that have a place name) by name, ranked exact > prefix > word > substring; a numeric query matches the territory id.
find_owned_items
Read
inventory
yes
—
—
Searches every loaded container (bags, equipped, armory, crystals, currency, key items, saddlebags if opened this session, and the currently/last opened retainer's inventory, equipment and market listings) for items b…
get_currencies
Read
inventory
yes
—
—
The character's currency balances: gil; Grand Company seals for the current company with its cap; and a list of currencies with category (common: ventures, MGP; tomestone: every current tomestone with weeklyAcquired/w…
get_equipment
Read
inventory
yes
—
—
The character's currently equipped gear: for each occupied slot (MainHand, OffHand, Head, Body, Hands, Legs, Feet, Ears, Neck, Wrists, RingRight, RingLeft, SoulCrystal) the item id, name, item level, equip level, HQ,…
get_glamour_plates
Read
inventory
yes
—
—
The character's glamour plates (the Glamour Dresser plate slots) with, per plate, plateNumber, empty, filledSlots and the occupied slots as {slot, itemId, name, hq, dye1, dye2}.
get_inventory
Read
inventory
yes
—
—
Lists items in the character's containers, slot by slot. containers selects groups: bags (4 main inventory pages), equipped, armory (armoury chest), crystals, currency, keyItems, saddlebag, premiumSaddlebag, retainer…
get_retainers
Read
inventory
yes
—
—
The character's retainers in display order: id, name, whether the slot is available (subscription), class/job and level, gil held, number of items in its inventory and on the market board, market listing expiry, marke…
get_market_prices
Read
market
no
—
—
Current market-board listings and recent sales for up to 20 items, from the public Universalis crowd-sourced database (universalis.app) over the host's internet connection — NOT from the player's own market board wind…
list_worlds
Read
market
no
—
—
Every public world in the game with its data centre and region, from game data (no network call).
get_latest_screenshot
Read
media
no
—
—
Returns the newest screenshot the player has already saved (the files the game writes when they press the screenshot key), as a PNG/JPEG image plus fileName, directory, modifiedUtc and fileBytes.
take_screenshot
Ui
media
no
—
—
Captures what is on the player's screen right now and returns it as a PNG image the model can look at, plus a text summary.
get_server_info
Read
meta
no
—
yes
Describes this XivMcp server: plugin version, endpoint, running state, connected clients, which permission tiers are currently allowed (read, ui, action, chat — and whether state-changing calls need in-game approval:…
list_status
Read
meta
no
—
—
Returns every entry on the in-game agent board (newest update first) with agent, status, state (running|done|failed|info), progress, detail, the MCP client that posted it and seconds since its last update (ageSeconds).
clear_status
Ui
meta
no
—
—
Removes your entry (pass agent) or every entry (omit agent) from the in-game agent board.
post_status
Ui
meta
no
—
—
Shows your progress inside the player's game: creates or replaces the board entry for agent (one entry per agent name, case-insensitive) in the XivMcp window and Umbra toolbar widget.
list_objectives
Read
objectives
no
—
—
Every custom objective in insertion order with steps, location, conditions and live status: ready (in the zone, within the radius, inside the Eorzea time window and weather), summary (the line the player sees, e.g. "N…
clear_objectives
Ui
objectives
no
—
—
Removes one objective (id), every completed one (completedOnly=true) or all of them (no arguments).
load_objective_pack
Ui
objectives
no
—
—
Loads many objectives at once from a quest pack: pass the JSON text (json) or a file path on the player's machine (path; host paths such as /home/me/pack.json or ~/pack.json are mapped to Wine's Z: drive).
post_objective
Ui
objectives
no
—
—
Creates or replaces (same id) a custom objective that the player sees in game like a tracked quest: title and current step under the Duty List, live 'ready now' / 'next window in N min' state, click to place the map f…
update_objective
Ui
objectives
no
—
—
Reports progress on an objective posted with post_objective or loaded from a pack: advance=true marks the current step done (after the last step the objective completes), step=N makes step N (0-based) current with eve…
get_party
Read
party
yes
—
—
The player's party. mode is solo | party | crossRealmParty | alliance. members (the 8-slot party list; empty when solo) each have index, name, contentId (string), entityId, homeWorld, job {abbreviation, name, role}, l…
list_social_groups
Read
party
yes
—
—
Names of the groups the logged-in character belongs to, and nothing else: freeCompany {loaded, member, name, tag, rank (the company's rank 1-30), grandCompany}, linkshells and crossWorldLinkshells {loaded, count, grou…
get_achievements
Read
progress
yes
—
—
The character's achievement progress: totalInGame, completed, pointsEarned and pointsAvailable, then a filtered, paged list of {id, name, description, category, points, completed}.
get_collection_progress
Read
progress
yes
—
—
Unlock progress for one collection kind: mounts, minions, orchestrion (orchestrion rolls), emotes, fashionAccessories (also accepted as ornaments), triadCards (Triple Triad cards), bardings (chocobo barding), glasses…
get_quest_journal
Read
progress
yes
—
—
The quests the character has accepted, as the Journal lists them: questId (Quest sheet row id), name, sequence (the client's step counter; 255 = all steps done, readyToComplete=true), objectives (the journal to-do tex…
get_quest_status
Read
progress
yes
—
—
For each quest id (Quest sheet row id; short ids below 65536 are accepted): whether the character has completed it, whether it is currently accepted (in the journal) and its current sequence step, plus name and whethe…
get_addon_text
Read
ui
yes
—
—
Reads every text string shown in one game UI window (addon), including text inside nested components such as lists, buttons and tabs, in reading order (top-to-bottom, left-to-right by screen position).
get_dialogue
Read
ui
yes
—
—
Returns whatever conversation or prompt windows are currently visible, read-only: talk (NPC speaker + dialogue text of the current Talk box), subtitle (cutscene subtitle), selectString / selectIconString (the option l…
list_addons
Read
ui
yes
—
—
Lists the game's loaded UI windows ("addons") with their internal names, which get_addon_text needs.
open_game_window
Ui
ui
yes
yes
—
Opens one of the game's own windows so the player can look at it; it never clicks, selects, registers, crafts or buys anything inside the window. kind: map (id = Map row id, or territoryId = zone whose main map to sho…
set_map_flag
Ui
ui
yes
yes
—
Places the user's map flag marker (the one shown on the map/minimap and inserted by in chat) and by default opens the map window on it.
show_notification
Ui
ui
no
—
—
Shows a Dalamud overlay notification card (bottom-right corner, with title, text and a coloured icon for the type) visible only to the user; works on the title screen too.
show_toast
Ui
ui
yes
—
—
Shows a short, transient on-screen message using the game's own toast styles, visible only to the user: normal (small banner near the top of the screen), quest (large centred quest-style text with a chime), error (red…
convert_coordinates
Read
world
no
—
—
Converts between the map coordinates the game displays (the x/y in quest guides, hunt trains and links, roughly 1-42) and the world position other tools report (worldX / worldZ).
find_nearest_aetheryte
Read
world
no
—
—
Aetherytes in a zone, nearest first, to a point given as map coordinates (x/y) or world coordinates (worldX/worldZ); with no point and a logged-in character it uses the player's position.
get_housing_info
Read
world
yes
—
—
Where the player is in the housing system: inHousingArea, territoryId/zone, ward (1-based), plot (1-based, null in an apartment or subdivision entrance), division (1 = main area, 2 = subdivision), room (apartment/FC r…
get_location
Read
world
yes
—
—
Where the player is.
get_time
Read
world
no
—
yes
Current Eorzea time and the real-world reset schedule.
get_weather_forecast
Read
world
no
—
yes
Weather forecast for a zone computed with the game's own deterministic weather algorithm (weather changes every 8 Eorzea hours = 23m20s real time, at ET 00:00, 08:00 and 16:00).
get_zone_live
Read
world
yes
—
—
What is going on in the zone the player is standing in, right now, in one call: territoryId, zone and region names, intendedUse (Town, Overworld, Dungeon, HousingOutdoor, ...), map, area/subArea place names, instance…
list_aetherytes
Read
world
yes
—
—
The player's teleport list (the in-game Teleport window): every attuned aetheryte plus housing destinations (own/FC house, shared estates, apartments).
list_fates
Read
world
yes
—
—
FATEs currently known in the player's zone, nearest first.
list_nearby_objects
Read
world
yes
—
—
Game objects loaded around the player (the client only knows objects within roughly 100 yalms, fewer in crowded areas), sorted nearest first; the local player is excluded.
来源:GitHub · github.com