Skip to content
MCP server

Praetorium

Free Warhammer 40,000 rules, datasheets, points and missions, plus rosters when signed in

Pricing
Open source
Platforms
Web, iOS, Android
Runs
Remotely
Version
1.3.0
Listing updated
3 days ago

About Praetorium

Praetorium is an open-source MCP server for games and play. It runs as a hosted remote server, so there is nothing to install locally.

Praetorium is a free, open source Warhammer 40,000 army builder, combat simulator and battle tracker, and its MCP server exposes that data to assistants. The public side covers rules, datasheets, points and missions without an account; signing in unlocks managing rosters and battles.

Around it the app offers live points and legality checks, import of Games Workshop text exports from BattleBase or New Recruit, ability reminders by phase, 1v1, 2v1 and 2v2 games, sealed-roster tournaments, a 600-point King of the Colosseum format, battle replay and win statistics. The site shows a public leaderboard and apps for iPhone and Android, with Android in beta.

The reference, simulator and saved lists keep working offline after a visit has loaded. Every feature is free; sponsors on GitHub get a badge, not extra features.

Install

Run in a terminal

claude mcp add --transport http praetorium https://praetorium.gg/mcp

Add to Settings → Connectors → Add custom connector

https://praetorium.gg/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "praetorium": {
      "url": "https://praetorium.gg/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "praetorium": {
      "type": "http",
      "url": "https://praetorium.gg/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "praetorium": {
      "serverUrl": "https://praetorium.gg/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "praetorium": {
      "type": "http",
      "url": "https://praetorium.gg/mcp"
    }
  }
}

Tools this server provides (43)

Read directly from the server.

