MCP Sequential Thinking Server

An MCP (Model Context Protocol) server that provides sequential thinking capabilities with intelligent tool and skill recommendations for AI assistants.

Features

• Sequential Thinking Framework: Break down complex problems into structured thought steps
• Tool Recommendations: AI-driven tool selection with confidence scores and rationales
• Skill Integration: Support for Claude Code skills with automatic discovery
• Branching & Revision: Non-linear thinking paths with thought revision support
• History Management: Configurable thought history with automatic trimming
• Type-Safe: Full TypeScript support with Valibot validation

Install

Requires Node.js v18+.

From the project root:

chmod +x install-mcp-sequentialthinking-tools.sh
./install-mcp-sequentialthinking-tools.sh

This script will:

1. Check prerequisites (Node.js, npm)
2. Install dependencies and build the project
3. Install sequentialthinking-tools globally

Verify the installation:

sequentialthinking-tools --help

Tip: Use ./install-mcp-sequentialthinking-tools.sh --link for development mode (symlinks instead of copying, rebuild with npm run build after changes).

Configure MCP Client

The server uses stdio transport by default — no extra configuration needed. Add it to your MCP client:

Claude Code

User-scoped (~/.claude.json) or project-scoped (.mcp.json in project root):

{
  "mcpServers": {
    "sequentialthinking-tools": {
      "command": "sequentialthinking-tools"
    }
  }
}

Or via CLI:

claude mcp add sequentialthinking-tools -- sequentialthinking-tools

Codex CLI

User-scoped (~/.codex/config.toml) or project-scoped (.codex/config.toml):

[mcp_servers.sequentialthinking-tools]
command = "sequentialthinking-tools"

Or via CLI:

codex mcp add sequentialthinking-tools -- sequentialthinking-tools

OpenCode

Global (~/.config/opencode/opencode.json) or project-scoped (.opencode.json):

{
  "mcpServers": {
    "sequentialthinking-tools": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "sequentialthinking-tools"
      ],
      "enabled": true,
      "environment": {
        "MAX_HISTORY_SIZE": "10000"
      }
    },
  }
}

Configuration

Variable	Default	Description
MAX_HISTORY_SIZE	1000	Maximum thoughts to keep in history

Transports

The server supports three transports via the TRANSPORT_TYPE environment variable:

Transport	Use Case	Command
stdio (default)	Local MCP clients	sequentialthinking-tools
sse (legacy)	Multi-user, backwards compat	TRANSPORT_TYPE=sse sequentialthinking-tools
streamable-http	Production deployments	TRANSPORT_TYPE=streamable-http sequentialthinking-tools

Development

npm install
npm run dev        # MCP inspector
npm test
npm run type-check
npm run lint

License

MIT