SuperAgent is a Model Context Protocol (MCP) server that bridges MCP-compatible clients with the Codex and Gemini CLI agents. It lets you fan out multiple CLI tasks in parallel, reuse curated system prompts, and surface results back to your client in a single, structured response.

• Unified agent runner: expose the Codex and Gemini CLIs as MCP tools without additional wrappers.
• Parallel execution: run multiple prompts concurrently with per-task timeouts and basic result formatting.
• Agent library sync: ship ready-made system prompts that install into ~/.superagent/agents and can be extended locally.
• Tool discovery: query the bundled list-agents tool to see which specialized agents are available at runtime.

npm install @superclaude-org/superagent

The postinstall script seeds any missing agent definition files under ~/.superagent/agents so they are immediately

Once connected, the client will discover these tools:

{
  "tool": "codex",
  "arguments": {
    "concurrency": 2,
    "inputs": [
      { "prompt": "Run unit tests", "workingDirectory": "/path/to/app" },
      { "prompt": "Summarize latest git changes", "agent": "technical-writer" }
    ]
  }
}

• Agent definitions are Markdown files with frontmatter. You can edit or add new files in ~/.superagent/agents.
• The list-agents tool shows each agent’s name and description so you can supply the agent field when invoking codex or gemini.
• Files shipped with the package are copied only if they do not already exist, preserving local customizations.

npm install
npm run build
npm start   # runs the compiled server
npm run dev # runs the TypeScript entrypoint with ts-node

Requires Node.js 18 or newer.