Thinkstep

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Oct 29, 2026

Step-by-step reflective thinking: record, revise, and branch thought chains.

VerifiedSTDIODesktop onlyKnowledge & Memory AI & ML

Server details

Identifier: io.github.CloudCorpRecords/thinkstep
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Oct 29, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account CloudCorpRecords for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.CloudCorpRecords%2Fthinkstep.svg)](https://sourceweft.com/mcp/io.github.CloudCorpRecords%2Fthinkstep?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server with one tool that records a step-by-step chain of thoughts, including revisions and named branches, for the session.

What you can do: Record one thinking step at a time, with its position in the chain and an estimated total
Revise an earlier thought while keeping the original in the history
Fork a named branch from an earlier thought to explore an alternative route
Get back a JSON summary of the chain: current position, whether more steps are needed, open branch ids and history length
When to use it: Useful for multi-step reasoning where a first idea gets contradicted, revisited or split into alternative routes, and you want the thread of revisions and branches kept straight instead of lost in a single pass.
Requirements: Runs locally over stdio, either via npx with the npm package or via the Docker image. No accounts, API keys, environment variables or headers are declared. State lives only in the server process for the session.

Before you install

The tool only records thoughts in memory; nothing is written to disk and nothing leaves the machine, and closing the session discards the notebook. Calls with missing or mistyped fields are rejected and nothing is recorded.

Installation

In SourceWeft

Open Thinkstep in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

thinkstep

Think in steps, out loud, with a server keeping the thread.

Some problems do not yield to a single pass. You form a first idea, poke at it, realise the second step contradicts the first, double back, try a different route from an earlier point, and only then see the shape of the answer. thinkstep is the notebook for that process: an MCP server with one tool, sequentialthinking, that records a chain of thoughts one step at a time and keeps the whole history — revisions and side branches included — straight for you.

Each call adds one thought. You say where you are (thoughtNumber), roughly how far you think you have to go (totalThoughts), and whether you need another step. If the chain outgrows your estimate, the server raises the total for you instead of complaining. When a step rethinks an earlier one, flag it as a revision and point at the thought it reconsiders. When you want to explore a different route without losing the main line, fork a named branch from an earlier thought; every response lists the branch ids created so far, so you always know which threads are open.

State lives in the server process for the length of the session. Nothing is written to disk, nothing leaves the machine, and closing the session closes the notebook.

Usage

MCP server

MCP client config:

json

{  "mcpServers": {    "thinkstep": {      "command": "npx",      "args": ["-y", "@reneturcios/thinkstep", "mcp"]    }  }}

{  "mcpServers": {    "thinkstep": {      "command": "npx",      "args": ["-y", "@reneturcios/thinkstep", "mcp"]    }  }}

Docker

bash

docker run -i ghcr.io/cloudcorprecords/thinkstep          # stdio MCP server (default command is "mcp")docker run --rm ghcr.io/cloudcorprecords/thinkstep --version

docker run -i ghcr.io/cloudcorprecords/thinkstep          # stdio MCP server (default command is "mcp")docker run --rm ghcr.io/cloudcorprecords/thinkstep --version

The tool

`sequentialthinking`

Record one thinking step and get back a summary of the chain.

parameter	type	required	meaning
`thought`	string	yes	Your current thinking step
`nextThoughtNeeded`	boolean	yes	Whether another thought step is needed
`thoughtNumber`	integer	yes	Current thought number (numeric value, e.g., 1, 2, 3)
`totalThoughts`	integer	yes	Estimated total thoughts needed (numeric value, e.g., 5, 10)
`isRevision`	boolean	no	Whether this revises a previous thought
`revisesThought`	integer	no	Which thought is being reconsidered
`branchFromThought`	integer	no	Branching point thought number
`branchId`	string	no	Branch identifier
`needsMoreThoughts`	boolean	no	If more thoughts are needed

A branch is tracked when a thought carries both branchFromThought and branchId. A revision is recorded with isRevision: true and revisesThought set to the number of the thought it rethinks; the original stays in the history.

Every accepted thought returns a JSON summary:

json

{  "thoughtNumber": 2,  "totalThoughts": 5,  "nextThoughtNeeded": true,  "branches": ["cheaper-route"],  "thoughtHistoryLength": 4}

{  "thoughtNumber": 2,  "totalThoughts": 5,  "nextThoughtNeeded": true,  "branches": ["cheaper-route"],  "thoughtHistoryLength": 4}

thoughtNumber / totalThoughts — where the chain stands. If thoughtNumber exceeds the estimated totalThoughts, the total is raised to thoughtNumber.
nextThoughtNeeded — whether the chain continues. Sending needsMoreThoughts: true also reports this as true.
branches — the id of every branch created so far, in creation order.
thoughtHistoryLength — how many thoughts the server has recorded, including this one.

Missing or mistyped fields are refused with an error result (isError) naming the offending field; nothing is recorded for a rejected call.

Development

bash

npm installnpm run build   # tsc -> dist/npm test        # tsx --test test/*.test.tsnpm run dev     # run the CLI from source

npm installnpm run build   # tsc -> dist/npm test        # tsx --test test/*.test.tsnpm run dev     # run the CLI from source

License

MIT — see LICENSE.

Source: README.md at commit 3c77675

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.0LatestOct 29, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts