XIV MCP

Plugins XIV MCP uses

Which of XIV MCP's tools use other plugins, what happens without them, and where to get each plugin.

You do not need any other plugin to use XIV MCP. Its tools come in two kinds:

  • Core tools work without any other plugin. Some of them hand a part of the work to a plugin when you have it: walking, travel, finding vendors. Without it, XIV MCP asks you to do that part, and waits until you have.
  • Integration tools drive one plugin each, and need it. Your assistant only sees them while that plugin is loaded.

Plugin developers: when your jobs use one of these tools, declare it with McpDependency.BuiltIn("tool"). See Using other tools in your jobs.

This page is generated from XIV MCP's own code on every build, so it always matches the version the documentation was built from.

Core tools that use plugins

Every other core tool uses no plugin at all.

ToolWhat it doesWith the pluginWithout it
navigate_toGets you to a bell, your house, an inn or a named place, or shows the way. Teleports cost gil.vnavmesh: Walks there for you.
Lifestream: Teleports you, and enters your house, apartment, inn room or workshop.
No vnavmesh: XIV MCP puts a flag on your map and waits while you walk there.
No Lifestream: XIV MCP tells you where to teleport or which place to enter, and waits until you are there.
buy_itemBuys an item from a vendor. Purchases not paid in gil ask you first.Item Vendor Location: Finds the vendors that sell the item, their prices and where they stand.
vnavmesh: Walks there for you.
Lifestream: Teleports you to the right zone.
No Item Vendor Location: XIV MCP asks you to open a vendor's shop yourself, then buys from it.
No vnavmesh: XIV MCP puts a flag on your map and waits while you walk there.
No Lifestream: XIV MCP tells you which aetheryte to teleport to, and waits until you are there.
turn_in_collectablesTakes you to an appraiser and hands in your collectables for scrips, stopping before the scrip cap.Item Vendor Location: Finds where a Collectable Appraiser stands.
vnavmesh: Walks there for you.
Lifestream: Teleports you to the right zone.
No Item Vendor Location: XIV MCP asks you to go to an appraiser, and waits until you are next to one.
No vnavmesh: XIV MCP puts a flag on your map and waits while you walk there.
No Lifestream: XIV MCP tells you which aetheryte to teleport to, and waits until you are there.
visit_worldTakes your character to another world or data center, or tells you how to get there.Lifestream: Travels to the world or data center for you.No Lifestream: XIV MCP asks you to travel there with World Visit or Data Center Travel, and waits until you arrive.
place_waymark_presetPlaces a saved set of waymarks in your current duty, outside of combat.Waymark Preset Plugin: Also places presets from its library.No Waymark Preset Plugin: Only the game's own preset slots.
list_waymark_presetsLists your saved waymark presets.Waymark Preset Plugin: Also lists the presets in its library.No Waymark Preset Plugin: Only the game's own preset slots.
get_waymark_presetLooks at where a waymark preset places its markers.Waymark Preset Plugin: Can also read presets from its library.No Waymark Preset Plugin: Only the game's own preset slots and the waymarks placed now.
sell_itemLists an item through a retainer, just below the cheapest offer. Prices far too low are refused.Penny Pincher: Undercuts with its settings (amount, rounding, minimum).No Penny Pincher: XIV MCP undercuts by 1 gil.
reprice_listingsUndercuts cheaper offers on your listings. Cuts of more than 30 percent are skipped.Penny Pincher: Undercuts with its settings (amount, rounding, minimum).No Penny Pincher: XIV MCP undercuts by 1 gil.

Integration tools

These tools exist to drive one plugin each, so they always need it. They are only offered to the assistant while that plugin is loaded.

AutoDuty

Runs and loops dungeons until a loop count, item or currency target is reached. Needs AutoDuty.

ToolWhat it does
list_dutiesLists the duties that can be run for you, with their levels and modes.
get_duty_statusChecks whether a dungeon run is going on and how far it has got.
stop_dutyStops the dungeon run once the current fight is over.
run_dutyRuns a dungeon with NPC allies or a party, as often as needed. Your character can be defeated.
farm_duty_itemRuns a dungeon that drops an item until you have as many as you want.

Artisan

Crafts and crafting lists, and Raphael solutions prepared ahead of time. Needs Artisan.

ToolWhat it does
get_crafting_listsLists your crafting lists.
set_crafting_listCreates or changes a crafting list. The old lists are backed up first.
delete_crafting_listDeletes a crafting list. The old lists are backed up first.
craft_itemCrafts an item a number of times, using your materials.
crafting_controlStarts, pauses or stops a crafting list.
run_crafting_listCrafts a whole crafting list, using your materials.
prepare_craft_planWrites a crafting list for a project and works out each craft in advance. Crafts nothing yet.

GatherBuddy Reborn

Auto-gathering and its gather lists. Needs GatherBuddy Reborn.

