Skip to main content
Glama
Sign In
mcp-turtle-noir

mcp-turtle-noir

by Yuikij
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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

Related MCP server: Haiguitang MCP Server

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

Available Tools

3 tools
ask_questionBInspect

Ask a question for the active session. Detect user language and pass language (zh-CN/en-US/ja-JP).

Inputs: question (required), session_id (required), language.

give_up_and_revealAInspect

Give up the current session and reveal the full story. Detect user language and pass language (zh-CN/en-US/ja-JP).

Inputs: session_id (required), language.

start_sessionCInspect

Start a new Turtle Soup session. Detect user language and pass language (zh-CN/en-US/ja-JP). Optional: region, difficulty, keyword.

Inputs: region, keyword, language, difficulty.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.6/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: starting a session, asking a question, and revealing the story. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern: start_session, ask_question, give_up_and_reveal. No deviations.

    Tool Count5/5

    Three tools are appropriate for the simple session lifecycle of a Turtle Soup game. Not too few or too many.

    Completeness4/5

    Covers the main actions (start, ask, reveal). Minor gap: no explicit non-reveal end or session list, but sufficient for core gameplay.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers