ejentum/ejentum-mcp

MCP server that improves LLM reasoning on complex, multi-step, or multi-constraint tasks. Before the agent generates, it calls one of eight tools to retrieve a *cognitive operation*: a structured procedure (numbered steps with the failure pattern to refuse and a falsification test) paired with an executable reasoning topology (a DAG of those steps with decision gates, parallel branches, bounded loops, meta-cognitive exits, and escape paths). The agent reads both layers before producing its response.
Eight tools split into two retrieval modes:
- **Dynamic** (4 tools: reasoning, code, anti-deception, memory): the top-1 abstract operation from a library of 679, selected by semantic match on the query string. Available on all tiers including the 30-day free trial.
- **Adaptive** (4 tools: adaptive-reasoning, adaptive-code, adaptive-anti-deception, adaptive-memory): the same retrieval pool, but an adapter LLM rewrites every step and DAG node in the matched operation with task-specific identifiers (e.g., extract_duration_estimates becomes extract_migration_duration_estimates(DDL_time|backfill_time|trigger_overhead|lock_hold_time)). Adds ~2-3 s of latency; requires the Go or Super tier.
Two install paths use the same EJENTUM_API_KEY:
1. **Stdio** via npx -y ejentum-mcp for Claude Desktop, Cursor, Windsurf, Codex CLI, Claude Code, Cline, Continue, and any client that spawns MCP servers as subprocesses.
2. **Hosted Streamable HTTP** at https://api.ejentum.com/mcp for n8n MCP Client and any HTTP-MCP client. Send Authorization: Bearer YOUR_EJENTUM_API_KEY.
---
Install
You need:
- An Ejentum API key. 30-day free trial (no card) at ejentum.com/pricing.
- Node.js 18+.
Install from npm
Or skip the install and reference it with npx -y ejentum-mcp directly in your client config (shown below).
Manual install
Claude Desktop
Open claude_desktop_config.json:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Restart Claude Desktop. The eight tools appear in the tool picker.
Cursor / Windsurf
Open MCP settings → Add new MCP server → paste the same ejentum block as above.
Claude Code (CLI)
n8n MCP Client node
Add an MCP Client node, transport stdio, command npx, args ["-y", "ejentum-mcp"], env { "EJENTUM_API_KEY": "ej_..." }.
---
Wire contract
The stdio MCP server and the hosted endpoint both proxy to the same upstream:
The response is an array of length 1 with a single key matching the request mode. Use bracket access (result[0]["anti-deception"]) for the hyphenated keys; dot access parses the hyphen as subtraction in JavaScript and Python attribute access.
The injection string is plain text containing seven fields. See Field structure below.
---
Tool inventory
Dynamic (single retrieval, all tiers including the 30-day trial)
| Tool name | Mode string | Library size |
|---|---|---:|
| reasoning | reasoning | 311 operations across abstraction, time, causality, simulation, spatial, metacognition |
| code | code | 128 operations across the software-engineering layer |
| anti-deception | anti-deception | 139 operations across sycophancy, hallucination, deception, adversarial framing, judgment, executive control |
| memory | memory | 101 operations in the perception layer (filter-oriented; do not call for fact extraction) |
Adaptive (top-k retrieval + adapter LLM rewrite; Go or Super tier required)
| Tool name | Mode string | Behavior vs dynamic |
|---|---|---|
| adaptive-reasoning | adaptive-reasoning | Same retrieval pool, top-5 then picker, then adapter LLM rewrites PROCEDURE and REASONING TOPOLOGY fields with task-specific identifiers. Adds ~2-3 s of latency. |