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.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/spences10/mcp-sequentialthinking-tools with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/spences10/mcp-sequentialthinking-tools'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/spences10--mcp-sequentialthinking-tools)HTML
<a href="/listings/spences10--mcp-sequentialthinking-tools"><img src="/api/listings/spences10--mcp-sequentialthinking-tools/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md Β· README Β· 174 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # mcp-sequentialthinking-tools
- [](https://github.com/spences10/mcp-sequentialthinking-tools/actions/workflows/ci.yaml)
- [](https://viteplus.dev)
- [](https://vitest.dev)
- A lightweight MCP server for recording sequential reasoning steps. It
- is a scratchpad with history, branching, revision metadata, and
- optional validation for model-authored tool plans.
- It does **not** discover your other MCP tools and it does **not**
- choose tools for the model. If you pass `available_tools` and
- `recommended_tools`, the server validates that the recommended names
- exist and stores the step.
- <a href="https://glama.ai/mcp/servers/zl990kfusy">
- <img width="380" height="200" src="https://glama.ai/mcp/servers/zl990kfusy/badge" />
- </a>
- ## Why use it?
- Use this when a task benefits from explicit, inspectable reasoning:
- - breaking a messy problem into steps;
- - revising or branching a plan;
- - keeping a small reasoning history by session;
- - validating tool-plan names against a supplied tool list;
- - clearing or inspecting reasoning history during a long agent run.
- Do not use it for trivial requests. It adds overhead.
- ## Tools
- ### `sequentialthinking_tools`
- Records one thought.
- Required parameters:
- - `thought` β current reasoning step
- - `thought_number` β current step number
- - `total_thoughts` β current estimate; automatically raised if lower
- than `thought_number`
- - `next_thought_needed` β whether another thought is needed
- Optional parameters:
- - `session_id` β history bucket; defaults to `default`
- - `is_revision`, `revises_thought`
- - `branch_from_thought`, `branch_id`
- - `needs_more_thoughts`
- - `available_tools` β array of tool names or `{ name, description }`
- objects
- - `recommended_tools` β model-authored recommendations to
- validate/store
- - `remaining_steps` β short list of upcoming steps
- Example:
- ```json
- {
- "session_id": "svelte-debug",
- "thought": "First inspect the route files, then run the failing check.",
- "thought_number": 1,
- "total_thoughts": 3,
- "next_thought_needed": true,
- "available_tools": ["read", "bash"],
- "recommended_tools": [
- {
- "tool_name": "read",
- "confidence": 0.9,
- "rationale": "Need to inspect the relevant files before editing.",
- "priority": 1
- }
- ]
- }
- ```
- If `recommended_tools` contains a name not present in
- `available_tools`, the call returns `isError: true` and does not store
- the thought.
- ## Security posture
- The server treats thought text, tool descriptions, rationales, and
- remaining-step text as untrusted input. Prompt-injection-like text is
- scanned and redacted before it is stored or returned in history. Calls
- with redactions include `security_warnings` showing which fields
- matched.
- This is defensive filtering, not a guarantee that arbitrary
- adversarial text is safe. Do not put secrets in thoughts or tool
- descriptions.
- ### `get_thinking_history`
- Returns stored thoughts for a session.
- Parameters:
- - `session_id` β defaults to `default`
- - `branch_id` β optional branch filter
- - `limit` β max records to return; default `50`, max `500`
- ### `clear_thinking_history`
- Clears one session or every session.
- Parameters:
- - `session_id` β defaults to `default`
- - `all_sessions` β clear all history buckets
- ## Prompt
- ### `sequential-thinking-guidance`
- A short prompt that tells the model how to use this server honestly:
- as a scratchpad and validator, not as an external reasoning engine.
- ## Configuration
- ### Claude Desktop / compatible MCP clients
- ```json
- {
- "mcpServers": {
- "mcp-sequentialthinking-tools": {
- "command": "npx",
- "args": ["-y", "mcp-sequentialthinking-tools"],
- "env": {
- "MAX_HISTORY_SIZE": "1000"
- }
- }
- }
- }
- ```
- `MAX_HISTORY_SIZE` is per session and defaults to `1000`.
- The server uses `tmcp` and includes a small stdio transport that
- accepts both standard `Content-Length` framed MCP messages and
- newline-delimited JSON used by older `tmcp` tooling.
- ## Development
- ```bash
- pnpm install
- pnpm test
- pnpm build
- pnpm check
- ```
- This project uses `vite-plus` for build, test, format, and lint
- orchestration.
- ## Publishing
- ```bash
- pnpm changeset
- pnpm changeset version
- pnpm release
- ```
- ## License
- MIT License β see [LICENSE](LICENSE).
- ## Acknowledgments
- - Built on the
- [Model Context Protocol](https://github.com/modelcontextprotocol)
- - Adapted from the
- [MCP Sequential Thinking Server](https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/index.ts)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.