secret-hitler-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| join_lobbyA | Join an existing lobby as a player (or rejoin a game you were disconnected from). The host creates the lobby in the browser and shares the code. lobby_code may also be a full invite link (e.g. https://secret-hitler.online/?lobby=ABCD); server_url may be the public website, which is mapped to its game backend. |
| start_gameA | Start the game (any player in the lobby can; needs 5-10 players, all with icons). |
| get_game_stateB | Your current view: role, known teammates, board, phase, and whether anything is required of you ('your_turn'). |
| get_game_logA | History of elections, votes, enacted policies and executions, plus your private info (cards you saw, investigations). |
| wait_for_my_turnA | Block until the server needs an action from you (or the game ends). Call this in a loop between moves. |
| post_noteA | Show one short line of your reasoning on the human's local viewer page (http://localhost:4041). Use it after reading the state and before each move. Only the human running this MCP server sees it, never the other players. |
| nominate_chancellorB | As President, nominate a Chancellor from the eligible options. |
| voteB | Vote on the proposed government. ja=True for Ja (yes), False for Nein. |
| president_discardA | As President, discard one of the 3 drawn policy cards (0-based index). The rest go to the Chancellor. |
| chancellor_enactB | As Chancellor, ENACT the card at this 0-based index (the other is discarded). |
| propose_vetoA | As Chancellor with 5 fascist policies on the board, propose vetoing this hand. |
| respond_to_vetoB | As President, accept or reject the Chancellor's veto proposal. |
| use_powerB | As President, use the current executive power (investigate / execute / special_election) on a player. |
| finish_turnB | As President, acknowledge a policy peek or end your term when the game asks you to continue. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| play_secret_hitler |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Each tool maps to a distinct game phase or role action (nominate, vote, president_discard, chancellor_enact, veto propose/respond, use_power), so an agent reading get_game_state can unambiguously pick the required tool. The two potentially confusable pairs (president_discard vs chancellor_enact, propose_veto vs respond_to_veto) are explicitly differentiated by role in their descriptions.
All names use snake_case and are readable, with most following a verb_noun pattern (join_lobby, nominate_chancellor, respond_to_veto, finish_turn). Two outliers invert the order to a noun_verb role prefix (chancellor_enact, president_discard), a minor deviation from the otherwise predictable convention.
Fourteen tools is well within the sweet spot and each corresponds to a real action in the Secret Hitler turn cycle. No tool feels redundant or padded; use_power sensibly bundles the three executive powers into one call rather than inflating the count.
The surface covers the full gameplay lifecycle: lobby join/rejoin, game start, state and log reads, every role action, veto flow, executive powers, and turn advancement, with wait_for_my_turn preventing dead ends. Minor gaps remain (no explicit leave/abort lobby or in-game chat/table-talk tool), but these are workable around.