ToolWhat it does
get_gather_listsLists your gathering lists.
set_gather_listCreates or changes a gathering list. The old lists are backed up first.
delete_gather_listDeletes a gathering list. The old lists are backed up first.
set_auto_gatherTurns automatic gathering on or off. While it is on, your character moves and gathers on its own.
gather_untilGathers until you have the amounts you need, moving your character from node to node.

Item Vendor Location

Which NPCs sell an item and where they stand. Needs Item Vendor Location.

ToolWhat it does
find_vendorsFinds which NPCs sell an item and where they stand.

FCCH

Free company chest deposits and withdrawals. Needs FCCH.

ToolWhat it does
fc_chest_transferPuts items into the free company chest or takes them out.

Gold Saucer

Triple Triad and the Cactpot lotteries with Saucy; your cards, opponents and decks also with TriadBuddy. Needs Saucy, except where the table says otherwise.

ToolWhat it doesPlugins
list_triad_npcsLists Triple Triad opponents with where they stand, their rules and which of their cards you have.Needs Saucy or TriadBuddy.
list_triad_cardsLists Triple Triad cards you have or are missing, and who gives them.Needs Saucy or TriadBuddy.
get_triad_decksLooks at your saved Triple Triad decks.Needs Saucy or TriadBuddy.
set_triad_deckSaves five of your Triple Triad cards as one of your decks.Needs Saucy or TriadBuddy.
get_saucy_statsChecks how many Triple Triad matches were played, won and lost, and the cards and MGP won.Needs Saucy.
build_triad_deckBuilds the best deck against a Triple Triad opponent and saves it as your fifth deck.Needs Saucy.
play_triple_triadGoes to a Triple Triad opponent and plays a number of matches, or until a card drops.Needs Saucy.
vnavmesh: Walks there for you. Without it: XIV MCP puts a flag on your map and waits while you walk there.
Lifestream: Teleports you to the right zone. Without it: XIV MCP tells you which aetheryte to teleport to, and waits until you are there.
farm_triad_cardsCollects missing Triple Triad cards from one opponent, or from opponent to opponent.Needs Saucy.
vnavmesh: Walks there for you. Without it: XIV MCP puts a flag on your map and waits while you walk there.
Lifestream: Teleports you to the right zone. Without it: XIV MCP tells you which aetheryte to teleport to, and waits until you are there.
play_mini_cactpotGoes to the Mini Cactpot broker and plays your tickets for today.Needs Saucy.
vnavmesh: Walks there for you. Without it: XIV MCP puts a flag on your map and waits while you walk there.
Lifestream: Teleports you to the right zone. Without it: XIV MCP tells you which aetheryte to teleport to, and waits until you are there.
play_jumbo_cactpotCollects your Jumbo Cactpot prizes and buys this week's tickets with your numbers or random ones.Needs Saucy.
vnavmesh: Walks there for you. Without it: XIV MCP puts a flag on your map and waits while you walk there.
Lifestream: Teleports you to the right zone. Without it: XIV MCP tells you which aetheryte to teleport to, and waits until you are there.
stop_saucyStops Triple Triad and travel that are running at the Gold Saucer.Needs Saucy.
present_fashion_reportPuts on your Fashion Report outfit and presents it to the Masked Rose for judging.Needs no plugin.
vnavmesh: Walks there for you. Without it: XIV MCP puts a flag on your map and waits while you walk there.
Lifestream: Teleports you to the right zone. Without it: XIV MCP tells you which aetheryte to teleport to, and waits until you are there.
complete_fashion_reportGets, dyes and puts on this week's easy Fashion Report set, then presents it for judging.Needs no plugin.
vnavmesh: Walks there for you. Without it: XIV MCP puts a flag on your map and waits while you walk there.
Lifestream: Teleports you to the right zone. Without it: XIV MCP tells you which aetheryte to teleport to, and waits until you are there.

Custom Deliveries

Custom deliveries with Satisfier: this week's requests, and delivering them by crafting, gathering or fishing. Needs Satisfier, except where the table says otherwise.

ToolWhat it doesPlugins
get_custom_deliveriesLists this week's custom deliveries: each client's requests, rank and deliveries left.Needs Satisfier.
deliver_custom_deliveryDelivers one client's request by crafting, gathering or fishing it, with Satisfier.Needs Satisfier.
Artisan: Crafts the crafting requests. Without it: Crafting requests can't be delivered; gathering and fishing ones can.
Questionable: Gathers the gathering requests. Without it: Gathering requests can't be delivered; crafting and fishing ones can.
AutoHook: Fishes the fishing requests. Without it: Satisfier takes you to the fishing spot and you fish yourself.
vnavmesh: Walks Satisfier to vendors, clients and gathering spots. Without it: Satisfier can't move you, and stops.
do_custom_deliveriesDoes this week's custom deliveries for all clients, one after another, as a job.Needs Satisfier.
Artisan: Crafts the crafting requests. Without it: Crafting requests can't be delivered; gathering and fishing ones can.
Questionable: Gathers the gathering requests. Without it: Gathering requests can't be delivered; crafting and fishing ones can.
AutoHook: Fishes the fishing requests. Without it: Satisfier takes you to the fishing spot and you fish yourself.
vnavmesh: Walks Satisfier to vendors, clients and gathering spots. Without it: Satisfier can't move you, and stops.
stop_custom_deliveryStops the custom delivery Satisfier is doing.Needs Satisfier.

