imposter-game-mcp

Generate random word pairs for the Imposter party game directly via Claude or Cursor. Let AI host your next social deduction game!

Documentation

Imposter Game MCP Server 🕵️‍♂️

npm version License: MIT Powered By

The official Model Context Protocol (MCP) server for playing the Imposter Game (Spyfall alternative) directly with AI.

Powered by Imposter Game Word Generator.


🎮 What is the Imposter Game?

The Imposter Game (also known as Spyfall or Chameleon) is a popular social deduction party game. In the game, everyone receives a secret word (e.g., "Coffee"), except for one player (the Imposter) who receives a slightly different word (e.g., "Tea"). Players take turns asking questions to figure out who the Imposter is, while the Imposter tries to blend in.

Want to play in person with friends on your phone?
Play instantly for free without downloading an app at impostergamewords.com.

🤖 Why use this MCP Server?

This MCP Server allows you to play the Imposter Game with an AI acting as the game host/moderator (like Claude, Cursor, or any MCP-compatible client).

Features:

📦 Installation & Setup

Using npx (Recommended for Claude Desktop)

To use this server in Claude Desktop, add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "imposter-game": {
      "command": "npx",
      "args": ["-y", "imposter-game-mcp"]
    }
  }
}

Global Installation via npm

npm install -g imposter-game-mcp

🛠️ Provided Tools

This server exposes the following tools:

  1. get_categories

    • Description: Returns all available game categories (e.g., Kids, Couples, Food, Tech).
    • Usage: Call this to let human players choose a theme for the round.
  2. generate_game_words

    • Description: Generates a set of secret words and assigns the Imposter role.
    • Inputs:
      • category (string): The chosen category (e.g., 'standard').
      • playerCount (number): The number of players in the game (minimum 3).
    • Usage: Use this to set up a game session. The AI will receive the secret roles and act as the Game Master to privately message or reveal words to the human players.

📚 Resources & Strategy Guides

Want to improve your skills? Check out our official guides:

📄 License

This project is licensed under the MIT License. Data provided by Impostergamewords.com.