Cortex MCP — Multi-Level Reasoning Server MCP server

Cortex MCP

Multi-level reasoning MCP server with configurable depth levels, session-based state management, structured thought input, and real-time trace resources.

Overview

Cortex MCP is a stdio-only MCP server for stateful, depth-controlled reasoning. The runtime entrypoint in src/index.ts connects createServer() to StdioServerTransport, and the server surface in src/server.ts enables tools, prompts, completions, logging, and subscribable resources around a single session-based reasoning engine.

The live MCP surface confirmed by Inspector is 1 tool, 6 concrete resources, 4 resource templates, and 7 prompts. Sessions are stored in memory, exposed as MCP resources, and cleared on process restart.

Key Features

• reasoningthink supports step-by-step sessions, runto_completion batches, rollback, early conclusion, and structured observation / hypothesis / evaluation input.
• Four depth levels are built into the engine: basic, normal, high, and expert, each with bounded thought ranges and token budgets.
• Prompt helpers expose reasoning.basic, reasoning.normal, reasoning.high, reasoning.expert, reasoning.continue, reasoning.retry, and get-help.
• Resource endpoints expose internal docs plus live session lists, per-session JSON views, full markdown traces, and individual thought documents.
• Completions are wired for levels, session IDs, and thought names through completable() and resource-template completion hooks.

Requirements

• Node.js >=24 for local npx or npm usage.
• An MCP client that supports stdio transport.
• Optional: Docker if you want to build or run the container image defined by Dockerfile.

Quick Start

Use this standard MCP client configuration:

{
  "mcpServers": {
    "cortex-mcp": {
      "command": "npx",
      "args": ["-y", "@j0hanz/cortex-mcp@latest"]
    }
  }
}

Client Configuration

Install in VS Code

Shortened. The full README is on GitHub.