MAXential Thinking MCP Server

A Model Context Protocol (MCP) server that provides structured reasoning tools for AI models. Think of it as git for thoughts - branch, revise, merge, and navigate your reasoning chains.

Why?

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

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"]
    }
  }
}

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

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