Guild Wars 1 Build Compiler
About
GW1 build compiler MCP server: skill data, template code encode/decode, validation, hero roster. Read-only.
Details
- Author
- Graphmaxer
- Downloads
- 213
- Categories
- Other
Jump to
- packages/gw-mcp — the MCP server (transport-agnostic core + stdio entry)
- packages/gw-worker — Streamable HTTP wrapper (Hono), runs on Cloudflare Workers and Node
- claude.ai / Claude app: Settings → Connectors → Add custom connector →
- Claude Code: claude mcp add --transport http gw1 https://…/mcp
- Local HTTP without Cloudflare: pnpm --filter @gw1-mcp/gw-worker dev:node
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Guild Wars 1 Build CompilerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
get_skill
Look up a single GW1 skill by exact English name or by template skill id. Returns full stats (energy, activation, recharge, adrenaline, sacrifice), profession, attribute, campaign, elite flag and description. If the name is not found, returns the closest matches so you can correct spelling. Use this when you already know the exact skill; to discover skills by profession, attribute or name fragment, use search_skills instead.
search_skills
Search the full GW1 skill database by profession, attribute, campaign, elite flag or name fragment (valid values are documented per parameter). Returns compact records, at most `limit` of them alongside a `total` count of every match — a full page is not the whole result, page with offset. Use get_skill for full details.
decode_template
Decode an in-game GW1 skill template code (e.g. "OwpiMypMBg1cxcBAMBdmtIKAA") into professions, attribute allocations and the 8 skills with their stats and descriptions. Whitespace and line wraps in the pasted code are tolerated. This decodes a SINGLE build code; for a multi-hero paw-ned2 team blob, use decode_pawned_team instead.
decode_pawned_team
Decode a paw-ned2 team build blob (the 'pwnd0001...>...<' format shared on PvXwiki team pages and by the paw-ned2 tool) into its individual builds: player/hero label, description, and each skill bar fully decoded. Whitespace and line wraps in the pasted blob are tolerated. For a single (non-team) build code, use decode_template instead.
encode_template
Compile a build (professions, attributes, 8 skills by exact English name) into an official in-game template code. The build is validated first; on rule violations the errors are returned instead of a code. Unknown skill names return closest-match suggestions. IMPORTANT: template codes MUST come from this tool — never write or guess a code by hand, hand-written codes are invalid in-game. If unsure, verify any code with decode_template.
validate_build
Check a build (professions, attributes, 8 skills by exact English name) against Guild Wars 1 rules: one elite max, profession/attribute ownership, primary attributes, duplicates, rank ranges. Returns { valid, errors, warnings } without encoding — use encode_template instead when you also want the template code, since it runs these same rules and refuses on any error.
get_hero
Look up a GW1 hero by name or by id (GWCA HeroID, matching the AccountExport plugin output). Returns profession, campaign and how the hero is unlocked. Remember: heroes can equip any skill unlocked at ACCOUNT level, but NO PvE-only skill at all — including Signet of Capture. validate_build with forHero=true reports each one as an error, not a warning. Use this for one known hero; to browse or filter the roster, use list_heroes instead.
list_heroes
List all GW1 heroes, optionally filtered by profession or campaign name. Useful for team-building: shows which professions are coverable by heroes and how each hero is unlocked.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"guild wars 1 build compiler": {
"gw1-mcp": {
"type": "streamable-http",
"url": "https://gw1-mcp.graphmaxer.workers.dev/mcp"
}
}
}
}McpServers
{
"gw1-mcp": {
"type": "streamable-http",
"url": "https://gw1-mcp.graphmaxer.workers.dev/mcp"
}
}GW1 build compiler MCP server: skill data, template code encode/decode, validation, hero roster. Read-only.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
