YesNoMystery MCP Server
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
YesNoMystery MCP Server
Official Model Context Protocol (MCP) server for YesNoMystery — Lateral Thinking Puzzles (Turtle Soup / Black Stories / Situation Puzzles).
Search 1,000+ official mysteries and public community puzzles across 12 languages, ask an AI game host yes/no deduction questions (with or without conversation history), track clue progress (0–120 scale), and reveal solutions using the exact same dynamic credit rules as the website.
Play on Website | Browse Puzzles | Community Mysteries | 简体中文 | 日本語
Features
Full Public Catalog (
ynm_search_puzzles): Search and filter all official mysteries and password-free community (UGC) puzzles across 12 languages (en,zh,zh-TW,ja,ko,de,es,fr,it,pt,ru,th) by category, difficulty tier (1–3), tags, keyword query, or random sampling. Spoilers are never returned.Live Progress & Clue Tracking (
ynm_get_puzzle): Inspect the scenario, investigation question targets, your unlocked clues, raw progress (0–120), and current dynamic answer reveal price.Contextual or Standalone AI Referee (
ynm_ask_question): Ask yes/no questions and get structured verdicts (yes,no,unknown,partial_ok,needs_rephrase). Chooseinclude_history: true(default) to carry prior Q&A context orinclude_history: falseto evaluate independently.Fair Dynamic Reveal (
ynm_reveal_solution): Matches website pricing —20/30/40credits at 0 progress depending on difficulty,1credit atprogress >= 80, and FREE (0credits) once your deduction reachesprogress >= 100.Zero Setup Required: Works out of the box with 50 free anonymous trial credits (
2credits per question) and no API key required.
Related MCP server: Haiguitang MCP Server
Quick Start
Option A: Local stdio (npx)
Add to Claude Desktop, Cursor, Windsurf, or any MCP client config:
{
"mcpServers": {
"yes-no-mystery": {
"command": "npx",
"args": ["-y", "yes-no-mystery-mcp"]
}
}
}You can also invoke the keyword alias CLI package:
{
"mcpServers": {
"lateral-thinking-puzzles": {
"command": "npx",
"args": ["-y", "lateral-thinking-puzzles-mcp"]
}
}
}Option B: Remote Streamable HTTP (No install required)
Connect directly to the hosted MCP endpoint:
https://lateralthinkingpuzzles.org/api/mcpTools Reference
Tool | Read-Only | Description |
| Yes | Search/filter official & public UGC puzzles across 12 languages ( |
| Yes | Get scenario, question targets, current progress ( |
| No | Ask a yes/no question with |
| No | Reveal full solution & all clues using dynamic pricing ( |
Optional Environment Variables (stdio mode)
YES_NO_MYSTERY_API_BASE_URL— Override API base URL (default:https://lateralthinkingpuzzles.org/api/mcp)YES_NO_MYSTERY_TIMEOUT_MS— Request timeout in milliseconds (default:45000)
Play More on YesNoMystery
English Puzzles: lateralthinkingpuzzles.org/puzzle
简体中文海龟汤: lateralthinkingpuzzles.org/zh
繁體中文海龜湯: lateralthinkingpuzzles.org/zh-TW
日本語ウミガメのスープ: lateralthinkingpuzzles.org/ja
License
MIT — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Play Turtle Soup (lateral thinking puzzles) against a strict AI host with yes/no questioning.
Search, reuse, verify AI reasoning. Task marketplace with leaderboard. Zero-barrier, no auth.
Hide a gift card, code, link or file behind riddles: birthday quests, advent calendars, hunts.
Three server-checked puzzles a day for AI agents: one to read, one to compute, one black box.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables structured problem-solving through sequential thinking stages with persistent storage and analysis. Helps break down complex problems into manageable cognitive steps while tracking progress and generating summaries of the entire thought process.MIT
- FlicenseBqualityDmaintenanceEnables LLMs to host and play Situation Puzzle (海龟汤) games where users solve mysterious scenarios by asking yes/no questions to uncover the full story behind seemingly illogical situations.3-
- FlicenseNot gradedqualityDmaintenanceProvides tools to fetch random or categorized riddles, verify answers, and view riddle statistics. It supports communication via HTTP and SSE for seamless integration with AI agents.-
- AlicenseNot gradedqualityCmaintenanceEnables a player to investigate and solve a voice-only murder mystery through an MCP client by searching locations, examining evidence, questioning suspects, reviewing notes, and making a confirmed accusation. The AI assistant never receives the solution before a valid accusation is committed.MIT