{"id":"io.github.richardsolomou/praetorium","slug":"io-github-richardsolomou-praetorium","title":"Praetorium","description":"Public Warhammer 40K rules, datasheets, points and missions; sign in to manage rosters and battles.","version":"1.3.0","publisher":{"kind":"github","id":"richardsolomou","label":"@richardsolomou on GitHub","url":"https://github.com/richardsolomou"},"website":"https://praetorium.gg","repository":"https://github.com/richardsolomou/praetorium.gg","remotes":[{"type":"streamable-http","url":"https://praetorium.gg/mcp"}],"packages":[],"published":"2026-11-11","updated":"2026-11-11","status":"online","auth":"","latency_ms":3347,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"list_my_rosters","title":"List my saved rosters","description":"Lists the rosters saved to the signed-in Praetorium account. Requires mcp:read.","read_only":true},{"name":"get_my_roster","title":"Read my saved roster","description":"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, any problems that stop the list being fielded, and unchecked restrictions Praetorium could not evaluate; it is null while army data is unavailable. roster holds the saved choices by catalogue id, the s","read_only":true},{"name":"list_my_battles","title":"List my battles","description":"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","read_only":true},{"name":"get_my_stats","title":"Read my battle statistics","description":"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","read_only":true},{"name":"save_roster","title":"Create or edit my roster","description":"Saves a complete roster. Pass its id to edit an owned roster; omit id to create one. Send an empty name to have Praetorium title the list from its army and keep that title current as the list changes; send a name only when the player chooses one, since any name stops the automatic title. limit is the battle size (1000, 2000 or 3000 points, or 600 for King of the Colosseum), which sets detachment p","read_only":false},{"name":"set_roster_visibility","title":"Change my roster visibility","description":"Changes the visibility of an owned roster. Requires mcp:write.","read_only":false},{"name":"list_my_opponents","title":"List who I can play","description":"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.","read_only":true},{"name":"create_battle","title":"Create a battle","description":"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","read_only":false},{"name":"get_my_battle","title":"Read one of my battles","description":"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","read_only":true},{"name":"submit_battle_action","title":"Record a battle action","description":"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","read_only":false},{"name":"get_my_battle_report","title":"Read my battle report","description":"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.","read_only":true},{"name":"delete_battle","title":"Delete my battle","description":"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.","read_only":false},{"name":"list_public_battles","title":"List public battles","description":"Lists the battles anyone may watch on Praetorium, newest first, up to 25 a page, narrowed and ordered as the battles page's public tab is. Each battle has its url, token, status, ending, size, mission and one entry per seat (side, result once finished, army, faction, detachments, score with its primary and secondary halves, rating change). A filtered page can come back short or empty while nextCur","read_only":true},{"name":"get_public_battle","title":"Read a battle as a spectator","description":"Returns any battle by a token from list_public_battles or its link, as a spectator sees it on the site: battle holds its settings, round, phase, result and each player's army, score, command points and secondary cards; missions the mission each side plays; report its log as the report reads it, oldest first and 200 entries a page: each entry's seq, round, phase, the player id that recorded it (by)","read_only":true},{"name":"list_public_rosters","title":"List public rosters","description":"Lists the rosters players have made public on Praetorium, as the rosters page's public tab shows them, most recently saved first unless sort says otherwise. Each roster has its id, url, name, owner, faction, detachments, battle size, points under today's army data and problem, the first thing stopping it being fielded or null when it is legal. total counts every match when it is known. A page can ","read_only":true},{"name":"get_public_roster","title":"Read a public roster","description":"Returns a roster anyone may open, by an id from list_public_rosters or from a roster link someone shared: public and unlisted rosters, never private ones. summary names each unit with its points, models, wargear, enhancements, Warlord and attachments, and gives the total and any problems under today's army data; it is null while army data is unavailable. roster holds the choices by catalogue id, t","read_only":true},{"name":"search_reference","title":"Search the Praetorium game reference","description":"Searches Praetorium’s missions, force dispositions, deployments, terrain, rules, detachments, and datasheets by name, number, keyword, and value, then datasheets and detachments whose abilities, stratagems or enhancements say the words searched for, such as objective control remains for an ability that keeps an objective. Returns bounded excerpts with canonical URLs, source revisions, and attribut","read_only":true},{"name":"get_reference","title":"Read one Praetorium reference result","description":"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.","read_only":true},{"name":"get_reference_record","title":"Read structured Praetorium reference data","description":"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.","read_only":true},{"name":"list_factions","title":"List factions in the Praetorium reference","description":"Lists the factions that can be used to narrow reference searches.","read_only":true},{"name":"list_reference","title":"List the Praetorium reference catalogue","description":"Discovers available factions, mission packs, rule documents, reference kinds, and active source revisions.","read_only":true},{"name":"list_units","title":"List compact faction units for roster planning","description":"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","read_only":true},{"name":"get_mission_matchup","title":"Resolve a mission matchup","description":"Resolves two force dispositions, in the current mission pack or a named one, 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: award ","read_only":true},{"name":"simulate_combat","title":"Estimate combat between two units","description":"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 ","read_only":true},{"name":"optimize_loadout","title":"Find the best loadout against a unit","description":"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, then the most optional wargear that costs no points and replaces nothing, then the fewest choices changed from the start, as the simulator's Optimize does. Takes the same sides as simulate_combat; the attacker's choices a","read_only":true},{"name":"compare_enhancements","title":"Compare enhancements against a unit","description":"Simulates the attacking unit once with each enhancement its characters, including attached leaders, can take in the attacker's detachment, and once with none, against the defender, as simulate_combat does. Takes the same sides as simulate_combat; name the attacker's detachment, since enhancements come from it. Any enhancement the sides name is replaced by the one being compared. points keeps only ","read_only":true},{"name":"list_data_updates","title":"List game-data updates","description":"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","read_only":true},{"name":"check_roster","title":"Check a roster","description":"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. unchecked names restrictions Praetorium could not evaluate, which the player mu","read_only":true},{"name":"grade_roster","title":"Grade a roster","description":"Grades which jobs 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 centred on comparedWith's armies, so a list's distance from its army's typical list reads on every army's spread. A typical tourn","read_only":true},{"name":"get_unit_options","title":"Read unit options for a roster","description":"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","read_only":true},{"name":"compare_rosters","title":"Compare two rosters in combat","description":"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","read_only":true},{"name":"import_roster","title":"Import an army list","description":"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, Mini Headquarters 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 f","read_only":true},{"name":"export_roster","title":"Export a roster as text","description":"Writes a roster as the site's text export, the official app's layout that tournament organizers 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","read_only":true},{"name":"list_winning_lists","title":"List tournament-winning lists","description":"Lists a faction's top-four tournament placings from 40k Stats and Mini Headquarters whose lists import cleanly and are legal under today's army data, newest first; pass includeNoLongerLegal for lists a points or rules change has made illegal too, such as to read the meta from before a points rise. A faction counts its whole family, so a list imported under an earlier rules version still counts. of","read_only":true},{"name":"get_winning_list","title":"Read a tournament-winning list","description":"Reads one top-four tournament placing from list_winning_lists as it imports under today's army data: its placing, whether it is legal today, record and event, the army text the player submitted, draft (the list in the shape check_roster, grade_roster, compare_rosters and save_roster take) and summary, which names each unit with its points, models, wargear, enhancements, Warlord and attachments. Gr","read_only":true},{"name":"delete_roster","title":"Delete my roster","description":"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.","read_only":false},{"name":"copy_roster","title":"Copy a roster","description":"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","read_only":false},{"name":"set_roster_archived","title":"Archive or restore my roster","description":"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.","read_only":false},{"name":"get_my_collection","title":"Read my model collection","description":"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","read_only":true},{"name":"list_my_events","title":"List my groups and tournaments","description":"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","read_only":true},{"name":"get_my_group","title":"Read one of my groups","description":"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, your fixtures, and once every game is played its winners. An open fixture's start is the create_battle input that plays it for the league. A private group shows onl","read_only":true},{"name":"get_my_event","title":"Read a tournament or hidden-list game","description":"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 (and at a team tournament each team meeting's revealed picks), standings once lists are revealed (and team standings, whose score is games won or victory points), your battles","read_only":true},{"name":"join_group","title":"Join a group","description":"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.","read_only":false},{"name":"join_league","title":"Join a group's league","description":"Joins the draft league of a group you are a member of. Nobody can join once an organizer publishes its fixtures. Requires mcp:write.","read_only":false},{"name":"join_event","title":"Join a tournament or hidden-list game","description":"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.","read_only":false},{"name":"submit_event_roster","title":"Seal my roster for a tournament","description":"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. A player who plays alone fixes their ","read_only":false},{"name":"check_in_event","title":"Check in to a tournament","description":"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.","read_only":false},{"name":"start_event_battle","title":"Start my tournament battle","description":"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 ","read_only":false},{"name":"report_table_result","title":"Report my table’s score","description":"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.","read_only":false},{"name":"get_skill","title":"Read a Praetorium skill","description":"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 ","read_only":true}],"server_info":{"name":"praetorium-reference","version":"1.4.0"},"category":"analytics","tags":["developer","web-search"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-28","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-richardsolomou-praetorium/"}