list_my_rosters
Lists the rosters saved to the signed-in Praetorium account. Requires mcp:read.
get_my_roster
Returns one roster owned by the signed-in player, by an id from list_my_rosters. summary names each unit with its points, models, wargear, enhancements, Warlord and attachments, and gives the total and any problems that stop the list being fielded; it is null while army data is unavailable. roster holds the saved choices by catalogue id, the shape save_roster takes. Requires mcp:read.
list_my_battles
Lists the signed-in player's battles, newest first, up to 25 a page, narrowed and ordered as the battles page is. Each battle has its url, status, your result, ending, size, mission and one entry per seat (you, side, army, faction, detachments, score with its primary and secondary halves, rating change). A filtered page can come back short or empty while nextCursor is set; keep paging until nextCu
get_my_stats
Returns the signed-in player's record as their profile shows it, over their latest 200 finished battles except practice games, optionally narrowed. record: battles, won, lost, drawn, rate (win rate 0 to 1, a draw counting half), going first and second, average points, streaks, command points, stratagems and secondary cards used, primary missions, opposing factions and opponents. performance: the s
save_roster
Saves a complete roster. Pass its id to edit an owned roster; omit id to create one. limit is the battle size (1000, 2000 or 3000 points, or 600 for King of the Colosseum), which sets detachment points, enhancement and unit limits. pointsBudget optionally replaces only its points total (500 to 10000, not King of the Colosseum); omit it to keep a saved budget, or send null for the standard total. R
set_roster_visibility
Changes the visibility of an owned roster. Requires mcp:write.
list_my_opponents
Lists the friends the signed-in player can seat in create_battle, by id. Everyone at the table needs an account: someone without one signs up and becomes a friend first. To play a game alone, create_battle takes bothSides instead. Requires mcp:read.
create_battle
Creates a battle in setup and returns its token. With nobody named it starts a draft with only you at the table, reusing your untouched draft with the same mission pack, and returns joinUrl: anyone with an account who opens it joins the open place, and the draft becomes a battle once every place is filled and every army chosen. opponentId seats one opponent from list_my_opponents for a duel; oppon
get_my_battle
Returns the signed-in player's seated view of a battle (battle) and what it expects next (next). next says what the battle expects: in setup, each step in table order with done and the command that answers it, the battlefields and secondary cards on offer, and begin.refusal until begin-battle would be accepted; in play, the round, phase, active player, a pending settlement of the previous turn, ca
submit_battle_action
Appends one command to a battle's log, only when expectedSeq equals the battle's current seq from get_my_battle. The answer's result.outcome is appended, stale (someone recorded first: read the battle again) or refused with the reason. Any seated player may record for any seat with playerId, as at a shared table. Each command kind says when it is used; follow get_my_battle's next for the order. Re
get_my_battle_report
Returns a battle's log as its report reads it, oldest first and 200 entries a page: each entry's seq, round, phase, the player id that recorded it (by) and a sentence saying what happened. Pass nextAfter as after for the next page. Totals and the result are in get_my_battle. Requires mcp:read.
delete_battle
Permanently deletes a battle the signed-in player created, for every player in it, with its result. Only the creator can. Confirm with the player first. Requires mcp:write.
search_reference
Searches Praetorium’s missions, force dispositions, deployments, terrain, rules, detachments, and datasheets by name, number, keyword, and value. Returns bounded excerpts with canonical URLs, source revisions, and attribution. Rules text is not included; records point to it upstream.
get_reference
Reads the complete bounded document returned by search_reference, with its revisions and attribution. A section that withholds rules text lists textSources: the pinned upstream file and record id to fetch if you need the wording.
get_reference_record
Returns the structured record behind a search result, including mission cards, force dispositions (missions by opposing disposition, detachments that offer them), deployments, terrain geometry, detachments, and datasheets. Records that withhold rules text carry textSources pointing at the pinned upstream file and record id.
list_factions
Lists the factions that can be used to narrow reference searches.
list_reference
Discovers available factions, mission packs, rule documents, reference kinds, and active source revisions.
list_units
Returns every pickable unit in one bounded response with unit-size costs, composition, attachment relationships, roster limits, roles, keywords, and links. Without a detachment it also lists every detachment the faction can take, with its detachment points, Force dispositions, rule names and enhancement costs, so you can compare them before choosing. Include a detachment, including one a chapter t
get_mission_matchup
Resolves a pack and two force dispositions to the primary mission each side plays (its card: scoring awards, caps, actions, timing), the terrain layouts and deployments for the pairing, and canonical URLs and reference ids for each. Pass each value by id, slug, or name; an unknown or ambiguous value is refused with the valid options. Rules text is withheld; cards point to it through textSources.
simulate_combat
Runs Praetorium's exact combat simulator for one attacking unit, with any attached leaders, against one defending unit: shooting, melee, and shooting followed by melee. Returns expected models destroyed, expected wounds lost, the chance to destroy the unit, cumulative odds, weapons used, the wargear each unit fielded, the rule and weapon-mode choices each side can change, datasheet citations, and
optimize_loadout
Searches the attacking unit's legal wargear, with any attached leaders, for the loadout most likely to destroy the defender, then the most models destroyed, then the most wounds, as the simulator's Optimize does. Takes the same sides as simulate_combat; the attacker's choices and spreads are where the search starts, and model counts, enhancements and detachment upgrades stay fixed. mode ranks shoo
list_data_updates
Lists the points and datasheet updates the installed army data recorded, newest first, as the /data-updates pages show them. Each update has its UTC time, url, total change count and omitted (changes past its stored bound). Without faction, each update lists only the factions it reached with their change counts. With faction, it lists that faction's changes in groups: kind (datasheet-points, datas
check_roster
Prices a roster and lists every problem that stops it being fielded, without saving it or needing an account: the same summary get_my_roster gives a saved list. summary names each unit with its points, models, wargear, enhancements, Warlord and attachments, and gives the total; problems is empty when the list is legal.
grade_roster
Grades what a roster can do on the table, as the roster builder's grades do: score 0 to 100 and grade A to D overall and per category (board control, mobility, damage against reference targets, durability), placed among tournament lists of the same battle size and of comparedWith's armies. A typical tournament list scores about 70. missing names the reference targets nothing in the list can take h
get_unit_options
Lists what each named unit lets a roster pick set, with names first and the ids a pick takes beside them: its sizes, its toggles (key of the Warlord toggle: set toggles {key: 1} on exactly one CHARACTER), and every choice group (wargear, enhancement, detachment upgrade, unit composition) with its options' ids, points, how many the default loadout takes (taken), and per-option min and max. A choice
compare_rosters
Runs every unit of one roster, with its attached units, against every unit of another in Praetorium's exact combat simulator, as the simulator's whole-roster table does: one call instead of a simulate_combat call per pairing. attackers and defenders list the units in roster order, entries giving their 1-based roster entries as check_roster numbers them. Each phase's cells[attacker][defender] holds
import_roster
Reads a pasted army list into a roster draft without saving it or needing an account, as the site's import does. Takes the whole text export from the official Warhammer 40,000 app, New Recruit, BattleBase, ListForge, Warscribe, WTC layouts or Praetorium, or a Praetorium exchange code (PR1./PR2.). draft is the list in the shape check_roster and save_roster take, or null when no faction matched. rev
export_roster
Writes a roster as the site's text export, the official app's layout that tournament organisers and other list builders read, without saving it or needing an account. Takes the shape save_roster takes, such as import_roster's draft or get_my_roster's roster. text is the export; code is a Praetorium exchange code that carries the exact list into Praetorium, or null when the list is too large for on
delete_roster
Permanently deletes one of the signed-in player's saved rosters, by an id from list_my_rosters, and ends any loan of it to a friend. Battles it was fielded in keep their own record. It cannot be undone, so confirm the roster's name with the player first; set_roster_archived hides a list without losing it. Requires mcp:write.
copy_roster
Saves a copy of a roster to the signed-in player's account: one of their own from list_my_rosters, or a public or unlisted one they can open. variant true keeps the copy grouped with the original as an alternative version, which only works on their own rosters; false makes a standalone copy. The copy takes the player's default visibility, which is public unless they changed it, whatever the origin
set_roster_archived
Archives one of the signed-in player's saved rosters, which moves it out of their main roster list without deleting it, or restores it with archived false. Requires mcp:write.
get_my_collection
Returns the models the signed-in player owns, as their collection page keeps them, grouped by faction. Each entry's id and slug are the datasheet's, the same as list_units gives, with the models owned, how many are built and painted, and countsAs: other datasheets the player says those models can also be fielded as. A datasheet the current army data no longer has is named "A datasheet from earlier
list_my_events
Lists the signed-in player's groups, tournaments and hidden-list games (a group's game where everyone seals a list in secret before the reveal), each with its token, url, dates and your place in it: membership, entry status, whether you sealed a list, and the size you seal at. Pass includeOpen to also list public groups and tournaments you could join. Read one with get_my_group or get_my_event. Re
get_my_group
Returns a group as its page shows it to the signed-in player: members (ids for create_battle's opponentIds), the leaderboard, recent finished games and your unfinished ones, its current hidden-list games, and its league with the table and your fixtures. An open fixture's start is the create_battle input that plays it for the league. A private group shows only its name until you are a member. Requi
get_my_event
Returns a tournament or hidden-list game as the signed-in player may see it: rules (format, size, points, what lists may break), dates, entrants with whether each sealed, your entry, Swiss rounds with your table and opponent, standings once lists are revealed, your battles in it, and todo: what you still need to do. Before the reveal nobody's list is shown but your own name for it. Requires mcp:re
join_group
Joins a group by its token, as its invite link does. A group whose organizers approve each member answers pending until they let you in. Requires mcp:write.
join_league
Joins the draft league of a group you are a member of. Nobody can join once an organizer publishes its fixtures. Requires mcp:write.
join_event
Enters the signed-in player in a tournament by its token, as its invite link does, or in a hidden-list game of a group they belong to. A tournament whose organizer approves each player answers pending until they let you in. Closed once lists are revealed or the roster deadline passes. Requires mcp:write.
submit_event_roster
Seals one of the signed-in player's saved rosters for a tournament or hidden-list game, or replaces the list sealed before, with the site's checks: battle size, points, the event's house rules, a Warlord, and the roster deadline. Sealing stores a copy; later edits to the saved roster don't change it. Before the reveal only you and an assigned ally can read it. Check the roster with get_my_roster f
check_in_event
Marks the signed-in player as arrived at a Swiss tournament, or not, before round 1 is paired; an organizer may drop players who haven't checked in. Requires mcp:write.
start_event_battle
Starts the battle for a revealed tournament or hidden-list game with both sealed lists attached, as Start battle on its page does, and returns its token for get_my_battle and submit_battle_action. In Swiss rounds omit opponentId to play your current table; Swiss refuses anyone else. Otherwise name the opponent from get_my_event's entrants, and for a team game the ally and second opponent too. For
report_table_result
Records the final score of the signed-in player's Swiss table, for a game not tracked on Praetorium, and finishes its battle; it counts for the tournament's standings but not the leaderboard. Report only a score both players agree. Defaults to your table this round. A result locks once the next round is paired; then only the organizer can reopen it. Requires mcp:write.
get_skill
Returns step-by-step guidance for a task, including the Warhammer 40,000 knowledge and tool order it needs. Read the matching skill before starting the task. Skills: answer-a-rules-question: Answer a Warhammer 40,000 rules question from Praetorium's reference, citing the source. Use when someone asks how a rule, ability, stratagem, keyword, datasheet value or mission works. build-a-roster: Plan a

What it does

Army builder
Live points and legality as you add units.
Combat simulator
Compare loadouts and see shooting and melee odds.
Battle tracker
Track phases, scores, CP, stratagems and casualties.
List import
Paste exports from BattleBase or New Recruit.
Tournaments
Sealed-roster events with revealed lists.
Offline reference
Reference and lists work offline after loading.

Good for

  • Check a list's points before a game
  • Look up a unit's datasheet in chat
  • Estimate odds of a shooting attack
  • Review past battle results

Pricing

Open source

Free; open source

Prices change. Check praetorium.gg before you buy.

Praetorium FAQ

Is it free?

Yes, every feature is free; sponsorship only gives a badge.

Do I need an account?

Not for the public reference; saving lists and playing requires one.

Is there a mobile app?

Yes, iPhone and Android, with Android in beta.

Is it open source?

Yes.

Is Praetorium free?

Yes. Praetorium is open source, so you can use and self-host it for free.

How do I add Praetorium to Claude Code?

Run this command in your terminal: claude mcp add --transport http praetorium https://praetorium.gg/mcp

What are the best alternatives to Praetorium?

The closest alternatives to Praetorium are AvatarSay — Fictional Character & Talking Video MCP, VfxSmith, Born Then, Haze City and Vectoroids.

Alternatives to Praetorium

  1. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  2. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  3. Haze City

    MCP server

    MCP server for agents to look around and build in a shared 3D world

    • 17 tools
    • Remote
    • Open source
    • Games and play
  4. Vectoroids

    MCP server

    A first-person 3D asteroids game with a scanner, playable by humans and agents

    • 6 tools
    • Remote
    • Free
    • Games and play
  5. Vector Abyss

    MCP server

    Play a Tempest-style 3D tube shooter, or let an AI agent play it turn by turn

    • 6 tools
    • Remote
    • Free
    • Knowledge and memory