spences10/mcp-sequentialthinking-tools

View on GitHub โ†—

๐Ÿง  An adaptation of the MCP Sequential Thinking Server to guide tool usage. This server provides recommendations for which MCP tools would be most effective at each stage.

584 โ˜…86 forksTypeScriptUpdated 1mo ago

What you need to know

Lightweight MCP server that records sequential reasoning steps as a scratchpad with history, branching, revision metadata, and optional validation of model-authored tool plans โ€” adapted from the official MCP Sequential Thinking server.

Install

npx -y mcp-sequentialthinking-tools (Claude Desktop / compatible MCP clients)

Usage

  • โ€ขCall sequentialthinking_tools with thought, thought_number, total_thoughts, next_thought_needed; optional session_id, branch/revise params, available_tools and recommended_tools
  • โ€ขget_thinking_history returns stored thoughts for a session (limit default 50, max 500)
  • โ€ขclear_thinking_history clears one session or all sessions
  • โ€ขA sequential-thinking-guidance prompt tells the model to use the server honestly as a scratchpad, not an external reasoning engine

Key features

  • โœ“Scratchpad with per-session history, branching, revisions, and remaining-steps tracking
  • โœ“Validates recommended_tools against a supplied available_tools list; returns isError: true and skips storage if a name is missing
  • โœ“Security posture: treats thought text, tool descriptions, rationales, and remaining-step text as untrusted input โ€” prompt-injection-like text is scanned and redacted, with security_warnings on redacted calls
  • โœ“MAX_HISTORY_SIZE per session (default 1000)
  • โœ“stdio transport accepts both standard Content-Length framed MCP messages and newline-delimited JSON used by older tmcp tooling

Best for

Tasks that benefit from explicit, inspectable reasoning โ€” breaking messy problems into steps, revising or branching plans, or keeping a small reasoning history per session.

Caveats

  • โš Does not discover your other MCP tools and does not choose tools for the model
  • โš Adds overhead โ€” README says not to use it for trivial requests
  • โš Redaction is defensive filtering, not a guarantee; do not put secrets in thoughts or tool descriptions
Clients: Claude Desktop
Documentation โ†—

Reviewed 2026-08-07

Topics

mcpmodel-context-protocolmodelcontextprotocoltool
Stars
584โ˜…
Forks
86
Language
TypeScript
License
MIT
Created
2025-01-24
Last push
2026-08-15