Tools Reference#

Complete specification for all 37 MCP tools exposed by the GW2 MCP Server. Each tool is invoked via the MCP tools/call method over stdio. For authentication requirements, see API Scopes . For cache behavior, see Caching . For client setup, see How to Configure MCP Clients .

Overview#

Wiki#

Account#

Trading Post#

Game Data#

Wizard’s Vault#

Guilds#

Game Metadata#

Composite Tools#

Wiki#

wiki_search#

Search Guild Wars 2 wiki for information about game content.

Parameters#

Example#

{
  "tool": "wiki_search",
  "arguments": {
    "query": "Dragon Bash",
    "limit": 3
  }
}

Account#

get_account#

Get account information including name, world, guilds, and access. Requires GW2_API_KEY.

Parameters#

None.

Example#

{
  "tool": "get_account",
  "arguments": {}
}

get_wallet#

Get wallet information including all currencies. Requires GW2_API_KEY.

Parameters#

None.

Example#

{
  "tool": "get_wallet",
  "arguments": {}
}

get_bank#

Get bank vault contents with item names. Requires GW2_API_KEY.

Parameters#

None.

Example#

{
  "tool": "get_bank",
  "arguments": {}
}

get_materials#

Get material storage contents with item names. Requires GW2_API_KEY.

Parameters#

None.

Example#

{
  "tool": "get_materials",
  "arguments": {}
}

get_inventory#

Get shared inventory slot contents with item names. Requires GW2_API_KEY.

Parameters#

None.

Example#

{
  "tool": "get_inventory",
  "arguments": {}
}

get_characters#

Get list of character names, or detailed info for a specific character including crafting disciplines, equipment, skills, specializations, and build tabs. Requires GW2_API_KEY.

When name is omitted, returns a list of all character names. When name is provided, returns detailed information for that character.

Parameters#

Examples#

List all characters:

{
  "tool": "get_characters",
  "arguments": {}
}

Get details for a specific character:

{
  "tool": "get_characters",
  "arguments": {
    "name": "My Character Name"
  }
}

get_account_unlocks#

Get account unlocked IDs. Requires GW2_API_KEY.

Parameters#

Valid values for type:

Example#

{
  "tool": "get_account_unlocks",
  "arguments": {
    "type": "skins"
  }
}

get_account_progress#

Get account progress data. Requires GW2_API_KEY.

Parameters#

Valid values for type:

Example#

{
  "tool": "get_account_progress",
  "arguments": {
    "type": "achievements"
  }
}

get_account_dailies#

Get completed daily content IDs. Requires GW2_API_KEY.

Parameters#

Valid values for type:

Example#

{
  "tool": "get_account_dailies",
  "arguments": {
    "type": "raids"
  }
}

get_token_info#

Get API key information including name and permission scopes. Requires GW2_API_KEY.

Parameters#

None.

Example#

{
  "tool": "get_token_info",
  "arguments": {}
}

Trading Post#

get_currencies#

Get information about Guild Wars 2 currencies. Returns currency metadata including names and descriptions. When ids is omitted, returns all currencies.

Parameters#

Examples#

Get all currencies:

{
  "tool": "get_currencies",
  "arguments": {}
}

Get specific currencies:

{
  "tool": "get_currencies",
  "arguments": {
    "ids": [1, 4]
  }
}

get_tp_prices#

Get Trading Post prices for items. Returns aggregated best buy/sell prices with item names and formatted coin values.

Parameters#

Example#

{
  "tool": "get_tp_prices",
  "arguments": {
    "item_ids": [19976, 19721]
  }
}

get_tp_listings#

Get Trading Post order book listings for items. Returns all buy/sell price tiers with quantities.

Parameters#

Example#

{
  "tool": "get_tp_listings",
  "arguments": {
    "item_ids": [19976]
  }
}

get_gem_exchange#

Get gem exchange rates. Convert coins to gems or gems to coins.

Parameters#

Example#

{
  "tool": "get_gem_exchange",
  "arguments": {
    "direction": "coins",
    "quantity": 10000000
  }
}

get_tp_delivery#

Get items and coins awaiting pickup from the Trading Post. Requires GW2_API_KEY with account and tradingpost scopes.

Parameters#

None.

Example#

{
  "tool": "get_tp_delivery",
  "arguments": {}
}

get_tp_transactions#

Get Trading Post transaction history. View current orders or completed transactions from the past 90 days. Requires GW2_API_KEY with account and tradingpost scopes.

Parameters#

Valid values for type:

Example#

{
  "tool": "get_tp_transactions",
  "arguments": {
    "type": "history/sells"
  }
}

Game Data#

get_items#

Get item metadata (name, type, rarity, level, icon, description, vendor value, flags, game types, restrictions, and type-specific details) for given item IDs.

Parameters#

Example#

{
  "tool": "get_items",
  "arguments": {
    "ids": [19976, 19721]
  }
}

get_skins#

Get skin metadata (name, type, icon, rarity, description, flags, restrictions, and type-specific details) for given skin IDs.

