gregario/warhammer-oracle

Warhammer 40K rules, unit stats, and game flow. An MCP server.
---
Ask your AI assistant about datasheets, stratagems, detachments, enhancements, keywords, phase sequences, wound math, and more. Covers Warhammer 40,000 (10th and 11th Edition), Combat Patrol, and Kill Team.
**Editions:** 40K unit/detachment/enhancement lookups default to **11th Edition**. Pass game_mode: "40k_10e" to any tool for 10th Edition data instead — 10th Edition support isn't going away. Turn sequences/phases, core keywords, and Core Stratagems are hand-curated from the 11th Edition Core Rules. Detachment-specific stratagems are hand-curated per faction, layered the same way the tabletop rules are layered: an 11th Edition Faction Pack detachment overrides the base Codex where the pack details it in full, and the unrevised Codex baseline applies everywhere else.
Installation
Or install globally:
Configuration
Claude Desktop
Add to your claude_desktop_config.json:
Claude Code
Tools
lookup_unit
Look up a unit datasheet by name. Returns stat profiles, unit size (model count), ranged and melee weapons, abilities, and keywords.
When a name has different datasheets, the tool lists the matching factions. If a name and faction still have multiple datasheets, it also lists their IDs; pass the faction and one datasheet_id back to select it.
**Parameters:** unit_name (required), faction (optional), datasheet_id (optional, exact ID shown for same-faction variants), game_mode (optional: 40k/40k_11e (default, 11th Edition), 40k_10e, 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.
**Parameters:** keyword (required), game_mode (optional)
lookup_phase
Look up a game phase by name. Returns step-by-step instructions and tips.
**Parameters:** phase_name (required), game_mode (optional, default: 40k)
search_units
Search units by name, faction, keywords, or ability text. Returns a compact list (max 10 results) with faction, points, and keywords.
**Parameters:** query (required), faction (optional), ability (optional), max_points (optional), game_mode (optional: 40k/40k_11e (default), 40k_10e, combat_patrol, kill_team)
compare_units
Compare 2-4 units side by side. Shows full datasheets for each unit in a single response.
**Parameters:** units (required, array of 2-4 unit names), game_mode (optional: 40k/40k_11e (default), 40k_10e, combat_patrol, kill_team)
game_flow
Show the full turn sequence for a game mode, or highlight where you are in the turn and what comes next.
**Parameters:** current_phase (optional), game_mode (optional, default: 40k)
lookup_stratagem
Look up a Warhammer 40,000 stratagem by name. Returns CP cost, phase timing, target, and effect.
**Parameters:** name (required), faction (optional), phase (optional), detachment (optional)
search_stratagems
Search stratagems by name, faction, phase, or detachment. Returns a compact list (max 10).
**Parameters:** query (required), faction (optional), phase (optional), detachment (optional)
lookup_detachment
Look up a detachment by name. Returns the detachment ability, available enhancements, and associated stratagems.
**Parameters:** name (required), faction (optional), game_mode (optional: 40k/40k_11e (default), 40k_10e)