SkillFoxx

Type a name, a task or a service

mcp-sequentialthinking-tools

A lightweight MCP server for step-by-step reasoning: a scratchpad with history, branching and tool-plan validation

MCP server

Medium risk

We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.

Why this level

  • Runs as a separate process and stores step history
  • Handles text treated as untrusted with best-effort filtering
All reasons and checks

spences10/mcp-sequentialthinking-toolsAuthor:Scott Spence

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/mcp-sequentialthinking-tools

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal

claude mcp add --transport stdio mcp-sequentialthinking-tools -- npx -y mcp-sequentialthinking-tools

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "mcp-sequentialthinking-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-sequentialthinking-tools"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

MAX_HISTORY_SIZEoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in Cursor

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "mcp-sequentialthinking-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-sequentialthinking-tools"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

MAX_HISTORY_SIZEoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in VS Code

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Run in a terminal

code --add-mcp '{"name":"mcp-sequentialthinking-tools","type":"stdio","command":"npx","args":["-y","mcp-sequentialthinking-tools"]}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "mcp-sequentialthinking-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-sequentialthinking-tools"
      ]
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

MAX_HISTORY_SIZEoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add mcp-sequentialthinking-tools -- npx -y mcp-sequentialthinking-tools

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.mcp-sequentialthinking-tools]
command = "npx"
args = ["-y", "mcp-sequentialthinking-tools"]

If the file already exists, append the block to the end.

Keys and settings

MAX_HISTORY_SIZEoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "mcp-sequentialthinking-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-sequentialthinking-tools"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

MAX_HISTORY_SIZEoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "mcp-sequentialthinking-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-sequentialthinking-tools"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

MAX_HISTORY_SIZEoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "mcp-sequentialthinking-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-sequentialthinking-tools"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

MAX_HISTORY_SIZEoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "mcp-sequentialthinking-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-sequentialthinking-tools"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

MAX_HISTORY_SIZEoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "mcp-sequentialthinking-tools": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-sequentialthinking-tools"
      ]
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

MAX_HISTORY_SIZEoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "mcp-sequentialthinking-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-sequentialthinking-tools"
      ]
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

MAX_HISTORY_SIZEoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "mcp-sequentialthinking-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-sequentialthinking-tools"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

MAX_HISTORY_SIZEoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit bdb344e.

Text for your agent

Add the mcp-sequentialthinking-tools server to the MCP config via npx -y mcp-sequentialthinking-tools. Optionally set MAX_HISTORY_SIZE.

Other ways from the author
{
  "mcpServers": {
    "mcp-sequentialthinking-tools": {
      "command": "npx",
      "args": ["-y", "mcp-sequentialthinking-tools"],
      "env": {
        "MAX_HISTORY_SIZE": "1000"
      }
    }
  }
}

MAX_HISTORY_SIZE sets per-session history size and defaults to 1000.

This is third-party code. Review the repository files before installing.

What it does

The server gives the model a place to record its reasoning step by step. Each step is a thought with a number, an estimate of the total, and a flag for whether another step is needed. History can be kept per session, a thought can be marked as a revision, and branches can start from it. If you pass the available tools and the recommended ones for a step, the server checks that the recommended names exist and otherwise returns an error. It does not discover your tools or choose them for the model. Thought and description text is treated as untrusted: suspicious injections are scrubbed before storage.

Who it is for. For people who want to see and check an agent's reasoning on hard multi-step tasks.

Good fit when

  • You need to break a messy task into explicit steps
  • You need to revise or branch a plan as work goes
  • You need to check that a plan references only existing tools

Not a fit when

  • The task is trivial and an extra reasoning layer only gets in the way
  • You expect an external reasoning engine, this is only a scratchpad with validation

Example request

Break this task into steps and keep a reasoning history so I can review it

Limitations

The server does not expose your other tools or choose them for the model, it only stores and validates steps. The suspicious-text filtering is best-effort, not a guarantee, so do not put secrets in thoughts. History size is capped by MAX_HISTORY_SIZE.

How to disable. Remove the mcp-sequentialthinking-tools entry from the MCP client config.

MCP

Transport
stdio
Authentication
not required
Environment variables
MAX_HISTORY_SIZE
Per-session reasoning history size, default 1000

Security check

  • Runs as a separate process and stores step history
  • Handles text treated as untrusted with best-effort filtering

README in short

The README describes an adaptation of the Sequential Thinking server into a lightweight MCP server for recording reasoning steps. It has tools to record a thought, read session history and clear history, plus a prompt on honest use: it is a scratchpad and validator, not an external mind. It documents defensive filtering of untrusted text and options such as MAX_HISTORY_SIZE. Install is via npx, with a config for Claude Desktop and compatible clients.

FAQ

Does it pick tools for the model?

No. The server only stores steps and, if you pass the lists, checks that the recommended tool names are among the available ones.

Is it a reasoning engine?

No, it is a scratchpad with history, branching and validation. It does not think for the model, it records and validates its steps.

Editors’ pick

Open-source personal AI assistant on your own machine: answers in Telegram, Slack, Discord and WhatsApp, extended with skills and plugins

CLIHigh risk390.7K
Editors’ pick

A self-improving agent from Nous Research with a TUI, messaging gateway, cron jobs and skills it writes itself

CLIHigh risk249.8K
Editors’ pick

An open source coding agent for the terminal and desktop with build and plan modes

CLIHigh risk210.6K
Editors’ pick

Open prompt library with a Claude Code plugin, MCP server and CLI: search, fetch and improve prompts and skills from an agent

PluginMedium risk171.5K
Foxx AImcp-sequentialthinking-tools

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.