io.github.BAM-DevCrew/MAXential-Thinking-MCP

The most advanced sequential reasoning MCP for autonomous AI workflows

Enables structured problem-solving with parallel exploration, branch navigation, and persistent thought chains that survive context window compaction.

Built by a developer working with AI to solve real autonomous reasoning challenges. Extends dormant branching capabilities in Anthropic's original sequential-thinking server.

Why we created MAXential Thinking

Reasoning is Ephemeral: AI model, LLM, reasoning is ephemeral. When context windows fill up, thinking gets compressed or is lost. Complex problems and brainstorming need exploration of multiple ideas and approaches. We wanted a way to optimize AI's abilities by having them think in parallel, with multisteps, backtracking when needed, and to summarize their findings.

Branching Chains: While designing MAXential Thinking to enable reasoning through multiple thought-chains, we looked to Anthropic's sequential-thinking server for inspiration. We discovered it had branching capabilities in its schema but no tools to access them. So we forked it and expanded their dormant branching with 11 tools that allow AI to actively reason.

For AI Assistants (Claude, ChatGPT, etc.)

Using this MCP server instead of Sequential Thinking MCP, you gain:

Structured Reasoning That Persists

• Thought chains survive context window compaction
• Navigate back to earlier reasoning without losing context
• Revise earlier thoughts as understanding evolves
• Export complete reasoning chains for handoff or documentation

Parallel Exploration

• Branch to explore different approaches/ideas/thoughts simultaneously
• Compare solutions/outcomes side-by-side before choosing
• Merge insights back to main reasoning thread
• Close branches that come up empty without impacting main thread

Autonomous Workflow Enhancement

• Tag thoughts for semantic organization (hypothesis, evidence, decision, finding)
• Search your reasoning history by content or tags
• Generate diagrams of your thought process (Mermaid/ASCII)
• Build complex solutions with transparent reasoning

What Makes This Different

Original sequential-thinking: 1 tool with 9 parameters. Branch parameters existed but no way to use them.

MAXential Thinking v2.3: 20 focused tools that match reasoning patterns:

• No parameter juggling - simply call the right tool
• Branching works - explore, switch, merge, close

AI models benefit from structured thinking. This server externalizes that process, making it:

• Transparent - See the reasoning chain, not just conclusions
• Navigable - Branch to explore alternatives, backtrack, revise
• Searchable - Find thoughts by content or tags
• Exportable - Share reasoning as markdown or JSON

Features

Core Thinking (v2.0)

Tool	Description
think	Add a thought to your reasoning chain
revise	Revise a previous thought
complete	Mark thinking chain complete with conclusion

Branching (v2.0)

Tool	Description
branch	Create a new reasoning branch (like git)
switch_branch	Switch between branches (use "main" to return)
list_branches	List all branches with status
get_branch	Get details of a specific branch
close_branch	Close a branch with optional conclusion
merge_branch	Merge insights back to main

Navigation (v2.0)

Tool	Description
get_thought	Retrieve a specific thought by number
get_history	Get thought history, optionally filtered

Organization (v2.2)

Tool	Description
reset	Clear session, start fresh
tag	Add semantic tags to thoughts (hypothesis, evidence, decision, etc.)
search	Find thoughts by content or tags
export	Export to markdown or JSON
visualize	Generate ASCII or Mermaid diagrams

Session Persistence (v2.3)

Tool	Description
session_save	Name and describe the current session for later retrieval
session_load	Restore a saved session — all thoughts, branches, and tags
session_list	Browse available sessions, filter by status
session_summary	Generate a compressed summary for token-efficient context loading

Thinking sessions are automatically persisted to SQLite as you work. Every think, branch, tag, and revise call writes through to disk in real time. Sessions survive server restarts and context window resets — pick up where you left off in a new conversation.

Installation

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "npx",
      "args": ["-y", "@bam-devcrew/maxential-thinking-mcp"]
    }
  }
}

From Source

git clone https://github.com/BAM-DevCrew/MAXential-Thinking-MCP.git
cd MAXential-Thinking-MCP
npm install
npm run build

Then configure:

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "node",
      "args": ["/path/to/MAXential-Thinking-MCP/dist/src/index.js"]
    }
  }
}

Configuration

Persistence (v2.3)

Session data is stored in SQLite. By default, the database file is created at .maxential/thinking.db in the working directory. You can customize this:

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "npx",
      "args": ["-y", "@bam-devcrew/maxential-thinking-mcp"],
      "env": {
        "MAXENTIAL_DB_PATH": "/path/to/your/thinking.db"
      }
    }
  }
}

MAXENTIAL_DB_PATH value	Behavior
(not set)	.maxential/thinking.db in working directory (default)
/path/to/file.db	Use explicit file path
:memory:	In-memory SQLite — no file created, data lost on restart

If SQLite initialization fails (permissions, native module issues), the server falls back to in-memory mode automatically — it never crashes.

Note: Add .maxential/ to your project's .gitignore to keep session data out of version control.

Usage Examples

Basic Thinking

think: "The user wants to optimize database queries"
think: "First, I should check for N+1 query problems"
think: "Found 3 N+1 issues in the user service"
tag: thoughtNumber=3, add=["finding", "database"]
complete: "Fixed N+1 queries, reduced load time by 40%"

Branching for Alternatives

think: "Should we use REST or GraphQL?"
branch: branchId="rest-approach", reason="Exploring REST"
think: "REST is simpler, better caching"
switch_branch: branchId="main"
branch: branchId="graphql-approach", reason="Exploring GraphQL"
think: "GraphQL reduces overfetching"
merge_branch: branchId="rest-approach", strategy="summary"

Search and Export

search: query="database"           # Find by content
search: tags=["decision"]          # Find by tag
export: format="markdown"          # Get full chain as markdown
visualize: format="mermaid"        # Get diagram for docs

Session Persistence

think: "Working through the auth redesign..."
think: "JWT approach has these tradeoffs..."
session_save: name="Auth redesign analysis"

# Later, in a new conversation:
session_list:                      # Browse saved sessions
session_load: id="<session-uuid>"  # Restore full context
think: "Continuing where I left off..."
session_summary: id="<session-uuid>"  # Get compressed recap

Visualization Output

Mermaid (for GitHub, Obsidian, etc.)

graph TD
    T1["#1"] --> T2["#2"]
    T1 --> T3["#3"]
    T3 -.revises.-> T1

    subgraph alt-approach
        T2
    end

ASCII

Thinking Chain
==============

T1 --> T2 --> T3
Branch [alt-approach] from T1

Revisions:
  T3 revises T1

Logging

Enable file logging by setting environment variable:

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "node",
      "args": ["/path/to/dist/src/index.js"],
      "env": {
        "MAXENTIAL_LOG_FILE": "/path/to/error.log"
      }
    }
  }
}

Development

npm install          # Install dependencies
npm run build        # Build TypeScript
npm run watch        # Watch mode for development

License

MIT

Contributing

Issues and PRs welcome at github.com/BAM-DevCrew/MAXential-Thinking-MCP