Two Truths and a Twist

by ergodiclabs

5 stars

5.3k downloads

Not rated

GitHub

About

Hosts an interactive 'Two Truths and a Twist' trivia game that manages rounds, tracks player scores, and provides tools for creating trivia content, submitting guesses, and revealing answers with explanations.

Details

Author: ergodiclabs
Repository: ErgodicLabs/TwoTruthsAndATwist
GitHub stars: 5
Downloads: 5,306
License: MIT License
Categories: Design, Developer Tools, AI, Infrastructure, Database

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Two Truths and a Twist

Command (node, npx, python, etc.) ttaat
Arguments
- Argument 1 serve
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "%APPDATA%\\Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "~/.config/Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "%APPDATA%\\Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "~/.config/Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "%APPDATA%\\Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "~/.config/Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "%APPDATA%\\Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "~/.config/Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "%APPDATA%\\Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

JSON

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "~/.config/Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

From the repository

To install twotruthsandatwist for Claude Desktop automatically via Smithery:

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

`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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "two truths and a twist": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "serve"
            ],
            "shell": false,
            "command": "ttaat"
        }
    }
}

Linux

{
    "cwd": "~/.config/Claude",
    "env": [],
    "args": [
        "serve"
    ],
    "shell": false,
    "command": "ttaat"
}

Macos

{
    "cwd": "~/Library/Application Support/Claude",
    "env": [],
    "args": [
        "serve"
    ],
    "shell": false,
    "command": "ttaat"
}

Windows

{
    "cwd": "%APPDATA%\\Claude",
    "env": [],
    "args": [
        "serve"
    ],
    "shell": false,
    "command": "ttaat"
}

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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

create_round

submit_guess

reveal_twist

get_round

get_last_round

get_stats

Claude Desktop / Cursor

Linux

Macos

Windows

TwoTruthsAndATwist

Installation

Installing via Smithery

Requirements

Usage

Initialize the Database

Start the Game Server

View Game Statistics

Connecting to the Server

Game Mechanics

Example Prompts

For Developers

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel

`create_round`

`submit_guess`

`reveal_twist`

`get_round`

`get_last_round`

`get_stats`