What is Twotruthsandatwist

TwoTruthsAndATwist is the world’s first Model Context Protocol (MCP) game, designed as a trivia game where players identify a false statement among three provided by an AI.

Use cases

Use cases include classroom activities for learning, online trivia competitions, and casual gaming sessions among friends.

How to use

To use TwoTruthsAndATwist, install it via PyPI, initialize the database, start the MCP server, and connect an MCP-compatible LLM to play the game.

Key features

Key features include interactive trivia gameplay, AI-generated content, and the ability to connect with various MCP-compatible LLMs for a fun experience.

Where to use

TwoTruthsAndATwist can be used in educational settings, entertainment platforms, and social gatherings where trivia games are enjoyed.

TwoTruthsAndATwist

Two Truths and a Twist: The world’s first Model Context Protocol (MCP) game

Game design document

Installation

Installing via Smithery

To install twotruthsandatwist for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @ErgodicLabs/twotruthsandatwist --client claude

Requirements

• Python 3.13 or higher
• MCP-compatible LLM (like Claude 3)

You can install the game directly from PyPI:

pip install ttaat

Or if you prefer using uv:

uv pip install ttaat

Usage

Initialize the Database

First, initialize the game database:

ttaat db upgrade

Start the Game Server

To start the MCP server:

ttaat serve

This will start the Two Truths and a Twist MCP server, which LLMs can connect to for playing the game.

View Game Statistics

To see game statistics:

ttaat db stats

Connecting to the Server

To connect an MCP-compatible LLM to the game server, you’ll need to configure the MCP connection. Create a configuration file (e.g., claude_desktop_config.json) with the following content:

{
  "mcpServers": {
    "TwoTruthsAndATwist": {
      "command": "ttaat",
      "args": [
        "serve"
      ]
    }
  }
}

For Claude Desktop, place this file in:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Game Mechanics

Two Truths and a Twist is a trivia game where:

1. The AI creates a round with three statements about a topic - two truths and one “twist” (a playful, false statement)
2. Players try to identify which statement is the twist
3. The AI reveals the answer with entertaining explanations

The game leverages the MCP protocol to provide a fun, interactive trivia experience where AI models both generate the content and facilitate gameplay.

Example Prompts

Once connected to an MCP-enabled LLM, you can start a game with prompts like:

Let's play Two Truths and a Twist! Create a round about space exploration.

Create a game round about ancient civilizations.

For Developers

This package implements an MCP server that provides custom game tools:

• create_round: Creates a new game round with a question and three statements
• submit_guess: Lets players submit their guess for which statement is the twist
• reveal_twist: Reveals the answer with explanations for each statement
• get_round: Retrieves details for a specific round
• get_last_round: Gets details of the most recent round
• get_stats: Retrieves game statistics