Ocean fishing

Ocean fishing voyages: the schedule and routes, boarding at the ferry docks, and a job that fishes voyages with AutoHook until a target. Needs Distant Seas, except where the table says otherwise.

ToolWhat it doesPlugins
get_ocean_fishing_scheduleLists the next ocean fishing voyages, their stops and the fish worth going for.Needs no plugin.
get_ocean_fishing_statusChecks the voyage you are on: the stop, time left, spectral current, missions and points.Needs no plugin.
board_ocean_fishingGoes to the ferry docks in Limsa Lominsa and boards the voyage while boarding is open.Needs no plugin.
vnavmesh: Walks there for you. Without it: XIV MCP puts a flag on your map and waits while you walk there.
Lifestream: Teleports you to the right zone. Without it: XIV MCP tells you which aetheryte to teleport to, and waits until you are there.
set_ocean_fishing_alarmTurns the Distant Seas departure alarm on or off.Needs Distant Seas.
import_ocean_presetsImports AutoHook's ocean fishing presets for a goal: points, legends, achievements or levelling.Needs no plugin.
go_ocean_fishingFishes ocean voyages with AutoHook until your target: voyages, points or a fish.Needs no plugin.
fish_ocean_voyagesBoards and fishes voyages one after another, as a step of an ocean fishing job.Needs no plugin.

AutoHook

Fishing with AutoHook: presets built for the fish you are after, fishing until it is caught, and a job that does it all. Needs AutoHook, except where the table says otherwise.

ToolWhat it doesPlugins
set_autohook_presetSets up automatic hooking for the fish you are after.Needs AutoHook.
fish_untilFishes until you have caught a fish, waiting for its time and weather.Needs AutoHook.
catch_fishCatches a fish for you: travels there, buys bait, waits for its window and fishes.Needs AutoHook.
vnavmesh: Walks there for you. Without it: XIV MCP puts a flag on your map and waits while you walk there.
Lifestream: Teleports you to the right zone. Without it: XIV MCP tells you which aetheryte to teleport to, and waits until you are there.
stop_fishingStops fishing and reels in your line.Needs AutoHook.

Questionable

Quests with Questionable: a quest with the quests it needs first, the day's allied society quests, and the main scenario. Needs Questionable.

ToolWhat it does
get_questing_statusLooks at which quest is being done for you, and at your allied society reputation.
complete_questDoes a quest for you, together with the quests it needs first.
do_tribe_dailiesDoes the day's allied society quests for you, rank-up quests included.
do_questsDoes quests for you until they are done.
start_main_scenarioStarts doing the main scenario quests for you.
stop_questingStops doing quests for you, once a fight is over.

Where to get them

Plugins in Dalamud's main repository are installed from /xlplugins right away. For the others, add their repository first:

Type /xlsettings and open the Experimental tab.

Under Custom Plugin Repositories, paste the repository URL from the table, tick Enabled and click Save and Close.

Type /xlplugins, search for the plugin and click Install.

Where XIV MCP shows a missing plugin, such as under Market & purchases or on a third-party plugin's card, an Install button opens the plugin installer at that plugin. For a plugin outside the main repository, the card also has Copy repository URL and Open Dalamud settings. Only add repositories you trust.

PluginInternal nameRepository
vnavmeshvnavmeshhttps://puni.sh/api/repository/veyn
LifestreamLifestreamhttps://raw.githubusercontent.com/NightmareXIV/MyDalamudPlugins/main/pluginmaster.json
AutoDutyAutoDutyhttps://puni.sh/api/repository/erdelf
ArtisanArtisanhttps://love.puni.sh/ment.json
GatherBuddy RebornGatherBuddyRebornhttps://raw.githubusercontent.com/FFXIV-CombatReborn/CombatRebornRepo/main/pluginmaster.json
Item Vendor LocationItemVendorLocationDalamud's main repository
FCCHFCCHhttps://puni.sh/api/repository/nexai
Penny PincherPennyPincherDalamud's main repository
Waymark Preset PluginWaymarkPresetPluginDalamud's main repository
SaucySaucyhttps://love.puni.sh/ment.json
AutoHookAutoHookhttps://love.puni.sh/ment.json
Distant SeasDistantSeasDalamud's main repository
Satisfiervsatisfyhttps://puni.sh/api/repository/veyn
TriadBuddyTriadBuddyDalamud's main repository
QuestionableQuestionablehttps://love.puni.sh/ment.json
Boss ModBossModhttps://puni.sh/api/repository/veyn
AutoRetainerAutoRetainerhttps://love.puni.sh/ment.json

On this page