@gotza02/ultimatethinking

The Ultimate MCP Server for Sequential Thinking

Advanced Sequential Thinking MCP Server for dynamic and reflective problem-solving. Features session management, goal tracking, branching, and security enhancements.

Features

• Sequential Thinking: Break down complex problems into manageable steps
• Session Management: Create and manage multiple thinking sessions
• Goal Tracking: Set goals with success criteria and milestones
• Progress Tracking: Automatic progress calculation
• Branching: Explore alternative paths of reasoning
• Revision Support: Revise and refine previous thoughts
• Thought Categories: analysis, hypothesis, conclusion, revision, verification, insight, question, action
• Confidence Levels: Track confidence (0-100) for each thought
• Tags & References: Organize and link thoughts together

Security

• Prototype Pollution Protection: Blocked dangerous branch IDs
• Memory Limits: Configurable limits for history, branches, and sessions
• Input Validation: Comprehensive Zod schema validation

Installation

Option 1: Install globally

npm install -g @gotza02/ultimatethinking

Option 2: Use with npx (no installation required)

npx @gotza02/ultimatethinking

Usage with MCP Clients

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

Using npx (Recommended)

{
  "mcpServers": {
    "ultimatethinking": {
      "command": "npx",
      "args": ["-y", "@gotza02/ultimatethinking"]
    }
  }
}

Using global install

{
  "mcpServers": {
    "ultimatethinking": {
      "command": "ultimatethinking"
    }
  }
}

Using local path

{
  "mcpServers": {
    "ultimatethinking": {
      "command": "node",
      "args": ["/path/to/ultimatethinking/dist/index.js"]
    }
  }
}

Kimi-CLI

Edit ~/.kimi/mcp.json:

{
  "mcpServers": {
    "ultimatethinking": {
      "command": "npx",
      "args": ["-y", "@gotza02/ultimatethinking"]
    }
  }
}

Gemini-CLI

Edit ~/.gemini/settings.json:

{
  "mcpServers": {
    "ultimatethinking": {
      "command": "npx",
      "args": ["-y", "@gotza02/ultimatethinking"]
    }
  }
}

Available Tools

1. sequential_thinking (Primary)

Main thinking tool for problem-solving.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | thought | string | Yes | Current thinking step | | nextThoughtNeeded | boolean | Yes | Whether more thinking needed | | thoughtNumber | integer | Yes | Current thought number (1, 2, 3...) | | totalThoughts | integer | Yes | Estimated total thoughts | | category | enum | No | analysis, hypothesis, conclusion, revision, verification, insight, question, action | | confidence | integer | No | Confidence level (0-100) | | isRevision | boolean | No | Whether this revises previous thinking | | revisesThought | integer | No | Which thought is being reconsidered | | branchFromThought | integer | No | Branching point thought number | | branchId | string | No | Branch identifier | | references | string[] | No | IDs of referenced thoughts | | tags | string[] | No | Tags for categorization |

2. create_thinking_session

Create a new thinking session with optional goal.

3. set_session_goal

Set or update goal for current session.

4. get_session_info

Get current session statistics and progress.

5. get_thought_history

Get all thoughts from current session.

6. clear_session

Clear all thoughts (keeps session active).

Configuration

| Setting | Default | Description | |---------|---------|-------------| | maxHistorySize | 1000 | Max thoughts per session | | maxBranches | 100 | Max branches per session | | maxSessions | 10 | Max concurrent sessions |

System Instruction for AI

See SYSTEM_INSTRUCTION.md for detailed configuration.

Quick System Prompt

You have access to @gotza02/ultimatethinking MCP.
For complex questions requiring analysis, planning, or reasoning:
USE sequential_thinking FIRST.
Do NOT ask permission - use it automatically.
Only respond AFTER completing your thinking process.

Development

# Clone
git clone https://github.com/gotza02/ultimatethinking.git
cd ultimatethinking

# Install
npm install

# Build
npm run build

# Run locally
npm start
# or
node dist/index.js

Architecture

src/
├── index.ts           # MCP server entry point
├── session-manager.ts # Session & thought management
├── types.ts           # TypeScript definitions
├── schemas.ts         # Zod validation schemas
└── utils.ts           # Utilities & LRU cache

Publishing

# Login to npm
npm login

# Publish
npm publish --access public

License

MIT © gotza