Thoughtbox
next-gen reasoning MCP for agentic AI's Wave Two. successor to Waldzell AI's Clear Thought server.
What is Thoughtbox?
Thoughtbox is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to next-gen reasoning mcp for agentic ai's wave two. successor to waldzell ai's clear thought server.
next-gen reasoning MCP for agentic AI's Wave Two. successor to Waldzell AI's Clear Thought server.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- next-gen reasoning MCP for agentic AI's Wave Two. successor
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @kastalien-research/thoughtboxManual Installation
npx -y @kastalien-research/thoughtboxConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Thoughtbox
Thoughtbox is a next-generation reasoning MCP server designed for agentic AI workflows, serving as the successor to the Waldzell AI Clear Thought server. It provides structured multi-step reasoning tools — including forward, backward, branching, revision, and critique patterns — along with a web-based Observatory UI for observability, multi-agent collaboration via a Hub with six agent profiles, and flexible storage backends including filesystem, in-memory, and Supabase cloud storage.
Prerequisites
- Docker and Docker Compose (recommended for quickest setup), or Node.js 22+ with pnpm for local development
- An MCP-compatible client such as Claude Desktop or Claude Code
- For Supabase storage: a Supabase project URL and service role key
- Ports 1731 (MCP server) and 1729 (Observatory UI) available on your machine
Clone the repository
Clone the Thoughtbox repository from GitHub.
git clone https://github.com/Kastalien-Research/thoughtbox.git
cd thoughtboxStart with Docker Compose (recommended)
Build and launch the Thoughtbox server using Docker Compose. The MCP server will be available at http://localhost:1731/mcp.
docker compose up --buildOptional: enable the Observatory UI
Set the THOUGHTBOX_OBSERVATORY_ENABLED environment variable to true to activate the web-based observability dashboard at http://localhost:1729.
THOUGHTBOX_OBSERVATORY_ENABLED=true docker compose up --buildAlternative: local Node.js setup
If you prefer running without Docker, install dependencies and build with pnpm on Node.js 22+.
pnpm install
pnpm build
pnpm devConfigure your MCP client
Add the Thoughtbox server to your MCP client configuration. Since it runs as an HTTP server, the config uses a URL rather than a command.
Thoughtbox Examples
Client configuration
Add this to your Claude Desktop config or Claude Code settings.json. Thoughtbox runs as an HTTP MCP server, so the connection uses a URL.
{
"mcpServers": {
"thoughtbox": {
"url": "http://localhost:1731/mcp"
}
}
}Prompts to try
Use these prompts to engage Thoughtbox's structured reasoning capabilities in Claude.
- "Use thoughtbox_execute to analyze why our checkout page takes 45 seconds to load using forward sequential reasoning"
- "Use thoughtbox_search to find all thoughts and proposals related to the authentication refactor"
- "Apply branching reasoning to compare PostgreSQL vs MongoDB for our new events table"
- "Use the critique pattern to review this API design and identify weaknesses"
- "Set up a multi-agent session with an ARCHITECT and REVIEWER profile to evaluate this system design"Troubleshooting Thoughtbox
MCP client cannot connect to http://localhost:1731/mcp
Verify Docker containers are running with `docker compose ps`. Check that port 1731 is not blocked by a firewall or used by another process. Try `curl http://localhost:1731/mcp` to confirm the server responds.
Supabase storage mode fails to initialize
Set both SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY environment variables. The service role key (not the anon key) is required. Verify the values in your Supabase project's API settings page.
Observatory UI at port 1729 is blank or unreachable
Ensure THOUGHTBOX_OBSERVATORY_ENABLED is set to true before starting. If using Docker, confirm that port 1729 is mapped in your docker-compose.yml or that you passed the environment variable correctly.
Frequently Asked Questions about Thoughtbox
What is Thoughtbox?
Thoughtbox is a Model Context Protocol (MCP) server that next-gen reasoning mcp for agentic ai's wave two. successor to waldzell ai's clear thought server. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Thoughtbox?
Install via npm with the command: npx -y @kastalien-research/thoughtbox. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Thoughtbox?
Thoughtbox works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Thoughtbox free to use?
Yes, Thoughtbox is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Thoughtbox Alternatives — Similar Coding Agents Servers
Looking for alternatives to Thoughtbox? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Thoughtbox in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Thoughtbox?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.