MCP Riddle Game Server

Provides an MCP-based riddle game with HTTP and SSE interfaces, loading data from riddles.json and supporting environment overrides.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

You can run and connect to a lightweight MCP riddle game server built with Starlette. It exposes four MCP tools to fetch riddles, verify answers, list categories, and count riddles, and you can interact over HTTP or SSE to integrate with MCP clients or automation agents.

How to use

To use this MCP server, you connect your MCP client via HTTP or SSE endpoints. You can run the local server and connect through the provided endpoints to fetch riddles, validate answers, see available categories, and obtain statistics. If you are integrating with an agent, you can choose the SSE path for real-time streaming or the HTTP path for standard request/response behavior.

How to install

Prerequisites you need on your machine before starting:

Python 3.8 or newer
venv is included with Python 3.3+

Additional content

Data sources and runtime configuration you will use:

Available tools

get_riddle_random

Fetch a random or sequential or category-based riddle depending on the mode you specify.

get_riddle_answer

Validate a provided answer against the current riddle.

list_categories

Return a list of available riddle categories.

get_riddle_count

Return statistics about the riddles, such as total count and counts per category.