@pipeworx/guild-wars-2

Connect: https://gateway.pipeworx.io/guild-wars-2/mcp · Install: one-click buttons

Tools: 11

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

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.

Tools

• worlds — Fetch Guild Wars 2 world (server) details by comma-separated IDs, or return the full index of world IDs; includes world name and population level.
• items — Fetch Guild Wars 2 item details by comma-separated IDs or by page; returns item name, type, rarity, level, vendor value, icon, and game flags.
• achievements — Fetch Guild Wars 2 achievement details by comma-separated IDs or by page; returns achievement name, description, category, tiers, point rewards, and prerequisites.
• professions — Professions.
• currencies — Currencies.
• build — Current build id.
• quaggans — Quaggan images.
• wvw_matches — Current WvW matches.
• commerce_prices — Bulk Guild Wars 2 Trading Post buy/sell quotes for many numeric item IDs at once; returns the raw copper unit_price and open quantity on each side for every ID passed. Use guild_wars_2_item_price for
• commerce_listings — Guild Wars 2 Trading Post order-book depth for numeric item IDs; returns every standing buy and sell listing tier with its copper unit price, listing count, and quantity, so you can see how deep the b
• guild_wars_2_item_price — Current Guild Wars 2 Trading Post price for one item, looked up by item name (e.g. “Mystic Coin”, “Glob of Ectoplasm”) or by numeric item_id. Answers “what is X selling for”, “how much is X worth righ