thoughtbox_searchLABSCO SUMMARY
Two tools that do not grow with the feature set.
Instead of registering a tool per operation, everything is reached by writing JavaScript against a catalog, so the context cost stays flat as the operation list grows. Worth knowing before you commit: the author says it is currently tuned for Claude Code, with other clients still being worked on.
What it is
An MCP server for structured, multi-agent reasoning. Every step is recorded as a numbered, timestamped thought linked to its predecessors and kept across sessions, with a browser UI for watching it happen live.
What you get
- Exactly two MCP tools —
thoughtbox_searchto query the catalog with JavaScript, andthoughtbox_executeto chain operations through thetbSDK - Four reasoning patterns as first-class operations: forward from 1 to N, backward from the goal, branching into parallel explorations, and revision of an earlier thought
- Thought types that record what kind of step it was —
reasoning,decision_frame,action_report,belief_snapshot,assumption_update,context_snapshot,progress - 28 operations covering identity, workspace management, problems, proposals, consensus, channels and status reporting
- Six agent profiles with their own mental models:
MANAGER,ARCHITECT,DEBUGGER,SECURITY,RESEARCHER,REVIEWER - The Observatory at
http://localhost:1729— a live graph over WebSocket, branches collapsed into clickable stubs, a detail panel per node, and switching between active sessions - A knowledge graph that survives sessions, with typed relations such as
BUILDS_ON,CONTRADICTSandSUPERSEDESand visibility set topublic,agent-privateorteam-private - Notebooks that mix documentation with executable JavaScript or TypeScript in an isolated environment
Requirements
Docker and Docker Compose — docker compose up --build brings up the server on port 1731 with the Observatory on 1729 and the observability stack behind them. Storage defaults to the filesystem under ~/.thoughtbox; the supabase backend needs SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY. Local development needs Node.js 22+. MIT.
Setup effort
Build from source — git clone https://github.com/Kastalien-Research/thoughtbox.git
USE CASES
01
Showing how a conclusion was reached
Each thought is numbered, timestamped and linked to what came before, so the chain can be exported and read afterwards.
02
Comparing two designs without losing either
Fork into parallel branches, develop both, then record the synthesis as its own thought.
03
Planning backwards from a target
Start at the goal state and work back to where you are now, one prerequisite at a time.
04
Splitting a problem between several agents
Register the agents, create the workspace and the problem, let one claim it, propose a solution and have another review before it merges.
05
Watching a long reasoning run as it happens
Open the Observatory and the nodes appear live; click one to read the full thought, or drill into a collapsed branch.
06
Correcting something you concluded earlier
Revision is an operation rather than an edit, so the original and the correction both stay in the record.
2 tools
Listed in project docs. Your client may show a different list.
thoughtbox_executeBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
docker on PATH
Where it runs
All 3 documented setups run the server on your machine.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/Kastalien-Research/thoughtbox.git
cd thoughtbox
docker compose up --buildMCP Clients
Claude Code
CLAUDE CODE · JSON
{
"mcpServers": {
"thoughtbox": {
"type": "http",
"url": "http://localhost:1731/mcp"
}
}
}Claude Code — via sidecar
The sidecar is the observability proxy the same docker compose up --build starts on port 4000 (it adds OpenTelemetry tracing); connect to it instead of the main server on 1731.
CLAUDE CODE — VIA SIDECAR · JSON
{
"mcpServers": {
"thoughtbox": {
"type": "http",
"url": "http://localhost:4000/mcp"
}
}
}Cline
CLINE · JSON
{
"mcpServers": {
"thoughtbox": {
"type": "streamableHttp",
"url": "http://localhost:1731/mcp"
}
}
}
