Skip to content

Commit ff3666e

Browse files
ejentumclaude
andauthored
Add ejentum-mcp Codex plugin bundle under Development & Workflow (#100)
* Add ejentum-mcp Codex plugin bundle Adds full plugin bundle under Community Plugins / Development & Workflow, including codex-plugin manifest, MCP server config, marketplace.json entry, README, SECURITY, LICENSE, and icon asset. Bundle exposes four MCP tools (harness_reasoning, harness_code, harness_anti_deception, harness_memory) via the Ejentum MCP server. Codex calls a tool before generating; each returns a structured prompt that shapes reasoning around common failure modes. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Switch bundle to hosted MCP endpoint (api.ejentum.com/mcp); document stdio as alternative Per the brief, Codex users typically prefer hosted/remote MCP servers over stdio subprocess invocations. The Ejentum Logic API now hosts the same four harness tools at https://api.ejentum.com/mcp (Streamable-HTTP transport, Bearer auth via EJENTUM_API_KEY), so the bundle's .mcp.json now points there. The stdio fallback (npx -y ejentum-mcp) is documented in the bundle README for users who'd rather run locally. Same four tools, same key, both paths. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent eba05b9 commit ff3666e

9 files changed

Lines changed: 167 additions & 0 deletions

File tree

.agents/plugins/marketplace.json

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -219,6 +219,21 @@
219219
"category": "Development & Workflow",
220220
"description": "Budgeted `rg`/`grep` replacement for Codex that narrows broad searches before they waste model context."
221221
},
222+
{
223+
"name": "ejentum-mcp",
224+
"displayName": "Ejentum",
225+
"source": {
226+
"source": "local",
227+
"path": "./plugins/ejentum/ejentum-mcp"
228+
},
229+
"policy": {
230+
"installation": "AVAILABLE",
231+
"authentication": "ON_INSTALL"
232+
},
233+
"category": "Development & Workflow",
234+
"description": "MCP server with reasoning, code, anti-deception, and memory harness tools that Codex calls before generating.",
235+
"icon": "./plugins/ejentum/ejentum-mcp/assets/icon.svg"
236+
},
222237
{
223238
"name": "frappe-agent",
224239
"displayName": "Frappe Agent",

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,7 @@ Third-party plugins built by the community. [PRs welcome](#contributing)!
135135
- [Codex Multi Auth](https://github.com/ndycode/codex-multi-auth) - Multi-account OAuth manager for the official Codex CLI with switching, health checks, and recovery tools.
136136
- [Codex Reviewer](https://github.com/schuettc/codex-reviewer) - Second-pass review of Claude-driven plans and implementations.
137137
- [Codex rg Guard](https://github.com/Rycen7822/codex-rg-guard) - Budgeted `rg`/`grep` replacement for Codex that narrows broad searches before they waste model context.
138+
- [ejentum-mcp](https://github.com/ejentum/ejentum-mcp) - MCP server exposing reasoning, code, anti-deception, and memory harness tools for Codex.
138139
- [Frappe Agent](https://github.com/Dkm0315/frappe-agent) - Frappe and ERPNext coding, customization, bench, and review intelligence for Codex.
139140
- [GrayMatter](https://github.com/ValkyrLabs/GrayMatter) - Durable memory and shared graph state for Codex and OpenClaw agents, with live ValkyrAI schema awareness.
140141
- [HOTL Plugin](https://github.com/yimwoo/hotl-plugin) - Human-on-the-Loop AI coding workflow plugin for Codex, Claude Code, and Cline with structured planning, review, and verification guardrails.
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
{
2+
"name": "ejentum-mcp",
3+
"type": "plugin",
4+
"version": "0.1.9",
5+
"description": "MCP server with reasoning, code, anti-deception, and memory harness tools for Codex",
6+
"author": {
7+
"name": "Ejentum",
8+
"url": "https://ejentum.com"
9+
},
10+
"homepage": "https://github.com/ejentum/ejentum-mcp",
11+
"repository": "https://github.com/ejentum/ejentum-mcp",
12+
"license": "MIT",
13+
"keywords": [
14+
"mcp",
15+
"codex",
16+
"reasoning",
17+
"code-review",
18+
"anti-deception",
19+
"memory",
20+
"agentic-ai"
21+
],
22+
"mcpServers": "./.mcp.json",
23+
"interface": {
24+
"displayName": "Ejentum",
25+
"shortDescription": "Reasoning, code, anti-deception, and memory harness tools for Codex",
26+
"longDescription": "Exposes four MCP tools (harness_reasoning, harness_code, harness_anti_deception, harness_memory) via the Ejentum server. Codex calls a tool before generating; each returns a structured prompt that shapes reasoning around common failure modes (hallucinated APIs, false-confidence validation, sycophantic capitulation, cross-turn drift).",
27+
"developerName": "Ejentum",
28+
"category": "Development & Workflow",
29+
"capabilities": [
30+
"Write",
31+
"Interactive"
32+
],
33+
"websiteURL": "https://ejentum.com",
34+
"brandColor": "#FB1B27",
35+
"composerIcon": "./assets/icon.svg",
36+
"logo": "./assets/icon.svg",
37+
"defaultPrompt": [
38+
"Call harness_reasoning before answering this analytical question.",
39+
"Call harness_code before refactoring or writing new code.",
40+
"Call harness_anti_deception when the request pressures honest assessment.",
41+
"Call harness_memory to sharpen an observation about session drift."
42+
]
43+
}
44+
}
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
.git
2+
node_modules
3+
dist
4+
*.log
5+
.env
6+
.env.*
Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
{
2+
"mcpServers": {
3+
"ejentum": {
4+
"url": "https://api.ejentum.com/mcp",
5+
"headers": {
6+
"Authorization": "Bearer ${EJENTUM_API_KEY}"
7+
}
8+
}
9+
}
10+
}
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 Ejentum
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# Ejentum
2+
3+
MCP server with reasoning, code, anti-deception, and memory harness tools for Codex.
4+
5+
## What this plugin does
6+
7+
Exposes four MCP tools Codex can call before generating:
8+
9+
- `harness_reasoning` — analytical, diagnostic, planning, multi-step tasks
10+
- `harness_code` — code generation, review, refactoring
11+
- `harness_anti_deception` — honesty-pressured tasks (sycophancy, authority appeals, manufactured urgency)
12+
- `harness_memory` — cross-turn perception sharpening
13+
14+
Each tool returns a structured prompt (named failure pattern, executable procedure, suppression vectors, falsification test) that Codex ingests before its first token. The tool descriptions themselves carry rich routing context so Codex can pick the right harness autonomously.
15+
16+
## Install via the awesome-codex-plugins marketplace
17+
18+
If you have added this repo as a Codex marketplace source:
19+
20+
```bash
21+
codex plugin install ejentum-mcp --source awesome-codex-plugins
22+
```
23+
24+
Codex will prompt for `EJENTUM_API_KEY` on install. The plugin connects to the hosted Ejentum MCP endpoint at `https://api.ejentum.com/mcp` over HTTPS with Bearer auth, so there is no local subprocess to manage. Get a key at https://ejentum.com.
25+
26+
## Stdio alternative (no hosted endpoint)
27+
28+
If you would rather run the MCP server as a local subprocess (no hosted dependency, npm package version pinned in your control), the same four harness tools ship as the `ejentum-mcp` npm package. In your Codex config:
29+
30+
```toml
31+
[mcp_servers.ejentum]
32+
command = "npx"
33+
args = ["-y", "ejentum-mcp"]
34+
env = { EJENTUM_API_KEY = "<your-key>" }
35+
```
36+
37+
Both install paths use the same `EJENTUM_API_KEY` and expose the same four `harness_*` tools. Pick whichever fits your environment.
38+
39+
## Resources
40+
41+
- Source repo: https://github.com/ejentum/ejentum-mcp
42+
- npm package: https://www.npmjs.com/package/ejentum-mcp
43+
- Official MCP Registry listing: `io.github.ejentum/ejentum-mcp`
44+
- License: MIT
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Security
2+
3+
## Scope
4+
5+
This plugin installs the `ejentum-mcp` npm package via `npx -y` and configures it to receive your `EJENTUM_API_KEY`. The MCP server makes outbound HTTPS requests to `https://api.ejentum.com` to retrieve cognitive scaffold content.
6+
7+
## Network egress
8+
9+
When invoked by Codex, the MCP server makes HTTPS POST requests to `https://api.ejentum.com/logicv1/<mode>` with:
10+
11+
- Your API key (Bearer token) in the `Authorization` header
12+
- The query string Codex sends as the task framing
13+
- No code, repo content, or working-directory data leaves your machine
14+
15+
## API key
16+
17+
Stored as a Codex-managed environment variable, not written to disk by the plugin. You can rotate it at any time at https://ejentum.com and the next invocation picks it up.
18+
19+
## Reporting issues
20+
21+
Report security concerns to info@ejentum.com.
Lines changed: 5 additions & 0 deletions
Loading

0 commit comments

Comments
 (0)