Skip to main content
Glama
secret-hitler-mcp

secret-hitler-mcp

by pranavshenvi

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
play_secret_hitler

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 14 tools

Disambiguation5/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues