Superagent MCP

🚀 SuperAgent MCP

SuperAgent is a Model Context Protocol (MCP) server that connects MCP-compatible clients with the Codex, Gemini, and Continue CLI agents. It enables parallel execution of multiple CLI tasks, reuse of curated system prompts, and returns results to your client in a single, structured response.

🚀 Quick Start

SuperAgent allows you to interact with Codex, Gemini, and Continue CLI agents through a unified interface. It simplifies the process of running multiple tasks in parallel and managing system prompts.

✨ Features

• Unified agent runner: Expose the Codex, Gemini, and Continue 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.

📦 Installation

npm install @superclaude-org/superagent

The post - install script seeds any missing agent definition files under ~/.superagent/agents so they are immediately available.

Once connected, the client will discover these tools:

💻 Usage Examples

Basic Usage

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

📚 Documentation

Agent Management

• 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, gemini, or continue.
• Files shipped with the package are copied only if they do not already exist, preserving local customizations.

Continue Configuration

To use the continue tool, set the CONTINUE_CONFIG_PATH environment variable to point to your Continue config file:

export CONTINUE_CONFIG_PATH="/path/to/.continue/config.yaml"

This can be set in your MCP client configuration's env section.

Development

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.