ejentum_scaffold
Retrieve a deterministic reasoning scaffold (Reasoning-Augmented Retrieval) to prevent hallucinations, causal inversion, and compounding multi-step failures.
modequeryrequiredstack_size
io.github.ejentumPublished by GitHub account ejentumv0.2.2Updated Oct 25, 2026
Reasoning, code, anti-deception, memory harness MCP tools. Stdio or HTTPS api.ejentum.com/mcp
Ejentum MCP retrieves structured reasoning procedures and DAG topologies that an assistant applies before answering complex, multi-step tasks.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.ejentum%2Fejentum-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"ejentum": {
"type": "http",
"url": "https://api.ejentum.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}[npm version] [License: MIT] [Node] [MCP Registry] [Glama score] [Last commit]
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:
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-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:
npx -y ejentum-mcp for Claude Desktop, Cursor, Windsurf, Codex CLI, Claude Code, Cline, Continue, and any client that spawns MCP servers as subprocesses.https://api.ejentum.com/mcp for n8n MCP Client and any HTTP-MCP client. Send Authorization: Bearer YOUR_EJENTUM_API_KEY.You need:
Or skip the install and reference it with npx -y ejentum-mcp directly in your client config (shown below).
Open claude_desktop_config.json:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonRestart Claude Desktop. The eight tools appear in the tool picker.
Open MCP settings → Add new MCP server → paste the same ejentum block as above.
Add an MCP Client node, transport stdio, command npx, args ["-y", "ejentum-mcp"], env { "EJENTUM_API_KEY": "ej_..." }.
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.
Each tool takes one argument, query (string, 1-2 sentences describing the task). Returns the injection string.
Every retrieved record contains seven labelled blocks plus a cognitive payload. The exact set of labels varies by mode:
The fields appear in this fixed order in every response. Each mode uses its own label for the same slot (e.g., [PROCEDURE] in reasoning corresponds to [ENGINEERING PROCEDURE] in code):
The same six-slot order holds for both dynamic and adaptive variants of every mode. In adaptive responses, the adapter LLM rewrites slots 1 and 2 (procedure and topology) with task-specific identifiers; slots 3-6 are returned verbatim.
The topology block uses a flat string notation:
The DAG is meant to be read by the LLM as a structured outline of the reasoning path, not executed by a host runtime. The labelled-step structure persists across long context windows where prose-only reasoning specifications lose retrieval salience.
Query (used for both calls):
Evaluate whether a database migration plan that adds a NOT NULL column to a 50M-row table is safe under concurrent writes, given that the backfill strategy uses a trigger-based default.
The picker matched the same operation in both calls ("realistic duration estimation" with the Hofstadter buffer). The [NEGATIVE GATE], [TARGET PATTERN], [FALSIFICATION TEST], and [COGNITIVE PAYLOAD] fields are identical between the two responses (the adapter does not rewrite them). The [PROCEDURE] and [REASONING TOPOLOGY] fields differ: the adaptive response replaces abstract identifiers with task-specific ones.
reasoning response (truncated to the differing fields)adaptive-reasoning response (same query, same picked operation)Returned in the canonical order: cognitive payload, falsification test, negative gate, target pattern.
This is the contract: dynamic returns the matched abstract operation; adaptive returns the same operation with PROCEDURE and topology nodes rewritten in terms of the caller's task (DDL execution time, lock_blocking_app_queries, trigger-based backfill on a table this size) while preserving the operation's structural identity, the safety language, and the cognitive payload verbatim.
The MCP wrapper is stateless. No local logging, no telemetry, no third-party calls. The upstream API counts requests against the key for billing; the request body (the query string) is consumed for retrieval and not retained beyond the response.
Smoke test against the live API:
Interactive testing with MCP Inspector:
MIT. See LICENSE.
Source: README.md at commit 5cd30e8
Retrieve a deterministic reasoning scaffold (Reasoning-Augmented Retrieval) to prevent hallucinations, causal inversion, and compounding multi-step failures.
modequeryrequiredstack_sizeList the 6 invariant cognitive failure dimensions and primary failure modes mapped by Ejentum.
Takes no parameters.
Traverse the 933-edge cognitive synergy graph to compose a multi-hop Cognitive Directed Acyclic Graph (DAG) with Root, Prerequisite, Amplifier, and Fallback operators.
depthqueryability_idExecute sub-millisecond SQLite FTS5 full-text keyword search and BM25 ranking across the 311 deterministic reasoning abilities.
limitqueryrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
npm install ejentum-mcp{ "mcpServers": { "ejentum": { "command": "npx", "args": ["-y", "ejentum-mcp"], "env": { "EJENTUM_API_KEY": "ej_..." } } }}claude mcp add ejentum -e EJENTUM_API_KEY=ej_... -- npx -y ejentum-mcpPOST https://api.ejentum.com/harness/Headers: Authorization: Bearer <EJENTUM_API_KEY> Content-Type: application/jsonBody: { "query": "<string, 1-2 sentences describing the task>", "mode": "reasoning" | "code" | "anti-deception" | "memory" | "adaptive-reasoning" | "adaptive-code" | "adaptive-anti-deception" | "adaptive-memory" }Response (200): [ { "<mode>": "<injection string, ~2-4 KB>" } ]Response (401): { "error": "Unauthorized; check EJENTUM_API_KEY" }Response (403): { "error": "Adaptive modes require Go or Super tier" }Response (429): { "error": "Rate limit exceeded for tier" }[PROCEDURE]Step 1: Extract every duration estimate and identify its basis: historical data,expert judgment, or optimistic assumption. Step 2: Compare each estimate againsthistorical base rates or p90 benchmarks for similar tasks. Step 3: Flag estimatesbelow the historical median as likely optimistic. Step 4: Never accept best-caseestimates as planning targets. Do not anchor to initial optimistic numbers.Step 5: If an estimate lacks historical basis, simulate impact with a 1.5x-2.0xbuffer. If data exists, compute the variance-adjusted range. Verify the finaltimeline accounts for cascading delay propagation across dependent tasks.
[REASONING TOPOLOGY]S1:extract_duration_estimates -> N{accept_best_case_estimates_planning_targets}-> S2:identify_basis(historical|expert|assumption)-> FIXED_POINT[historical_base_rates]-> S3:compare(estimate_vs_p90_benchmark)-> G1{below_median?} --yes-> FLAG:likely_optimistic -> S4:apply_buffer(1.5x_to_2x) -> S3[LOOP] --no-> G2{lacks_historical_basis?} --yes-> S4b:simulate_with_buffer -> S3 --no-> C{adjusted_range = base_rate_estimate +/- sqrt(variance) * z} -> S5:apply_adjusted_range -> S6:verify_cascade_delay -> OUT:realistic_timeline[PROCEDURE]Step 1: Extract every duration estimate in the migration plan (DDL execution timefor adding NOT NULL column on 50M rows, backfill duration, trigger overhead perconcurrent write, total migration window) and identify its basis: historicalmigration data on similar table sizes, DBA expert judgment, or optimisticassumption assuming zero contention. Step 2: Compare each estimate againsthistorical base rates or p90 benchmarks for similar DDL operations on large tables(e.g., ALTER TABLE duration per million rows, trigger-induced latency underconcurrent write load). Step 3: Flag estimates below the historical median aslikely optimistic, e.g., assuming sub-second column addition without consideringlock escalation on a 50M-row table, or assuming trigger-based backfill addsnegligible overhead under concurrent write traffic. Step 4: Never accept best-caseestimates as planning targets. Do not anchor to initial optimistic numbers suchas "the NOT NULL addition will complete instantly" or "the trigger will not slowdown concurrent writes." Step 5: If an estimate lacks historical basis (e.g., noprior trigger-based backfill on a table this size), simulate impact with a1.5x-2.0x buffer for lock duration and write throughput degradation. If dataexists (e.g., past ALTER TABLE timings on this table), compute thevariance-adjusted range. Verify the final timeline accounts for cascading delaypropagation across dependent tasks (e.g., extended lock hold times blockingapplication queries, backfill slowdown under write contention propagating todownstream replication lag).
[REASONING TOPOLOGY]S1:extract_migration_duration_estimates(DDL_time|backfill_time|trigger_overhead|lock_hold_time)-> N{accept_best_case_estimates_planning_targets}-> S2:identify_basis(historical_migration_data|DBA_expert_judgment|optimistic_assumption)-> FIXED_POINT[historical_base_rates_for_DDL_on_large_tables]-> S3:compare(estimate_vs_p90_benchmark_for_ALTER_TABLE_and_trigger_overhead)-> G1{below_median_for_similar_migrations?} --yes-> FLAG:likely_optimistic(e.g.,assumes_zero_lock_contention) -> S4:apply_buffer(1.5x_to_2x_for_lock_duration_and_write_throughput) -> S3[LOOP] --no-> G2{lacks_historical_basis_for_trigger_backfill_on_50M_table?} --yes-> S4b:simulate_with_buffer_for_concurrent_write_impact_and_lock_escalation --no--> C{adjusted_range = base_rate_migration_estimate +/- sqrt(variance) * z} -> S5:apply_adjusted_range_for_migration_window -> S6:verify_cascade_delay(lock_blocking_app_queries -> replication_lag -> downstream_consumers) -> OUT:realistic_migration_timeline[COGNITIVE PAYLOAD]Amplify: hofstadter buffer application; p90 baseline comparison; variance multiplier scalingSuppress: best case anchoring; optimism biasCognitive Style: realistic duration estimationElasticity: coherence=risk adjusted timeline, expansion=conservative
[FALSIFICATION TEST]If time estimates reflect only the best-case scenario without verifying applyingany buffer multiplier, duration calibration has defaulted to optimism.
[NEGATIVE GATE]The database migration will take two weeks: that's our best-case estimate and theteam is experienced, so there's no reason to add buffer. We'll hit the deadlineif everything goes according to plan.
[TARGET PATTERN]Challenge the two-week estimate: what do similar migrations actually take? If pastprojects averaged four weeks at p90, the best-case anchor is dangerously optimistic.Apply a variance multiplier for schema complexity, data volume, and rollbacktesting: build buffer from the full distribution, not the happy path.git clone https://github.com/ejentum/ejentum-mcp.gitcd ejentum-mcpnpm installcp .env.example .env # paste your EJENTUM_API_KEYnpm run devnpm run build && npm run test:smokenpx @modelcontextprotocol/inspector npm run dev