Connects multiple AI agents so one can hand tasks to another and receive the results back within your existing chat interface.
Also known as cherninlab/ennodia
- Stars
- 6
- Tools
- 8
- Downloads, 30 days
- —
- Latest version
- 0.5.5
- Last commit
- Nov 13, 2026
- License
- MIT
What is Ennodia MCP?
Ennodia connects multiple AI agents so one can hand tasks to another and receive the results back within your existing chat interface. It exposes 8 tools, such as ennodia_list_harnesses, ennodia_setup, ennodia_check_harnesses.
Summary generated from the project's README
About Ennodia MCP server
Connecting different AI agents so they can collaborate on complex tasks is what Ennodia enables. Instead of replacing your preferred interface, it allows agents like Claude Code, Codex, or Cline to hand off specific parts of a job to another model and receive the results directly within your existing chat. This setup runs locally on your computer using Bun, meaning it utilizes your own existing accounts and provider plans rather than requiring new subscriptions.
Developers use the ennodia_run tool to delegate specialized abilities to other models. For example, you can have Gemini process audio files or use Kimi K3 via OpenCode to read long documents. The system manages these handoffs by starting the target agent in a fresh session, then returning the answer along with a local receipt detailing who performed the work and how long it took. This approach allows your primary agent to gain new skills, such as drawing with GPT Image or performing multi-agent reviews, without changing your workflow.
What you can do with it
- 1Process audio files with GeminiAsk your primary agent to have Gemini listen to an audio file and summarize the decisions made.
- 2Generate images via CodexInstruct your agent to use GPT Image to create visual assets from a text brief.
- 3Analyze long technical documentsHand a large specification to Kimi K3 to extract specific rules and line numbers.
- 4Perform multi-agent code reviewsHave two different agents review the same code patch to compare their findings.
Written from the project's README. Every use case is checked against a quote from it.
How to install Ennodia MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Ennodia MCP in Claude Code
$ claude mcp add ennodia -- npx -y ennodiaInstall Ennodia MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ennodia": {
"command": "npx",
"args": [
"-y",
"ennodia"
]
}
}
}Install Ennodia MCP in VS Code
.vscode/mcp.json
{
"servers": {
"ennodia": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ennodia"
]
}
}
}Install Ennodia MCP in VS Code CLI
$ code --add-mcp '{"name":"ennodia","type":"stdio","command":"npx","args":["-y","ennodia"]}'Install Ennodia MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"ennodia": {
"command": "npx",
"args": [
"-y",
"ennodia"
]
}
}
}Install Ennodia MCP in Codex
$ codex mcp add ennodia -- npx -y ennodiaInstall Ennodia MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.ennodia] command = "npx" args = ["-y", "ennodia"]
Install Ennodia MCP in Gemini CLI
$ gemini mcp add -s user ennodia npx -- -y ennodiaInstall Ennodia MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ennodia": {
"command": "npx",
"args": [
"-y",
"ennodia"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for ennodia 0.5.5 in an isolated container with no network and no keys. It answered and listed 8 tools.
Ennodia MCP tools 8
Read from the server with tools/listennodia_list_harnessesRead-onlyDiscover supported agents and cached readiness for routing. Do not summarize it for the user; for setup or status requests call ennodia_setup. Read inputGuidance before media work.
ennodia_setupRead-onlyShow the user Ennodia's agents: each agent's status and the exact fix for blocked ones. Refreshes native sign-in status without model requests. Hosts that render MCP Apps show a card with check buttons; others get a Markdown panel to show the user.
ennodia_check_harnessesActionRecheck selected harnesses and return compact diagnostics. Target affected harnessIds; unrelated blockers do not prevent work. verify makes an optional real model call; a timeout leaves access unverified and does not block tasks. upgrade runs supported updaters before rechecking. Never switch account/provider/model silently. Show a brief changed result; use ennodia_setup only when the user asks for the full setup view.
ennodia_list_skillsRead-onlyDiscover prompt-only skills from project, user, and built-in skill directories without returning full instruction text.
ennodia_runActionStart a high-level Ennodia orchestration. Set pragmatic for evidence-focused investigation or patch proposals with one or more independent workers. Use Plan Advisor for tailored model and skill assignments. Use this as the default entrypoint: it plans routing, starts one or more local harness tasks, optionally compares successful outputs, and returns a run ID. Runs usually take minutes; use ennodia_get_run with waitMs: 30000 and includeEvents: false until terminal, then consume and verify its answer. A wait timeout does not cancel or finish the run.
ennodia_historyRead-onlyRead terminal run receipts persisted under the local Ennodia history directory. Use after a restart to inspect previous final answers and Judge disagreement analysis.
ennodia_get_runRead-onlyInspect a run or wait up to waitMs for completion, including task-specific keepInMind notes when Compare returns them. Prefer waitMs: 30000, compact: true and includeEvents: false while awaiting results. A nonterminal response means work continues; do not claim its findings were consumed.
ennodia_cancel_runActionCancel a high-level run and any active child task, Judge, or Result Advisor.
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablecherninlab/ennodia is public and reachablegithub.com/cherninlab/ennodia ↗Pass
- Package names this repository as its sourceennodia names cherninlab/ennodia as sourcenpmjs.com/package/ennodia ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for ennodianpmjs.com/package/ennodia/v/0.5.3#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/cherninlab/ennodia ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from ennodiaPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubEnnodia isn't another agent. It connects the agents you use.
Stay in Codex, Claude Code, or any agent you like. When a task needs another model, your agent hands that part over through Ennodia and brings the answer back. Ennodia runs on your computer, and each agent uses your own account.
Have Gemini listen to meeting.mp3 through Ennodia and tell me what was decided.
Why use it
- Keep the app you like. Ennodia has no window of its own. You work in your agent as before, and it can now reach the others.
- Your agents work together. Any agent can hand part of a task to any other and get the answer back in your chat.
- Nothing to pay, nothing to join. Ennodia is free and open source, with no account. It uses the agents and plans you have.
- It grows with your agents. It is a set of tools, not a framework or a method. Each new model one agent gains becomes an ability for all of them.
- It stays on your computer. Every handoff leaves a receipt there: who did the work, how long it took, and what came back.
- Less to keep up with. You don't need to follow every new model. Name the task, and your agent hands it to one that can do it.
Next on the roadmap: Ennodia reads its receipts, so your agent stops repeating what failed.
What each agent adds
No model leads every task, so each agent you connect brings an ability the others lack.
- Listen. Gemini hears audio files. Codex hands it the file path and gets back what Gemini heard.
- Draw. Codex draws with GPT Image. Claude Code can hand it a brief and get the images back.
- Review. Two other agents review the same patch in fresh sessions. Compare maps where they agree and differ.
- Read. Kimi K3 in OpenCode reads long documents. Your agent hands it a spec and gets back the rules, each with its line number.
When your own agent has the ability, it does the task itself, with no handoff. See each route and the public scores behind each strength.
Install
Send this address to your agent:
try-ennodia.cherninlab.com
For manual setup, add this Model Context Protocol (MCP) server to your client:
{
"mcpServers": {
"ennodia": {
"command": "npx",
"args": ["-y", "ennodia"]
}
}
}
Ennodia loads eight core tools by default: about 13,000 characters of tool definitions in each session.
Add "--tools", "all" to args for the full tool set.
Requirements: Bun 1.3.14 or newer, a compatible MCP client, and a supported agent with working provider access.
npx downloads Ennodia. Bun runs it. You can also use bunx ennodia.
Get your first result · Installation for agents
How a handoff works
- Your agent calls
ennodia_runwith the task, the agent or model to use, and a time limit. - Ennodia checks the selected route, then starts that agent's own command-line tool in a fresh session, with its own tools and your account for it.
- The answer comes back to your conversation, with its status and a receipt saved on your computer.
Your conversation history stays in your agent.
For two or more answers, Compare maps agreements, contradictions, and gaps.
When one answer is complete as it stands, Compare can choose it, and ennodia_run returns it unchanged.
Include relevant constraints and prior decisions in your task prompt under Keep in mind. Ennodia asks workers and Compare to return useful reminders with reasons and evidence. Your agent verifies them before carrying them into the next task. See how to read these notes.
Supported agents
Codex CLI, Claude Code, OpenCode, Kilo Code, Kiro CLI, Cline, Hermes Agent, and Antigravity. Model availability and tool permissions depend on the installed agent and its provider configuration. Discovery reports native login checks and confirmed recovery actions. The requested task verifies model access without a separate model call first. Codex workers use a read-only sandbox by default.
Ennodia discovers native Agent Skills and can request them for specific tasks. A separate task keeps the trial outside the main conversation. Native agents can also select unrequested skills from their own environment.
Recipes · Using skills · Understand results
Evidence
- Can Gemini hear this file?: a Codex conversation hands an audio file to Gemini through Antigravity.
- Measurement plan: how Ennodia compares single agents with teams on public benchmarks.
- Audio routing pilot: Codex got 10 of 10 speech questions right through Gemini, and 4 of 10 alone. Across all 30 clips the gain was not significant, and each answer took about twice as long.
Data and limits
Ennodia runs locally without an Ennodia-hosted service.
Selected agents can send material to their configured model providers.
Terminal run history is stored locally and can be disabled with ENNODIA_HISTORY=0.
Each handoff costs time and uses your agents' own quotas and charges. General time or token savings have not been established. Ennodia can limit child tasks and estimated input tokens. Those estimates exclude internal harness work and are not provider bills.
Data governance · Budgets · Roadmap
Technical reference and contribution
The main entry point is ennodia_run.
The full tool set adds raw tasks, separate Compare calls, budget estimates, and the Plan Advisor, which proposes explicit tasks before execution.
MCP tools · Experimental Ennodia IO · Contributing · MIT license
bun install
bun run verify
Experimental Pragmatic mode
Pragmatic mode runs independent model attempts, tailored plans, and skill trials, then compares the evidence. It keeps bulky evidence outside the main conversation and returns findings for your agent to verify. Savings are not yet validated.
Login recovery and updates
Ennodia checks selected workers, Judge, and Advisor routes before execution. Blocked routes return a native recovery action before reviewers start. Ennodia says nothing about its own status unless an agent you asked for is blocked. Rechecks and blocked starts return compact diagnostics. The full setup panel appears only for an explicit setup request.
Your agent calls ennodia_setup to show each agent's status and fix in your current session.
Hosts that render MCP Apps, such as Claude Desktop and Visual Studio Code, can show it as a card with check buttons.
Other hosts, such as Codex and Claude Code, show the Markdown panel.
Run that action in an interactive terminal, then call ennodia_check_harnesses with the same harness and model and refresh: true, verify: true.
Run receipts keep missing reviewer coverage visible, including in compact responses.
Supported harness upgrades run once per day on use while Ennodia has no active tasks.
Set ENNODIA_AUTO_UPDATE=false to disable them.
Use ennodia_check_harnesses with upgrade: true to update and recheck immediately.
Ennodia also checks its own installation automatically. Run results report the loaded code location, version, runtime, and installation scope. The report checks required files, bundled skills, and storage access. The recheck tool refreshes this report. MCP startup instructions carry only installation problems.
Mention installation limitations when they affect the request. Cache installs can change on a future unpinned launch. These local checks do not verify the latest registry version or provider access. See recovery and updates.
Ennodia MCP questions
How do I add Ennodia MCP to Claude Code?
Run claude mcp add ennodia -- npx -y ennodia in your terminal. Add --scope user to make it available in every project.
How do I add Ennodia MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Ennodia MCP provide?
It exposes 8 tools, including ennodia_list_harnesses, ennodia_setup, ennodia_check_harnesses, ennodia_list_skills, ennodia_run.
Does Ennodia require a separate account?
No, Ennodia is free, open source, and requires no account; it uses the existing accounts and plans you already have for your agents.