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