Parameters#

Example#

{
  "tool": "get_skins",
  "arguments": {
    "ids": [1, 2, 3]
  }
}

get_recipes#

Get recipe details (type, output, ingredients, disciplines, crafting time, flags, guild ingredients, chat link) for given recipe IDs.

Parameters#

Example#

{
  "tool": "get_recipes",
  "arguments": {
    "ids": [7259]
  }
}

search_recipes#

Search for recipe IDs by input or output item ID. At least one of input or output is required.

Parameters#

Examples#

Search by output item:

{
  "tool": "search_recipes",
  "arguments": {
    "output": 19976
  }
}

Search by input item:

{
  "tool": "search_recipes",
  "arguments": {
    "input": 19721
  }
}

get_achievements#

Get achievement details (name, description, requirements, tiers, prerequisites, rewards, bits, icon) for given achievement IDs.

Parameters#

Example#

{
  "tool": "get_achievements",
  "arguments": {
    "ids": [1, 2, 3]
  }
}

get_daily_achievements#

Get today’s and tomorrow’s daily achievements.

Parameters#

None.

Example#

{
  "tool": "get_daily_achievements",
  "arguments": {}
}

Wizard’s Vault#

get_wizards_vault#

Get current Wizard’s Vault season information.

Parameters#

None.

Example#

{
  "tool": "get_wizards_vault",
  "arguments": {}
}

get_wizards_vault_objectives#

Get Wizard’s Vault objectives. Uses authenticated endpoint if GW2_API_KEY is set (returns account-specific progress), otherwise returns the public objective list.

Parameters#

Valid values for type:

Example#

{
  "tool": "get_wizards_vault_objectives",
  "arguments": {
    "type": "daily"
  }
}

get_wizards_vault_listings#

Get Wizard’s Vault reward listings. Uses authenticated endpoint if GW2_API_KEY is set (returns purchase status).

Parameters#

None.

Example#

{
  "tool": "get_wizards_vault_listings",
  "arguments": {}
}

Guilds#

get_guild#

Get public guild information (name, tag, level).

Parameters#

Example#

{
  "tool": "get_guild",
  "arguments": {
    "id": "4BBB52AA-D768-4FC6-8EDE-C299F2822F0F"
  }
}

search_guild#

Search for a guild by name. Returns matching guild IDs.

Parameters#

Example#

{
  "tool": "search_guild",
  "arguments": {
    "name": "My Guild"
  }
}

get_guild_details#

Get detailed guild data (log, members, ranks, stash, etc.). Requires GW2_API_KEY with guild leader permissions.

Parameters#

Valid values for type:

Example#

{
  "tool": "get_guild_details",
  "arguments": {
    "id": "4BBB52AA-D768-4FC6-8EDE-C299F2822F0F",
    "type": "members"
  }
}

Game Metadata#

get_colors#

Get dye color metadata (name, base RGB, cloth/leather/metal/fur material adjustments) for given color IDs.

Parameters#

Example#

{
  "tool": "get_colors",
  "arguments": {
    "ids": [1, 2, 3]
  }
}

get_minis#

Get miniature metadata (name, icon, item_id) for given mini IDs.

Parameters#

Example#

{
  "tool": "get_minis",
  "arguments": {
    "ids": [1, 2, 3]
  }
}

get_mounts_info#

Get mount skin or mount type metadata for given IDs.

Parameters#

Example#

{
  "tool": "get_mounts_info",
  "arguments": {
    "type": "skins",
    "ids": [1, 2, 3]
  }
}

get_game_build#

Get the current Guild Wars 2 game build number.

Parameters#

None.

Example#

{
  "tool": "get_game_build",
  "arguments": {}
}

get_dungeons_and_raids#

Get dungeon or raid metadata (paths, wings, events) for given IDs.

Parameters#

Example#

{
  "tool": "get_dungeons_and_raids",
  "arguments": {
    "type": "raids",
    "ids": ["forsaken_thicket"]
  }
}

Composite Tools#

Composite tools combine a wiki search with a GW2 API lookup in a single call. They search the wiki to resolve an item name to an ID, then fetch full data from the API.

get_item_by_name#

Look up a GW2 item by name. Searches the wiki to find the item ID, then returns full item details from the API.

Parameters#

Example#

{
  "tool": "get_item_by_name",
  "arguments": {
    "name": "Mystic Coin"
  }
}

get_item_recipe_by_name#

Find crafting recipes for a GW2 item by name. Searches the wiki for recipe data, then returns full recipe details with resolved ingredient names. Falls back to the API recipe search if the wiki result does not contain recipe IDs.

Parameters#

Example#

{
  "tool": "get_item_recipe_by_name",
  "arguments": {
    "name": "Dawn"
  }
}

get_tp_price_by_name#

Get Trading Post prices for an item by name. Searches the wiki to find the item ID, then returns current buy/sell prices.

Parameters#

Example#

{
  "tool": "get_tp_price_by_name",
  "arguments": {
    "name": "Glob of Ectoplasm"
  }
}