Thoughtbox

What is Thoughtbox?

Thoughtbox is a Model Context Protocol (MCP) server that facilitates a detailed, step-by-step thinking process for problem-solving and analysis. It is designed for breaking down complex problems into manageable steps, revising and refining thoughts as understanding deepens, branching into alternative reasoning paths, and generating and verifying solution hypotheses. It is the successor to Waldzell AI's Clear Thought.

How to use Thoughtbox?

Install via Smithery (npx -y @smithery/cli install @Kastalien-Research/clear-thought-two) or by adding it to your claude_desktop_config.json with npx -y clear-thought-two. Invoke the thoughtbox tool, providing the current thought, whether another step is needed, thought number, total thoughts, and optional parameters for revision, branching, and requesting more thoughts.

Key features of Thoughtbox

• Break down complex problems into manageable steps
• Revise and refine thoughts as understanding deepens
• Branch into alternative paths of reasoning
• Dynamically adjust the total number of thoughts
• Generate and verify solution hypotheses

Use cases of Thoughtbox

• Breaking down complex problems into sequential steps
• Planning and design with room for revision and course correction
• Analysis where the full scope may not be clear initially
• Tasks that need to maintain context over multiple steps
• Filtering out irrelevant information during reasoning

FAQ from Thoughtbox

What thinking approaches does Thoughtbox support?

Thoughtbox supports forward thinking (sequential), backward thinking (goal-driven), and mixed/branched thinking combining both approaches with revision and branch parameters. A comprehensive guide with 7 core reasoning patterns is available in the Thoughtbox Patterns Cookbook.

How do I install and run Thoughtbox locally?

Install locally via Smithery or add "clear-thought-two": { "command": "npx", "args": ["-y", "clear-thought-two"] } to your Claude Desktop or VS Code (Cline) configuration. For local development, build with npm run build:stdio and run with npm run start:stdio.

What transports does Thoughtbox support?

Thoughtbox supports both STDIO transport (for local development) and HTTP transport (for production deployments via Smithery). The HTTP transport provides streamable transport, automatic containerization, and an interactive development playground.

What environment variables are available?

DISABLE_THOUGHT_LOGGING=true disables thought logging to stderr. For production deployments on Smithery, you can configure disableThoughtLogging in the settings.

What license is Thoughtbox under?

Thoughtbox is licensed under the MIT License, allowing free use, modification, and distribution subject to the terms of that license.