UltraThink

You can run the UltraThink MCP Server to enable structured, multi-session problem solving with confidence scoring and branching in a lightweight, command-line MCP environment. This server exposes a single tool for dynamic thinking and integrates with MCP clients to manage thinking sessions, track thoughts, and report outcomes in a typed, validated way.

How to use

Plan your problem-solving sessions around clear thinking steps. Use a dedicated session ID to keep related thoughts together, and take advantage of auto-assigned thought numbers, branching, and confidence scoring to capture your reasoning as it progresses. Remember that session data is stored in memory and will be lost if the server restarts; plan persistence separately if you need durable history.

How to install

Prerequisites: you need Python installed on your system and access to a shell/terminal.

# Quick install and run via a prebuilt tool
uvx --from git+https://github.com/husniadil/ultrathink ultrathink

If you prefer to develop locally, clone the project and set up dependencies, then run using the local development flow.

# Local development setup
git clone https://github.com/husniadil/ultrathink.git
cd ultrathink

# Install dependencies (including dev dependencies)
uv sync

Configuration

Environment variable to control logging of thoughts in the terminal output:

DISABLE_THOUGHT_LOGGING: "false"  # Enables colored thought logging by default

Session Management

Sessions are kept in memory. They do not persist across server restarts. Each session is identified by a unique session ID and tracks thought history, branch tracking, and sequential numbering. For production use, provide your own persistence layer if you need durable session state.

Architecture

The server uses a simple three-layer structure with models, services, and an interface. This clean separation makes it easy to test and extend. The CLI entry point enables starting the server with a single command, while the interface layer handles MCP client communication.

Additional notes

New features focus on structured thinking, confidence scoring, multi-session management, and explicit logging. You can test and run the server with strict type checking and a complete test suite.

Tool: ultrathink

The server exposes a single tool for dynamic and reflective problem-solving through structured thinking. Key parameters include the thought text, total_thoughts, and optional session management and branching controls.

Examples and best practices

Create a session, submit thoughts in sequence, and optionally branch from a previous thought to explore alternative approaches. Use confidence scores to capture how certain you are about each thought. Track outcomes and uncertainty notes to document results and caveats.

Available tools

ultrathink

Dynamic problem-solving tool with structured thinking, confidence scoring, auto-thought numbering, and multi-session support.