# Imposter Game MCP Server 🕵️‍♂️

[![npm version](https://badge.fury.io/js/imposter-game-mcp.svg)](https://badge.fury.io/js/imposter-game-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Powered By](https://img.shields.io/badge/Powered_By-Imposter_Game_Words-39ff14.svg)](https://impostergamewords.com)

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

Powered by [Imposter Game Word Generator](https://impostergamewords.com/).

---

## 🎮 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](https://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:
- Access to high-quality word pairs across 10+ categories ([Standard, Couples, Kids, Tech, Food, etc.](https://impostergamewords.com/all-game-modes))
- Automatically handles role assignments and word generation.
- Perfectly balanced word pairings sourced from the official [Imposter Game Generator](https://impostergamewords.com/).

## 📦 Installation & Setup

### Using npx (Recommended for Claude Desktop)

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

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

### Global Installation via npm

```bash
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:
- 📖 [How to Play the Imposter Game](https://impostergamewords.com/how-to-play-imposter-game)
- 🧠 [10 Tips to Win as the Imposter](https://impostergamewords.com/10-tips-to-win-as-imposter)
- ⚖️ [How to Create Balanced Word Pairs](https://impostergamewords.com/how-to-create-balanced-imposter-word-pairs)
- ❓ [Best Questions to Ask in the Imposter Game](https://impostergamewords.com/best-questions-to-ask-in-imposter-game)

## 📄 License

This project is licensed under the MIT License. Data provided by [Impostergamewords.com](https://impostergamewords.com).