{
  "markdown": "<!-- mcp-name: io.github.gregario/warhammer-oracle -->\n<p align=\"center\">\n  <h1 align=\"center\">Warhammer Oracle</h1>\n  <p align=\"center\">Warhammer 40K rules, unit stats, and game flow. An MCP server.</p>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/warhammer-oracle\"><img src=\"https://img.shields.io/npm/v/warhammer-oracle.svg\" alt=\"npm version\"></a>\n  <a href=\"https://www.npmjs.com/package/warhammer-oracle\"><img src=\"https://img.shields.io/npm/dm/warhammer-oracle.svg\" alt=\"npm downloads\"></a>\n  <a href=\"https://github.com/gregario/warhammer-oracle/blob/main/LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"MIT Licence\"></a>\n  <a href=\"https://nodejs.org\"><img src=\"https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg\" alt=\"Node.js 18+\"></a>\n  <a href=\"https://modelcontextprotocol.io\"><img src=\"https://img.shields.io/badge/MCP-compatible-purple.svg\" alt=\"MCP Compatible\"></a>\n  <a href=\"https://github.com/sponsors/gregario\"><img src=\"https://img.shields.io/badge/sponsor-♥-ea4aaa.svg\" alt=\"Sponsor\"></a>\n  <a href=\"https://glama.ai/mcp/servers/gregario/warhammer-oracle\"><img src=\"https://glama.ai/mcp/servers/gregario/warhammer-oracle/badges/score.svg\" alt=\"warhammer-oracle MCP server\"></a>\n</p>\n\n---\n\nAsk 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.\n\n[![warhammer-oracle MCP server](https://glama.ai/mcp/servers/gregario/warhammer-oracle/badges/card.svg)](https://glama.ai/mcp/servers/gregario/warhammer-oracle)\n\n**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.\n\n## Installation\n\n```bash\nnpx warhammer-oracle\n```\n\nOr install globally:\n\n```bash\nnpm install -g warhammer-oracle\n```\n\n## Configuration\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"warhammer-oracle\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"warhammer-oracle\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add warhammer-oracle -- npx -y warhammer-oracle\n```\n\n## Tools\n\n### `lookup_unit`\n\nLook up a unit datasheet by name. Returns stat profiles, unit size (model count), ranged and melee weapons, abilities, and keywords.\n\n```\n\"Look up the Intercessor Squad datasheet\"\n\"What are the stats for a Leman Russ Battle Tank?\"\n```\n\n**Parameters:** `unit_name` (required), `faction` (optional), `game_mode` (optional: `40k`/`40k_11e` (default, 11th Edition), `40k_10e`, `combat_patrol`, `kill_team`)\n\n### `lookup_keyword`\n\nLook up a keyword or rule. Returns the official definition, a plain English explanation, examples, and which game modes it applies to.\n\n```\n\"What does Devastating Wounds do?\"\n\"Explain the Feel No Pain keyword\"\n```\n\n**Parameters:** `keyword` (required), `game_mode` (optional)\n\n### `lookup_phase`\n\nLook up a game phase by name. Returns step-by-step instructions and tips.\n\n```\n\"Walk me through the Shooting phase\"\n\"How does the Firefight phase work in Kill Team?\"\n```\n\n**Parameters:** `phase_name` (required), `game_mode` (optional, default: `40k`)\n\n### `search_units`\n\nSearch units by name, faction, keywords, or ability text. Returns a compact list (max 10 results) with faction, points, and keywords.\n\n```\n\"Find all Necron units under 100 points\"\n\"Search for units with the Fly keyword\"\n\"Show me units with Deep Strike\"\n```\n\n**Parameters:** `query` (required), `faction` (optional), `ability` (optional), `max_points` (optional), `game_mode` (optional: `40k`/`40k_11e` (default), `40k_10e`, `combat_patrol`, `kill_team`)\n\n### `compare_units`\n\nCompare 2-4 units side by side. Shows full datasheets for each unit in a single response.\n\n```\n\"Compare Intercessors vs Tactical Marines\"\n\"Compare the Leman Russ, Predator, and Hammerhead side by side\"\n```\n\n**Parameters:** `units` (required, array of 2-4 unit names), `game_mode` (optional: `40k`/`40k_11e` (default), `40k_10e`, `combat_patrol`, `kill_team`)\n\n### `game_flow`\n\nShow the full turn sequence for a game mode, or highlight where you are in the turn and what comes next.\n\n```\n\"Show me the 40K turn sequence\"\n\"I'm in the Shooting phase — what's next?\"\n\"Show the Kill Team turn sequence\"\n```\n\n**Parameters:** `current_phase` (optional), `game_mode` (optional, default: `40k`)\n\n### `lookup_stratagem`\n\nLook up a Warhammer 40,000 stratagem by name. Returns CP cost, phase timing, target, and effect.\n\n```\n\"What does Fire Overwatch do?\"\n\"Show me the Command Re-roll stratagem\"\n```\n\n**Parameters:** `name` (required), `faction` (optional), `phase` (optional), `detachment` (optional)\n\n### `search_stratagems`\n\nSearch stratagems by name, faction, phase, or detachment. Returns a compact list (max 10).\n\n```\n\"What stratagems can I use in the Fight phase?\"\n\"Show me Gladius Task Force stratagems\"\n```\n\n**Parameters:** `query` (required), `faction` (optional), `phase` (optional), `detachment` (optional)\n\n### `lookup_detachment`\n\nLook up a detachment by name. Returns the detachment ability, available enhancements, and associated stratagems.\n\n```\n\"Show me the Gladius Task Force detachment\"\n\"What does the Warhost detachment do for Aeldari?\"\n```\n\n**Parameters:** `name` (required), `faction` (optional), `game_mode` (optional: `40k`/`40k_11e` (default), `40k_10e`)\n\n### `lookup_enhancement`\n\nLook up a character enhancement by name. Returns points cost, detachment, and effect.\n\n```\n\"What does Adept of the Codex do?\"\n\"Show me Aeldari enhancements\"\n```\n\n**Parameters:** `name` (required), `faction` (optional), `detachment` (optional), `game_mode` (optional: `40k`/`40k_11e` (default), `40k_10e`)\n\n### `lookup_ploy`\n\nLook up a Kill Team ploy by name. Returns type (strategic/tactical), CP cost, timing, and effect.\n\n```\n\"What does the Bolster ploy do in Kill Team?\"\n\"Show me Legionaries ploys\"\n```\n\n**Parameters:** `name` (required), `faction` (optional), `type` (optional: `strategic`, `tactical`)\n\n### `wound_calculator`\n\nCalculate 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.\n\n```\n\"Calculate damage: 10 attacks, BS3+, S5 AP-1 D2 vs T4 Sv3+\"\n\"How much damage does a lascannon do to a Leman Russ?\"\n```\n\n**Parameters:** `attacks`, `hit_skill`, `strength`, `toughness`, `armour_save`, `damage` (all required); `armour_penetration`, `invulnerable_save`, `feel_no_pain`, `reroll_hits`, `reroll_wounds`, `weapon_keywords`, `wounds_per_model`, `game_mode` (all optional)\n\n### `determine_primary_mission`\n\nDetermine 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 get different missions. Returns mission names only, not full scoring/objective text.\n\n```\n\"I picked Take and Hold, my opponent picked Purge the Foe — what are our missions?\"\n\"What's my Primary Mission if I'm Reconnaissance and they're Priority Assets?\"\n```\n\n**Parameters:** `your_disposition`, `opponent_disposition` (both required, one of: `Take and Hold`, `Purge the Foe`, `Reconnaissance`, `Priority Assets`, `Disruption`)\n\n### `lookup_crusade`\n\nLook up Crusade content (narrative play). Returns Crusade rules, relics, battle traits, and upgrades.\n\n```\n\"What Crusade relics can Space Marines take?\"\n\"Show me the Crusade battle traits\"\n```\n\n**Parameters:** `query` (required), `faction` (optional)\n\n## Data\n\nAll data is embedded at build time — no network calls at runtime. Data is synced daily from BSData via GitHub Actions.\n\n| Category | Count | Source |\n|---|---|---|\n| 40K unit datasheets (11th Edition, default) | 2,695 | [BSData/wh40k-11e](https://github.com/BSData/wh40k-11e) |\n| 40K unit datasheets (10th Edition) | 2,666 | [BSData/wh40k-10e](https://github.com/BSData/wh40k-10e) |\n| Kill Team operatives | 519 | [BSData/wh40k-killteam](https://github.com/BSData/wh40k-killteam) |\n| Detachments (11th / 10th Edition) | 259 / 208 | BSData (auto-extracted) |\n| Enhancements (11th / 10th Edition) | 895 / 827 | BSData (auto-extracted) |\n| Stratagems | 1,316 | Hand-curated (Core Rules + detachment-specific per faction) |\n| Kill Team ploys | 14 | Hand-curated (universal + popular factions) |\n| Shared rules (11th / 10th Edition) | 35 / 33 | BSData |\n| Shared rules (Kill Team) | 22 | BSData |\n| Curated keywords | 25 | Hand-written, plain English, 11th Edition Core Rules |\n| Game mode sequences | 3 | Hand-curated (40K, Combat Patrol, Kill Team) |\n| Force Disposition mission matchups | 15 | Hand-curated (5 dispositions, full grid) |\n\n### Game modes\n\n- **Warhammer 40,000** (`40k` / `40k_11e`, default) — full-scale battles, 11th Edition rules\n- **Warhammer 40,000, 10th Edition** (`40k_10e`) — full-scale battles, 10th Edition rules (permanently supported)\n- **Combat Patrol** (`combat_patrol`) — smaller, starter-friendly format\n- **Kill Team** (`kill_team`) — squad-level skirmish game\n\n10th Edition support isn't going away when a newer edition is added — every `game_mode` value, once added, keeps working.\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm test\n```\n\nTo refresh unit data from BSData:\n\n```bash\nnpm run fetch-data\nnpm run build\n```\n\n## License\n\nMIT (for the MCP server code).\n\nUnit data sourced from the [BSData](https://github.com/BSData) community project — [wh40k-10e](https://github.com/BSData/wh40k-10e), [wh40k-11e](https://github.com/BSData/wh40k-11e), and [wh40k-killteam](https://github.com/BSData/wh40k-killteam). Game rules and army rules are the intellectual property of Games Workshop. This tool provides reference data for personal use during gameplay.\n",
  "bytes": 10211,
  "sha": "a5dfc85123551cf0f83bbab5bd4ec76fbec672c9d3135ead75d01045e5af25d6",
  "repo_slug": "gregario/warhammer-oracle",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gregario_warhammer_oracle_4708fd80/readme"
}