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.
| Tool | What it is for |
|---|---|
sequentialthinking | Records 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)
{
"mcpServers": {
"sequential-thinking": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-sequential-thinking"
]
}
}
}Where it goes: Your terminal, in the project folder
claude mcp add-json sequential-thinking '{"command":"npx","args":["-y","@modelcontextprotocol/server-sequential-thinking"]}'Where it goes: ~/.cursor/mcp.json, or .cursor/mcp.json in a project
{
"mcpServers": {
"sequential-thinking": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-sequential-thinking"
]
}
}
}Where it goes: .vscode/mcp.json in your project
{
"servers": {
"sequential-thinking": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-sequential-thinking"
]
}
}
}Where it goes: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"sequential-thinking": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-sequential-thinking"
]
}
}
}Where it goes: Not supported
ChatGPT only connects to remote servers by URL. This one runs on your computer, so use Claude, Cursor or VS Code.
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.
| Setting | What it does |
|---|---|
DISABLE_THOUGHT_LOGGINGEnvironment variable | Stops the server printing each thought to its log (stderr). Handy when your client shows server logs and you only want the answer.true |
mcp/sequentialthinkingConfig | The 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.
| Server | Tools | Runs on | Licence | Stars |
|---|---|---|---|---|
| Sequential Thinking | 1 | Your computer | – | 91.6K |
| Windows-MCP | 21 | Your computer | MIT | 10.4K |
| Mobile MCP | 34 | Your computer | Apache-2.0 | 10K |
| Container Use | 15 | Your 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.
Something wrong on this page? Tell us.
