
Warhammer Oracle
io.github.gregarioPublished by GitHub account gregariov0.1.1Updated Oct 24, 2026
Warhammer 40K and Kill Team rules, stats, and game flow MCP server
Overview
Local MCP server that gives an assistant Warhammer 40K and Kill Team rules, unit datasheets, stratagems, detachments and game-flow lookups.
- What you can do
- Look up unit datasheets, keywords and rules, with faction and edition filters
- Search and compare units by name, faction, keywords, ability text or points
- Look up stratagems, detachments, enhancements, Kill Team ploys and Crusade content
- Walk through turn sequences and phases, or see what comes next from the current phase
- Calculate expected damage for an attack profile, including re-rolls, weapon keywords, invulnerable saves and Feel No Pain
- Determine Primary Missions from both players' Force Dispositions in 11th Edition matched play
- When to use it
- Useful when you want an assistant to answer Warhammer 40,000 (10th or 11th Edition), Combat Patrol or Kill Team rules questions during list building, rules disputes or learning a phase sequence, without leaving the chat.
- Requirements
- Runs as a local process via npx or a global npm install, so Node.js and npm are needed. No accounts, API keys, environment variables or headers are declared. Data is embedded at build time, so no network access is needed at runtime.
Installation
In SourceWeft
- Open Warhammer Oracle in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
Warhammer Oracle
Warhammer 40K rules, unit stats, and game flow. An MCP server.
[npm version] [npm downloads] [MIT Licence] [Node.js 18+] [MCP Compatible] [Sponsor] [warhammer-oracle 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)
lookup_enhancement
Look up a character enhancement by name. Returns points cost, detachment, and effect.
Parameters: name (required), faction (optional), detachment (optional), game_mode (optional: 40k/40k_11e (default), 40k_10e)
lookup_ploy
Look up a Kill Team ploy by name. Returns type (strategic/tactical), CP cost, timing, and effect.
Parameters: name (required), faction (optional), type (optional: strategic, tactical)
wound_calculator
Calculate 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.
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)
determine_primary_mission
Determine 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.
Parameters: your_disposition, opponent_disposition (both required, one of: Take and Hold, Purge the Foe, Reconnaissance, Priority Assets, Disruption)
lookup_crusade
Look up Crusade content (narrative play). Returns Crusade rules, relics, battle traits, and upgrades.
Parameters: query (required), faction (optional)
Data
All data is embedded at build time — no network calls at runtime. Data is synced daily from BSData via GitHub Actions.
Game modes
- Warhammer 40,000 (
40k/40k_11e, default) — full-scale battles, 11th Edition rules - Warhammer 40,000, 10th Edition (
40k_10e) — full-scale battles, 10th Edition rules (permanently supported) - Combat Patrol (
combat_patrol) — smaller, starter-friendly format - Kill Team (
kill_team) — squad-level skirmish game
10th Edition support isn't going away when a newer edition is added — every game_mode value, once added, keeps working.
Development
To refresh unit data from BSData:
License
MIT (for the MCP server code).
Unit data sourced from the BSData community project — wh40k-10e, wh40k-11e, and wh40k-killteam. Game rules and army rules are the intellectual property of Games Workshop. This tool provides reference data for personal use during gameplay.
Source: README.md at commit 47a25ec
Tools
0Version history
1- v0.1.1LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts