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
- Stars
- 584โ
- Forks
- 86
- Language
- TypeScript
- License
- MIT
- Created
- 2025-01-24
- Last push
- 2026-08-15