Mcp Turtle Noir

io.github.YuikijPublished by GitHub account Yuikijv1.3.0Updated Oct 24, 2026

Play Turtle Soup (lateral thinking puzzles) against a strict AI host with yes/no questioning.

VerifiedStreamable HTTPWeb executable

Overview

AI-generated overview

Lets an assistant play Turtle Soup lateral-thinking puzzles against a strict AI host, asking yes/no questions and tracking solve progress.

What you can do
  • Start a puzzle session, optionally filtered by region, difficulty or keyword, and receive the surface story while the solution stays on the server.
  • Ask one yes/no question at a time and get a structured judgment (Yes, No, Both, Irrelevant) plus a short reason and solve progress from 0 to 100.
  • Reveal the hidden solution and end the session, subject to the backend reveal policy.
  • Request output in Chinese, English or Japanese via a language parameter.
When to use it
Useful when you want an assistant to host or play a lateral-thinking puzzle game with a user, with structured answers and progress tracking instead of free-form role-play.
Requirements
Runs as a local stdio process via npx with Node.js 18 or newer, or as a remote endpoint. Optional environment variables set the backend API base URL, request timeout and an API key.
Before you install
The optional API key is passed as a Bearer token in the environment; keep it out of shared configs. Questions and session data are sent to the Turtle Noir backend. Reveal is refused until progress reaches the threshold, and revealed output may include a promotional link.

Installation

In SourceWeft

  1. Open Mcp Turtle Noir in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Yuikij%2Fmcp-turtle-noir/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "turtle-noir": {
      "type": "http",
      "url": "https://turtlenoir.com/mcp"
    }
  }
}

README

mcp-turtle-noir

MCP server for Turtle Soup (lateral thinking puzzles).

This package is a thin MCP layer over Turtle Noir backend APIs and is designed for stdio transport.

Homepage | 中文文档 | 日本語

Features

  • start_session: start a new puzzle session
  • ask_question: ask one question and receive a structured result
  • give_up_and_reveal: reveal the solution (subject to backend reveal policy)
  • Multilingual MCP output (zh-CN, en-US, ja-JP) via language
  • Keeps puzzle solutions on the backend during normal gameplay

Transport

  • Supported: stdio
  • Not included in this package: SSE/HTTP MCP transport

Requirements

  • Node.js 18+

Install and Run

bash
npx -y mcp-turtle-noir

MCP Client Config

json
{  "mcpServers": {    "turtle-noir": {      "command": "npx",      "args": [        "-y",        "mcp-turtle-noir"      ]    }  }}

With environment variables:

json
{  "mcpServers": {    "turtle-noir": {      "command": "npx",      "args": [        "-y",        "mcp-turtle-noir"      ],      "env": {        "TURTLE_NOIR_API_BASE_URL": "https://turtlenoir.com/api/mcp",        "TURTLE_NOIR_API_TIMEOUT_MS": "10000",        "TURTLE_NOIR_API_KEY": "YOUR_API_KEY"      }    }  }}

Tools

1) start_session

Input (all optional):

json
{  "region": "US",  "keyword": "island",  "language": "en-US"}

Output:

json
{  "session_id": "...",  "puzzle_id": "...",  "title": "...",  "content": "...",  "language": "en-US",  "instruction": "...",  "translation_instruction": "..."}

2) ask_question

Input:

json
{  "session_id": "...",  "question": "...",  "language": "en-US"}

Output:

json
{  "session_id": "...",  "language": "en-US",  "answer_key": "irrelevant",  "answer": "Irrelevant",  "answer_original": "...",  "short_reason": "...",  "solved": false,  "progress": 35,  "translation_instruction": "..."}

3) give_up_and_reveal

Input:

json
{  "session_id": "...",  "language": "en-US"}

Output:

json
{  "session_id": "...",  "language": "en-US",  "title": "...",  "solution": "...",  "cta_url": "https://turtlenoir.com",  "cta_text": "...",  "translation_instruction": "..."}

Note: backend may reject reveal if progress is below a threshold (for example progress < 60).

Environment Variables

  • TURTLE_NOIR_API_BASE_URL (default: https://turtlenoir.com/api/mcp)
  • TURTLE_NOIR_API_TIMEOUT_MS (default: 10000)
  • TURTLE_NOIR_API_KEY (optional Bearer token)

Development

bash
npm installnpm run buildnode dist/index.js

Quick Start

See QUICKSTART.md.

Chinese Docs

See README.zh-CN.md.

License

MIT. See LICENSE.

Acknowledgements

Source: README.md at commit a3b77f4

Tools

3

start_session

Start a Turtle Soup puzzle session

Start a new Turtle Soup (lateral thinking puzzle) session. Returns the surface story; the hidden solution stays on the server. Optional filters: region (CN/US/JP), difficulty, keyword.

Parametersregionkeyworddifficulty

ask_question

Ask the AI host a question

Ask one yes/no style question about the current puzzle. The AI host answers with one of four judgments: 是(Yes) / 不是(No) / 是也不是(Both) / 没有关系(Irrelevant), plus solve progress (0-100).

Parametersquestionrequiredsession_idrequired

give_up_and_reveal

Give up and reveal the solution

Reveal the hidden solution and end the session. Only allowed once solve progress reaches 60.

Parameterssession_idrequired

Version history

1
  1. v1.3.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts