# MAXential Thinking MCP server

> Provides a persistent reasoning workspace for AI to build thought chains, explore alternative paths through branching, and manage complex reasoning sessions.

- Repository: https://github.com/BAM-DevCrew/MAXential-Thinking-MCP
- Page: https://hostedmcp.org/servers/bam-devcrew/maxential-thinking-mcp
- Transport: stdio
- Stars: 3
- License: MIT
- Latest version: 2.0.1

## Install

### Claude Code

```sh
claude mcp add maxential-thinking-mcp -- npx -y @bam-devcrew/maxential-thinking-mcp
```

### Cursor (`~/.cursor/mcp.json`)

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

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "maxential-thinking-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bam-devcrew/maxential-thinking-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"maxential-thinking-mcp","type":"stdio","command":"npx","args":["-y","@bam-devcrew/maxential-thinking-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

```sh
codex mcp add maxential-thinking-mcp -- npx -y @bam-devcrew/maxential-thinking-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.maxential-thinking-mcp]
command = "npx"
args = ["-y", "@bam-devcrew/maxential-thinking-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user maxential-thinking-mcp npx -- -y @bam-devcrew/maxential-thinking-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `MAXENTIAL_DB_PATH` | no | no |  |
| `MAXENTIAL_LOG_FILE` | no | no |  |

## Tools (20)

- `think`
- `revise`
- `complete`
- `reset`
- `branch`
- `switch_branch`
- `list_branches`
- `get_branch`
- `close_branch`
- `merge_branch`
- `get_thought`
- `get_history`
- `tag`
- `search`
- `export`
- `visualize`
- `session_save`
- `session_load`
- `session_list`
- `session_summary`

## FAQ

### How does MAXential handle session persistence?

Sessions are automatically saved to a SQLite database, allowing reasoning to survive server restarts, context window resets, and new conversations.

### Can I explore multiple ideas without losing my main thought process?

Yes, you can use the branching tools to create new reasoning paths to explore alternatives and then merge the insights back into the main thread.

### What happens if the SQLite database fails to initialize?

The server is designed to be resilient and will automatically fall back to in-memory mode if SQLite initialization fails.

### Can I export my reasoning history?

Yes, you can export the thinking chain in either Markdown or JSON formats.
