How-To Guides on GW2 MCP Server

Check Item Profitability

Mon, 01 Jan 0001 00:00:00 +0000

How to Check Item Profitability#

Goal: Determine whether flipping an item on the Trading Post is profitable after fees.

Time: Approximately 5 minutes

Prerequisites#

None – Trading Post prices are public data and do not require an API key.

You should be familiar with looking up item prices. If not, see the Trading Post Mastery tutorial first.

Steps#

1. Look up the item’s buy and sell prices#

Ask your AI: “What are the Trading Post prices for Mystic Coin?”

Track Your TP Orders

Mon, 01 Jan 0001 00:00:00 +0000

How to Track Your TP Orders#

Goal: View your current buy orders, sell listings, and recent transaction history on the Trading Post.

Time: Approximately 5 minutes

Prerequisites#

GW2 MCP Server connected to your AI assistant – see Getting Started
An API key with the tradingpost scope enabled – see API Key Scopes

Steps#

1. Check your current buy orders#

Ask your AI: “Show my current buy orders”

Your assistant uses the get_tp_transactions tool with type current/buys. For each open buy order, you will see:

Gem Exchange Rates

Mon, 01 Jan 0001 00:00:00 +0000

How to Check Gem Exchange Rates#

Goal: Look up current gem-to-gold and gold-to-gem conversion rates.

Time: Approximately 3 minutes

Prerequisites#

None – gem exchange rates are public data and do not require an API key.

Steps#

1. Check how many gems you can buy with gold#

Ask your AI: “How many gems can I get for 100 gold?”

Your assistant uses the get_gem_exchange tool with direction coins and the quantity in copper. Your assistant handles the conversion automatically – you just ask in gold.

Find Valuable Items in Your Bank

Mon, 01 Jan 0001 00:00:00 +0000

How to Find Valuable Items in Your Bank#

Goal: Identify items in your bank vault that are worth gold on the Trading Post, so you can sell them or make informed decisions about your storage.

Prerequisites#

GW2 MCP Server running and connected to your AI assistant – see Getting Started if you need setup help
A GW2 API key with account and inventories scopes enabled

Steps#

1. Ask your AI to check your bank contents#

Ask your AI: “What’s the most valuable stuff in my bank?”

Audit Your API Key

Mon, 01 Jan 0001 00:00:00 +0000

How to Audit Your API Key#

Goal: Check what permissions your GW2 API key has and understand which tools require which scopes, so you can fix authorization errors or set up a key with the right access.

Prerequisites#

GW2 MCP Server running and connected to your AI assistant – see Getting Started if you need setup help
A GW2 API key configured (any scopes – even a minimal key works for this check)

Steps#

1. Ask your AI what permissions your key has#

Ask your AI: “What permissions does my API key have?”

Compare Characters

Mon, 01 Jan 0001 00:00:00 +0000

How to Compare Characters#

Goal: View your character roster and compare details like gear, crafting levels, and builds across two or more characters.

Prerequisites#

GW2 MCP Server running and connected to your AI assistant – see Getting Started if you need setup help
A GW2 API key with account and characters scopes enabled

Steps#

1. List all your characters#

Ask your AI: “List my characters”

Your AI calls the get_characters tool without specifying a name. The response is a list of every character on your account – their names, just like the character selection screen in-game.

Crafting vs Buying

Mon, 01 Jan 0001 00:00:00 +0000

Crafting vs Buying#

Goal: Determine whether it is cheaper to craft an item yourself or buy it directly from the Trading Post.

Prerequisites#

None – all lookups use public GW2 API endpoints. No API key is required.

Steps#

1. Ask your AI for a cost comparison#

Ask your AI: “Is it cheaper to craft or buy Deldrimor Steel Ingot?”

You can use any craftable item name. The AI handles the entire multi-step analysis automatically.

Find Recipes for a Material

Mon, 01 Jan 0001 00:00:00 +0000

Find Recipes for a Material#

Goal: Find out what you can craft with a specific material you have in your inventory.

Prerequisites#

None – recipe and item lookups use public GW2 API endpoints. No API key is required.

Steps#

1. Ask your AI what uses a material#

Ask your AI: “What can I craft with Glob of Ectoplasm?”

Use the exact in-game name of the material you want to look up. The AI handles the multi-step lookup automatically.

Plan Your Wizard's Vault Session

Mon, 01 Jan 0001 00:00:00 +0000

How to Plan Your Wizard’s Vault Session#

Goal: Plan your daily Wizard’s Vault session efficiently by checking objectives, rewards, and your Astral Acclaim balance before you play.

Prerequisites#

GW2 MCP Server running and connected to your AI assistant – see Getting Started
A GW2 API key with account and progression scopes for personal progress tracking – see API Scopes
Without an API key, you can still view objective lists and reward catalogs, but you will not see your completion status or purchase history

Steps#

1. Check your daily objectives#

Ask your AI: “What are today’s Wizard’s Vault dailies?”

Track Raid and Dungeon Clears

Mon, 01 Jan 0001 00:00:00 +0000

How to Track Raid and Dungeon Clears#

Goal: See which raids, dungeons, and world bosses you have completed this reset period so you know what still has rewards available.

Prerequisites#

GW2 MCP Server running and connected to your AI assistant – see Getting Started
A GW2 API key with account and progression scopes – see API Scopes
All three tools in this guide require an API key. Without one, these lookups will not work.

Steps#

1. Check your raid clears#

Ask your AI: “Which raids have I cleared this week?”

Guild Lookup

Mon, 01 Jan 0001 00:00:00 +0000

How to Look Up Guild Information#

Goal: Find a guild by name and view its public info, or access detailed guild data if you are the leader.

Time: Approximately 5 minutes

Prerequisites#

For public info (name, tag, level): No API key required.
For detailed data (members, stash, treasury, etc.): An API key with the guilds scope, and you must be the guild leader.

Steps#

1. Search for a guild by name#

Ask your AI: “Find the guild called Mighty Teapot”

Use Without an API Key

Mon, 01 Jan 0001 00:00:00 +0000

How to Use the Server Without an API Key#

Goal: Understand which tools work without an API key, so you can try the server before setting up authentication.

Time: Approximately 5 minutes to read; ongoing use

Prerequisites#

None. That is the point of this guide.

You need the GW2 MCP Server connected to an AI client (Claude Desktop, Claude Code, LM Studio, etc.), but no API key configured. See Getting Started for installation steps – you can skip Step 2 (creating an API key) and leave GW2_API_KEY empty or remove the env block entirely.

Wiki Search

Mon, 01 Jan 0001 00:00:00 +0000

How to Search the GW2 Wiki#

Goal: Search the official Guild Wars 2 wiki for game information directly through your AI assistant.

Time: Approximately 3 minutes

Prerequisites#

None. Wiki search is a public tool that works without an API key.

Steps#

1. Ask a wiki search question#

Ask your AI: “Search the wiki for Dragon Bash”

Your assistant calls the wiki_search tool with your query. The search runs against the official Guild Wars 2 wiki at wiki.guildwars2.com.

Add a New Tool

Mon, 01 Jan 0001 00:00:00 +0000

Add a New Tool#

Goal: Add a new MCP tool to the GW2 MCP Server, from API struct to registered handler.

Time: Approximately 20 minutes

This guide walks through adding a hypothetical get_titles tool that retrieves title metadata from the GW2 /v2/titles endpoint. The pattern shown here applies to any new tool.

Prerequisites#

Go 1.24+ installed
Repository cloned and building (make build passes)
Familiarity with the project architecture

Steps#

1. Define the response struct#

Open internal/gw2api/client.go and add a struct that matches the GW2 API response shape. Place it near the other game metadata types (after the Mini struct is a good location).

Configure MCP Clients

Mon, 01 Jan 0001 00:00:00 +0000

How to Configure MCP Clients#

Goal: Connect your MCP client to the GW2 MCP Server so you can query Guild Wars 2 data from your AI assistant.

Prerequisites#

Before starting, you should have:

A GW2 API key created at Guild Wars 2 API Key Management – see API Key Scopes for which permissions to enable
Either Docker installed or the gw2-mcp binary downloaded/built – see Getting Started for installation steps

Claude Desktop#

Open Claude Desktop and navigate to Settings > Developer > Edit Config. This opens the claude_desktop_config.json file.

Contribute

Mon, 01 Jan 0001 00:00:00 +0000

How to Contribute to GW2 MCP Server#

Goal: Set up a local development environment, run quality checks, and submit a pull request to the GW2 MCP Server project.

Time: Approximately 20 minutes for initial setup.

Prerequisites#

Before starting, you should have:

Go 1.24+ installed – verify with go version
Git installed and configured with your GitHub account
Make available on your system (GNU Make on Linux/macOS, or via Git Bash / MSYS2 on Windows)
A GitHub account with permissions to fork repositories

Development Setup#

1. Fork and clone the repository#

Fork the repository on GitHub, then clone your fork locally: