spences10/mcp-sequentialthinking-tools

๐Ÿง  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 โ˜…85 forksTypeScriptUpdated 1d 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
View on GitHub โ†—
Stars
584โ˜…
Forks
85
Language
TypeScript
License
MIT
Created
2025-01-24
Last push
2026-08-05