Digital Grimoire MCP Server

A Model Context Protocol (MCP) server for Digital Grimoire game management. This allows AI assistants like Claude to help manage Digital Grimoire games through the MCP protocol.

Installation

npm install -g digital-grimoire-mcp

Usage

With Claude Desktop

Add this to your Claude Desktop MCP settings:

{
  "mcpServers": {
    "digital-grimoire": {
      "command": "digital-grimoire-mcp",
      "args": [],
      "env": {
        "DIGITAL_GRIMOIRE_MCP_SERVER": "https://botc.games/api/mcp"
      }
    }
  }
}

Manual Start

digital-grimoire-mcp

Available Tools

Game Management

• setup_game - Initialize a new game with script and players
• load_script - Load a specific script by name
• add_role_to_bag - Add specific roles to the role selection bag
• assign_random_roles - Automatically assign random roles to players

Player Actions

• set_player_alive_state - Mark a player as alive or dead
• change_player_role - Change a player's role during the game
• rearrange_players - Rearrange players in different layouts (circle, n-shape, rainbow)

Game Flow

• set_night - Set the current night phase
• add_demon_bluff - Add demon bluffs to the game

Example Usage

Once connected to your MCP client, you can use natural language to interact with the game. Here's an example:

My session id is botc-mf59q0qm-qeebcm23, please setup a new game with the "Contempt" script with Ankit, Omer, Soumesh, Harshit, Yulia, Vlad, Emma, Eirik, Thor, Dilek and Daniel. Please include the following roles: Steward, Noble, Bounty Hunter, Balloonist, Oracle, Slayer, Fisherman, Plague Doctor, Xaan, Scarlet Woman and Ojo.

Other example commands:

• "Load the Trouble Brewing script"
• "Mark Ankit as dead"
• "Change Omer's role to Poisoner"
• "Rearrange players in a circle layout"
• "Add High Priestess, Soldier and Ravenkeeper as demon bluffs"

Configuration

The server connects to the Digital Grimoire API at https://botc.games/api/mcp by default. You can override this with the DIGITAL_GRIMOIRE_MCP_SERVER environment variable:

DIGITAL_GRIMOIRE_MCP_SERVER=https://your-custom-api.com/api/mcp digital-grimoire-mcp

Requirements

• Node.js 16 or higher
• A session ID from the Digital Grimoire web app at https://botc.games. This can be found in the "Game --> MCP Integration" menu.

License

MIT