The Warhammer Oracle MCP server gives your AI assistant access to Warhammer 40K rules, unit stats, and game flow information across three game modes: Warhammer 40,000, Combat Patrol, and Kill Team.
Look up unit datasheets – Retrieve stats, weapons, abilities, and keywords for any of 2,642 Warhammer 40K units or 506 Kill Team operatives, with optional faction and game mode filters.
Look up keywords/rules – Get official definitions, plain English explanations, and examples for game mechanics like "Devastating Wounds" or "Feel No Pain".
Look up game phases – Get step-by-step instructions and tips for specific phases (e.g. Shooting, Command, or Firefight phases) in a given game mode.
Search units – Find units by name, faction, or keyword, with optional points-cost filters (returns up to 10 results).
Compare units – Side-by-side comparison of 2–4 units or operatives, showing full datasheets including stats, weapons, abilities, and keywords.
View game flow – Display the full turn sequence for a game mode, or see what comes next based on your current phase.
All data is embedded locally (no network calls required), covering 2,642 unit datasheets, 506 Kill Team operatives, 55 shared rules, 25 curated keywords, and 3 game mode turn sequences.
warhammer-oracle
Warhammer 40K rules, unit stats, and game flow — as an MCP server.
Ask your AI assistant about datasheets, keywords, phase sequences, and more. Covers Warhammer 40,000, Combat Patrol, and Kill Team.
Installation
npx warhammer-oracleOr install globally:
npm install -g warhammer-oracleConfiguration
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"warhammer-oracle": {
"command": "npx",
"args": ["-y", "warhammer-oracle"]
}
}
}Claude Code
claude mcp add warhammer-oracle -- npx -y warhammer-oracleTools
lookup_unit
Look up a unit datasheet by name. Returns stat profiles, ranged and melee weapons, abilities, and keywords.
"Look up the Intercessor Squad datasheet"
"What are the stats for a Leman Russ Battle Tank?"Parameters: unit_name (required), faction (optional), game_mode (optional: 40k, combat_patrol, kill_team)
lookup_keyword
Look up a keyword or rule. Returns the official definition, a plain English explanation, examples, and which game modes it applies to.
"What does Devastating Wounds do?"
"Explain the Feel No Pain keyword"Parameters: keyword (required), game_mode (optional)
lookup_phase
Look up a game phase by name. Returns step-by-step instructions and tips.
"Walk me through the Shooting phase"
"How does the Firefight phase work in Kill Team?"Parameters: phase_name (required), game_mode (optional, default: 40k)
search_units
Search units by name, faction, or keywords. Returns a compact list (max 10 results) with faction, points, and keywords.
"Find all Necron units under 100 points"
"Search for units with the Fly keyword"Parameters: query (required), faction (optional), max_points (optional), game_mode (optional)
compare_units
Compare 2-4 units side by side. Shows full datasheets for each unit in a single response.
"Compare Intercessors vs Tactical Marines"
"Compare the Leman Russ, Predator, and Hammerhead side by side"Parameters: units (required, array of 2-4 unit names)
game_flow
Show the full turn sequence for a game mode, or highlight where you are in the turn and what comes next.
"Show me the 40K turn sequence"
"I'm in the Shooting phase — what's next?"
"Show the Kill Team turn sequence"Parameters: current_phase (optional), game_mode (optional, default: 40k)
Data
All data is embedded at build time — no network calls at runtime.
Category | Count | Source |
40K unit datasheets | 2,642 | |
Kill Team operatives | 506 | |
Shared rules | 33 (40K) + 22 (KT) | BSData |
Curated keywords | 25 | Hand-written, plain English |
Game mode sequences | 3 | Hand-curated (40K, Combat Patrol, Kill Team) |
Game modes
Warhammer 40,000 (40k) — full-scale battles
Combat Patrol (combat_patrol) — smaller, starter-friendly format
Kill Team (kill_team) — squad-level skirmish game
Development
npm install
npm run build
npm testTo refresh unit data from BSData:
npm run fetch-data
npm run buildLicense
MIT (for the MCP server code).
Unit data sourced from the BSData community project. Game rules and army rules are the intellectual property of Games Workshop. This tool provides reference data for personal use during gameplay.