XIV MCP

Your character and the game

What your assistant can read about your character, collections, actions, macros and waymarks.

Most tools on this page only read. They are in the Game data module, whose Reading setting is Allow by default, so they work as soon as your app is connected. Like every setting, you can change it to Ask or Deny in /xivmcp → Modules, for the module or for single tools.

Character and world

ToolWhat it returns
get_game_statusLogged-in state, zone, map and instance, active duty, PvP and GPose, all active condition flags, Eorzea time
get_characterName, worlds, race and clan, nameday, guardian, Grand Company and ranks, job and level, HP, MP, GP and CP, position, status effects, aetherytes, mentor flags, all attributes
get_class_jobsLevel, experience and experience to the next level for every class and job
get_inventoryBags, armoury, saddlebag, crystals, key items, retainer, FC chest and housing containers
search_inventoryWhere an item is stored and how many you have in total, including cached retainers, saddlebag and FC chest
get_equipmentEquipped gear with item level, materia, dyes and glamour, and your average item level
list_gearsetsSaved gear sets: number, name, job, item level, items missing from the inventory, and the one you wear
get_currenciesGil, MGP, seals, tomestones and the weekly cap, wolf marks and more
list_unlock_categories / check_unlocksUnlock or completion state for achievements, quests, mounts, minions, emotes, orchestrion rolls, Triple Triad cards, titles, recipes and more
get_active_quests / check_questsJournal quests and steps, tribe quests, levequests, allowances and reputation; whether given quests are done or accepted
get_party / get_targets / get_nearby_objectsParty and alliance, targets and cast bars, objects around you
get_fates / get_aetherytes / get_companionsFATEs in the zone, attuned aetherytes with their costs, your chocobo, pet and trust members
get_submersiblesFC submersibles and airships: rank, parts and build code, part condition, stats, route, return time, last loot, explored sectors
list_game_sheets / search_game_data / get_game_data_rowAny of the game's data tables, in your client language
inspect_windowWhich game windows are open, or the values and texts one of them shows
run_self_testThe live self-test. See Troubleshooting.

Some of this data is only sent by the game in certain places, such as your retainers at a summoning bell. XIV MCP remembers it between visits. See Caches.

Collections and actions

ToolWhat it does
get_collectionsOwned and total counts for mounts, minions, orchestrion rolls, fashion accessories, facewear, armoire and dresser; the owned or missing entries of one collection
get_armoire / get_glamour_dresserWhat the armoire holds (or eligible items not stored yet); dresser items with their dyes
get_job_actions / get_hotbarsA job's actions with level, unlock state, timing and cooldowns; every hotbar and cross hotbar slot

Macros

ToolWhat it doesModule
get_macrosReads your macrosUI editing (reading)
set_macro / clear_macroCreates, edits or clears a macro, with a dry run and a backup firstUI editing (changes)

Waymark presets

ToolWhat it doesModule
list_waymark_presetsThe game's 30 preset slots and, if WaymarkPresetPlugin is installed, its libraryUI editing
get_waymark_presetThe coordinates of a preset (or of the waymarks placed now), plus a picture of the arena with the waymarks drawn on the duty's mapUI editing
set_waymark_presetWrites a preset slot: copies one, or sets marker positionsUI editing (changes)
place_waymark_presetPlaces a preset inside a duty, out of combat. Library presets go through WaymarkPresetPlugin.Game & navigation (changes)

On this page