open-index/open-npm huggingface dataset:
npm package: @fastmcp-me/superagent-mcp
Description: SuperAgent MCP server for orchestrating Codex agent calls with concurrency
Latest version: 0.1.6

[![Add to Cursor](https://fastmcp.me/badges/cursor_dark.svg)](https://fastmcp.me/MCP/Details/1277/superagent)
[![Add to VS Code](https://fastmcp.me/badges/vscode_dark.svg)](https://fastmcp.me/MCP/Details/1277/superagent)
[![Add to Claude](https://fastmcp.me/badges/claude_dark.svg)](https://fastmcp.me/MCP/Details/1277/superagent)
[![Add to ChatGPT](https://fastmcp.me/badges/chatgpt_dark.svg)](https://fastmcp.me/MCP/Details/1277/superagent)
[![Add to Codex](https://fastmcp.me/badges/codex_dark.svg)](https://fastmcp.me/MCP/Details/1277/superagent)
[![Add to Gemini](https://fastmcp.me/badges/gemini_dark.svg)](https://fastmcp.me/MCP/Details/1277/superagent)

# SuperAgent MCP

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.

## Key Features
- **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.

## Installation

```bash
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 | Purpose | Notable arguments |
| --- | --- | --- |
| `codex` | Run one or many Codex CLI tasks in parallel. | `inputs[]` (prompt list), `concurrency`, `workingDirectory`, `agent`, `extraArgs`, `timeoutMs` |
| `gemini` | Run Gemini CLI tasks with auto-approval enabled. | `inputs[]`, `concurrency`, `workingDirectory`, `agent`, `timeoutMs` |
| `list-agents` | List the specialized agents available to both tools. | *(none)* |

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

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

## Development

```bash
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.