other

Two Truths and a Twist▌

by ergodiclabs

Play 'Two Truths and a Twist,' a fun trivia site offering an interactive quiz game with scoring, content creation, and d

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.

github stars

★ 5

GitHub npm

First MCP-based gamePersistent score tracking with SQLiteOne-command setup via Smithery

best for

/ Interactive trivia entertainment with AI assistants
/ Educational games and learning activities
/ Testing knowledge on specific topics
/ Social games with friends using Claude Desktop

capabilities

/ Create trivia rounds with two truths and one false statement
/ Track player scores across multiple rounds
/ Submit and validate player guesses
/ Reveal correct answers with explanations
/ Generate trivia content on various topics
/ View game statistics and history

what it does

Runs an interactive trivia game where players guess which of three statements is the false "twist" among two truths. The server manages game rounds, scoring, and provides trivia content creation tools.

about

Two Truths and a Twist is a community-built MCP server published by ergodiclabs that provides AI assistants with tools and capabilities via the Model Context Protocol. Play 'Two Truths and a Twist,' a fun trivia site offering an interactive quiz game with scoring, content creation, and d It is categorized under other.

how to install

You can install Two Truths and a Twist in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Two Truths and a Twist is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

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:

The AI creates a round with three statements about a topic - two truths and one "twist" (a playful, false statement)
Players try to identify which statement is the twist
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