Skip to content
MCP Shelf

Sequential Thinking

View on GitHub

A numbered scratchpad the model fills in, revises and branches while it works.

  • Started in our test
  • ★ 91.6K GitHub stars
  • 169.3K downloads a week
  • Last commit 25 Oct 2026

At a glance

Sequential Thinking is one of the reference servers kept by the Model Context Protocol project. It has a single tool, and that tool does no outside work at all: the model writes one thought per call, says how many it expects to need, and can go back to revise an earlier thought or fork off a branch to try another idea.

What you get is structure. The model commits to a plan in visible steps, which tends to help on long debugging sessions, migrations and design choices where the first idea is often wrong. On short questions it only adds calls, so leave it to the model to decide when to use it.

Made by
The Model Context Protocol project (reference server)
Latest version
2.0.0 (19 Oct 2026)
GitHub stars
91.6K
Downloads
169.3K a week
Last commit
25 Oct 2026
Tools
1
Runs on
Your computer

Our check: We ran this exact config on 27 Oct 2026: it started and answered with 1 tools. The shared database pointed at @modelcontextprotocol/server-everything, a test server from the same repository. The Sequential Thinking package is @modelcontextprotocol/server-sequential-thinking, and its npm entry links back to modelcontextprotocol/servers.

What's in the pod: its tools

We found 1 tool when we started it on 27 Oct 2026. 0 only read. The rest can change things, so keep your app's "ask before each tool call" setting on for them.

Changes things1 tool · Can create, edit, send or delete.

ToolWhat it is for
sequentialthinkingRecords one numbered thought, with the expected total, and lets the model revise an earlier thought or branch off to try another line of reasoning.

Grouped and described by us. The README on GitHub lists the inputs each tool takes.

How clearly it describes its tools to your assistant

Tools with a description
1 of 1
Say if they change things
1 of 1
Context it takes, at least
~800 tokens

Every tool says whether it only reads or can change things, so a client can ask before the risky ones.

From the tool list it sent us. The token figure counts names, descriptions and input names; the full schemas your client loads add more.

Set it up

Pick your app for the exact snippet and where it goes.

Where it goes: claude_desktop_config.json (Settings → Developer → Edit Config)

Claude Desktop
{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    }
  }
}

Set "DISABLE_THOUGHT_LOGGING": "true" in env if you do not want each thought printed to the server log.

New to this? See the setup guides for Claude Code, Cursor, Claude Desktop and ChatGPT.

Settings

Names are exactly as the project spells them. Required ones are marked.

SettingWhat it does
DISABLE_THOUGHT_LOGGINGEnvironment variableStops the server printing each thought to its log (stderr). Handy when your client shows server logs and you only want the answer.true
mcp/sequentialthinkingConfigThe Docker image of the same server, for people who would rather not run npx. Start it with docker run --rm -i mcp/sequentialthinking.

What it can touch

It can read

  • Nothing outside the conversation: it only keeps the thoughts the model sends it

It can change

  • Nothing on your machine or online. The thought history lives in memory and ends when the client disconnects

Safer setup: There is little to lock down. If you want fewer tool calls, say in your prompt when step-by-step thinking is worth it.

Before you start

  • Node.js 24 or newer (the package asks for it)
  • Nothing else: no account, key or network access

If it does not work

npx warns about the Node.js version or the server will not start
Version 2 of the package asks for Node.js 24 or newer. Update Node, or run the Docker image instead.
On Windows the client says it cannot find npx
Use "command": "cmd" with "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-sequential-thinking"].
The tool is listed but the model never calls it
Ask for it: phrases like "think this through step by step" or "plan it, then revise the plan if an assumption fails" usually trigger it.

Peas in a pod: similar servers

How Sequential Thinking lines up against other agent helpers and desktop control servers on the shelf.

ServerToolsRuns onLicenceStars
Sequential Thinking1Your computer–91.6K
Windows-MCP21Your computerMIT10.4K
Mobile MCP34Your computerApache-2.010K
Container Use15Your computer–4.1K

Questions

Does Sequential Thinking make the model smarter?

Not by itself. It gives the model a place to lay out steps and correct them, which helps on long, messy problems. The thinking is still the model's own.

Is it worth it with models that already reason internally?

Less than it used to be. Its main value now is that the steps are visible to you and can branch, which makes long plans easier to follow and check.

Does it send my data anywhere?

No. It makes no network calls and stores nothing on disk; the thoughts exist only while the client is connected.

Who maintains it?

It is one of the reference servers in the modelcontextprotocol/servers repository, kept by the Model Context Protocol project, and it is MIT licensed.

Full docs on GitHubmodelcontextprotocol/servers

Something wrong on this page? Tell us.

More in Agent helpers and desktop control