Guild Wars 2 MCP Server

@pipeworx/guild-wars-2

Guild Wars 2 API v2 MCP — keyless public endpoints (worlds, items, achievements, build, etc.).

Part of Pipeworx — an MCP gateway connecting AI agents to 1394+ live data sources.

Tools

• worlds(ids?) — world list
• items(ids?, page?, page_size?, lang?) — item lookup
• achievements(ids?, page?, page_size?, lang?) — achievements
• professions(ids?, lang?) — professions
• currencies(ids?, lang?) — currencies
• build() — current game build id
• quaggans() — Quaggan images (gag endpoint)
• wvw_matches(world?) — current WvW matches
• commerce_prices(ids?) — bulk trading-post quotes for numeric item IDs (raw copper)
• commerce_listings(ids?) — trading-post order-book depth for numeric item IDs
• guild_wars_2_item_price(name?, item_id?, include_listings?) — live Trading Post price for a single item looked up by name ("Mystic Coin") or by item_id. Returns highest buy order, lowest sell offer, quantity on each side and the spread, each as raw copper and a readable gold/silver/copper string, plus item name, rarity, type and icon.

Pass ids as a comma-sep string ("1,2,3"); omit for index.

Money

Trading Post unit_price values are in copper. 100 copper = 1 silver, 100 silver = 1 gold, so 19944 copper renders as 1g 99s 44c. guild_wars_2_item_price returns both forms.

Item name → ID resolution

The official API has no item-name search: /v2/items/search returns 404, and /v2/items with no ids returns ~70k bare IDs — far too heavy to scan per call. So guild_wars_2_item_price resolves a name in three steps:

1. A curated name → ID map built into the pack (83 commonly traded items — Mystic Coin, Glob of Ectoplasm, T5/T6 fine materials, ores, ingots, wood, leather, cloth, ascended crafting mats, popular runes/sigils, charms/symbols, precursors, agony infusions). Case-insensitive, no extra request. Every ID in it was verified against /v2/items and confirmed to carry a live Trading Post quote.
2. Fallback: api.datawars2.ie — a keyless third-party GW2 item index. This is an added dependency outside ArenaNet's control; its name filter is exact and case-sensitive, so the pack retries with title-cased variants, and the call is bounded by an 8s timeout.
3. If neither resolves, the tool returns {found:false, reason:'item_name_not_resolved', hint} telling the caller to pass item_id — it never guesses a different item.

Account-bound items (Pile of Bloodstone Dust, Charged Quartz Crystal, Mystic Forge Stone, …) have no Trading Post quote and return {found:false, reason:'item_not_traded'}.

Data source

https://api.guildwars2.com/v2 — plus https://api.datawars2.ie for item-name fallback only.

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "guild-wars-2": {
      "url": "https://gateway.pipeworx.io/guild-wars-2/mcp"
    }
  }
}

Or connect to the full Pipeworx gateway for access to all 1394+ data sources:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

Using with ask_pipeworx

Instead of calling tools directly, you can ask questions in plain English:

ask_pipeworx({ question: "your question about Guild Wars 2 data" })

The gateway picks the right tool and fills the arguments automatically.

More

• Docs and guides
• pipeworx.io

License

MIT