Warhammer MCP Server

Warhammer 40K and Kill Team rules, stats, and game flow MCP server

Local serverstdio

What is the Warhammer MCP server?

Warhammer MCP server exists for a simple reason — assistants are far more useful when they can act on Warhammer directly instead of describing what you should do. Warhammer 40K and Kill Team rules, stats, and game flow MCP server.

Setting it up

The server ships on npm as warhammer-oracle, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

What the assistant can call

Once Warhammer is connected, these are the calls the assistant has available:

  • lookup_unit — Look up a unit datasheet by name. Returns stat profiles, unit size (model count), ranged and melee weapons, abilities, and keywords
  • lookup_keyword — Look up a keyword or rule. Returns the official definition, a plain English explanation, examples, and which game modes it applies to
  • lookup_phase — Look up a game phase by name. Returns step-by-step instructions and tips
  • search_units — Search units by name, faction, keywords, or ability text. Returns a compact list (max 10 results) with faction, points, and keywords
  • compare_units — Compare 2-4 units side by side. Shows full datasheets for each unit in a single response
  • game_flow — Show the full turn sequence for a game mode, or highlight where you are in the turn and what comes next
  • lookup_stratagem — Look up a Warhammer 40,000 stratagem by name. Returns CP cost, phase timing, target, and effect
  • search_stratagems — Search stratagems by name, faction, phase, or detachment. Returns a compact list (max 10)
  • lookup_detachment — Look up a detachment by name. Returns the detachment ability, available enhancements, and associated stratagems
  • lookup_enhancement — Look up a character enhancement by name. Returns points cost, detachment, and effect
  • lookup_ploy — Look up a Kill Team ploy by name. Returns type (strategic/tactical), CP cost, timing, and effect
  • wound_calculator — Calculate expected damage output for an attack profile against a target. Handles re-rolls, weapon keywords (Lethal Hits, Devastating Wounds

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Warhammer.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the warhammer mcp server does with a few real requests.

Choosing this one

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Warhammer's toolset — lookup_unit, lookup_keyword, lookup_phase and 11 more — is a fair guide to whether it matches your workflow. It is maintained by gregario; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Warhammer's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
lookup_unitLook up a unit datasheet by name. Returns stat profiles, unit size (model count), ranged and melee weapons, abilities, and keywords.
lookup_keywordLook up a keyword or rule. Returns the official definition, a plain English explanation, examples, and which game modes it applies to.
lookup_phaseLook up a game phase by name. Returns step-by-step instructions and tips.
search_unitsSearch units by name, faction, keywords, or ability text. Returns a compact list (max 10 results) with faction, points, and keywords.
compare_unitsCompare 2-4 units side by side. Shows full datasheets for each unit in a single response.
game_flowShow the full turn sequence for a game mode, or highlight where you are in the turn and what comes next.
lookup_stratagemLook up a Warhammer 40,000 stratagem by name. Returns CP cost, phase timing, target, and effect.
search_stratagemsSearch stratagems by name, faction, phase, or detachment. Returns a compact list (max 10).
lookup_detachmentLook up a detachment by name. Returns the detachment ability, available enhancements, and associated stratagems.
lookup_enhancementLook up a character enhancement by name. Returns points cost, detachment, and effect.
lookup_ployLook up a Kill Team ploy by name. Returns type (strategic/tactical), CP cost, timing, and effect.
wound_calculatorCalculate expected damage output for an attack profile against a target. Handles re-rolls, weapon keywords (Lethal Hits, Devastating Wounds, Sustained Hits, Torrent), invulnerable saves, and Feel No Pain.
determine_primary_missionDetermine each player's Primary Mission from their Force Dispositions (11th Edition Matched Play). Each player's mission is looked up from their *opponent's* Force Disposition — in a non-mirror matchup, the two players g
lookup_crusadeLook up Crusade content (narrative play). Returns Crusade rules, relics, battle traits, and upgrades.

How to install the Warhammer MCP server

{
  "mcpServers": {
    "warhammer-oracle": {
      "command": "npx",
      "args": ["-y", "warhammer-oracle"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Warhammer to lookup unit.
  • Use Warhammer to lookup keyword.
  • Use Warhammer to lookup phase.

Frequently asked questions

It connects Warhammer to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (lookup_unit, lookup_keyword, lookup_phase, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Warhammer directly.