English Français العربية

io.github.Yuikij/mcp-turtle-noir

Official registry AI and agents

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

Source code Website Documentation

What can you do with io.github.Yuikij/mcp-turtle-noir?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mcp-turtle-noir 'https://turtlenoir.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-turtle-noir": {
            "type": "http",
            "url": "https://turtlenoir.com/mcp"
        }
    }
}
NPM package mcp-turtle-noir
Claude Code 
claude mcp add mcp-turtle-noir -e 'TURTLE_NOIR_API_BASE_URL=<TURTLE_NOIR_API_BASE_URL>' -- npx -y mcp-turtle-noir@1.2.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-turtle-noir": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-turtle-noir@1.2.2"
            ],
            "env": {
                "TURTLE_NOIR_API_BASE_URL": "<TURTLE_NOIR_API_BASE_URL>"
            }
        }
    }
}

Environment variables

  • TURTLE_NOIR_API_BASE_URL Turtle Noir backend API base URL

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mcp-turtle-noir
  2. Features
  3. Transport
  4. Requirements
  5. Install and Run
  6. MCP Client Config
  7. Tools
  8. Environment Variables
  9. Development
  10. Quick Start
  11. Chinese Docs
  12. License
  13. Acknowledgements

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

npx -y mcp-turtle-noir

MCP Client Config

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

With environment variables:

{
  "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):

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

Output:

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

Input:

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

Output:

{
  "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:

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

Output:

{
  "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

npm install
npm run build
node dist/index.js

Quick Start

See QUICKSTART.md.

Chinese Docs

See README.zh-CN.md.

License

MIT. See LICENSE.

Acknowledgements

Frequently asked questions

What is io.github.Yuikij/mcp-turtle-noir?

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

How do I install io.github.Yuikij/mcp-turtle-noir?

It runs as a remote server. In Claude Code: claude mcp add --transport http mcp-turtle-noir 'https://turtlenoir.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Yuikij/mcp-turtle-noir need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.Yuikij/mcp-turtle-noir open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Yuikij/mcp-turtle-noir?

It is published by Yuikij. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.