GW2 MCP Server
About
Connects Large Language Models (LLMs) with Guild Wars 2 data sources. Requires a Guild Wars 2 API key for wallet functionality.
Details
- Author
- alyxpink
- Categories
- Other, API
Jump to
Setup
Install GW2 MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/alyxpink/gw2-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
A Model Context Provider (MCP) server for Guild Wars 2 that bridges Large Language Models (LLMs) with Guild Wars 2 data sources.
- Wiki Search: Search and retrieve content from the Guild Wars 2 wiki
- Wallet Information: Access user wallet and currency data via GW2 API
- Smart Caching: Efficient caching with appropriate TTL for static and dynamic data
- Rate Limiting: Respectful API usage with built-in rate limiting
- Extensible Architecture: Modular design for easy feature additions
- Go 1.24 or higher
- Guild Wars 2 API key (for wallet functionality)
git clone https://github.com/AlyxPink/gw2-mcp.git cd gw2-mcp
The MCP server communicates via stdio (standard input/output):
You can configure Claude Desktop, LM Studio, or other LLM tools to interact with the server using this configuration:
{ "mcpServers": { "gw2-mcp": { "command": "docker", "args": [ "run", "--rm", "-i", "alyxpink/gw2-mcp:v1" ] } } }
The server provides the following tools for LLM interaction:
Search the Guild Wars 2 wiki for information.
- query(required): Search query string
- limit(optional): Maximum number of results (default: 5)
{ "tool": "wiki_search", "arguments": { "query": "Dragon Bash", "limit": 3 } }
Retrieve user's wallet information including all currencies.
- api_key(required): Guild Wars 2 API key with account scope
{ "tool": "get_wallet", "arguments": { "api_key": "YOUR_GW2_API_KEY" } }
Get information about Guild Wars 2 currencies.
- ids(optional): Array of specific currency IDs to fetch
{ "tool": "get_currencies", "arguments": { "ids": [1, 2, 3] } }
The server provides the following resources:
Complete list of all Guild Wars 2 currencies with metadata.
To use wallet functionality, you need a Guild Wars 2 API key:
- VisitGuild Wars 2 API Key Management
- Create a new API key with the following permissions:
- account- Required for wallet access
- wallet- Required for currency information
Security Note:API keys are hashed before caching for security. Never share your API key.
The server implements intelligent caching:
- Static Data(currencies, wiki content): Cached for 24 hours to 1 year
- Dynamic Data(wallet balances): Cached for 5 minutes
- Search Results: Cached for 24 hours
The project follows Clean Architecture principles:
internal/ ├── server/ # MCP server implementation ├── cache/ # Caching layer ├── gw2api/ # GW2 API client └── wiki/ # Wiki API client
- Format code withgofumpt
- Lint withgolangci-lint
- Write unit tests for core functionality
- Follow conventional commit messages
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Run linting and formatting
- Submit a pull request
GNU Affero General Public License v3.0 - see LICENSE file for details.
- Guild Wars 2 APIfor providing comprehensive game data
- Guild Wars 2 Wikifor extensive game documentation
- MCP Gofor the MCP implementation framework
Fetches Pokémon data from the PokeAPI and exposes it through a standardized MCP interface.
Access player data, game records, and public information from Chess.com's Published Data API.
Interact with the EVE Online ESI API to access game data and services.
An MCP server for interacting with the EVE Online ESI (EVE Swagger Interface) API.
Access NEXON MapleStory open API data for character info, union details, guild data, rankings, and game mechanics.
Access Team Fight Tactics (TFT) game data using the Riot Games API.
Global postal code lookups, validation, and city search for 70+ countries. Sub-10ms responses.
Connect to any financial, utility, billing accounts; retrieve balance, transactions, payment and identity data instantly.
A healthcare MCP server for EMRs like Cerner and Epic, providing tools to interact with FHIR data and medical resources.
65+ AI tools as an MCP server. Research, write, code, scrape, translate, analyze, agent memory, workflows. Pay per call from $0.006.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
