# Agent Swarm

> Agent Swarm is an open-source MCP server for developer tools. Self-hosted platform where a lead agent hands coding tasks to Docker worker agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, Web, API, Slack
- **Website:** https://docs.agent-swarm.dev
- **Repository:** https://github.com/desplega-ai/agent-swarm
- **MCP Registry name:** io.github.desplega-ai/agent-swarm
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-14

## About

Work arrives from Slack, GitHub or GitLab mentions, email, the API or the CLI. A lead agent breaks it down and hands pieces to workers, each running in its own Docker container with a development environment, and the results come back as pull requests or replies. Memory and identity persist across sessions, so agents carry lessons forward.

The docs describe a long feature list around that loop: priority queues with dependencies, scheduled tasks, a DAG workflow engine with human-approval nodes, a dashboard with usage costs, a skill system for reusable procedures, MCP server management with agent, swarm and global scopes, and a Linear integration. Agents can also make USDC micropayments to x402-gated APIs. A scripts-only mode trims the exposed MCP surface to eight script tools.

Workers can run on Claude Code, Codex, pi, opencode, Cursor, Amp, Grok, fx, Devin or ACP agents. The registry entry lists a local server on SQLite at /mcp and a remote at /mcp-user, authenticated with a bearer API key. It is built by Desplega Labs and described as open source.

## Features

- **Lead and worker agents:** A lead plans and delegates; workers run in isolated Docker containers.
- **Many task sources:** Tasks come from Slack, GitHub, GitLab, email, the API or the CLI.
- **Persistent memory:** Agents keep memory and identity across sessions.
- **Workflow engine:** DAG workflows with triggers, conditions and human approval steps.
- **Multiple harnesses:** Workers can use Claude Code, Codex, Cursor, Amp, Devin and others.
- **Dashboard:** Monitors tasks, usage costs and operator configuration.

## Good for

- Run a team of coding agents that ship pull requests from issue mentions
- Schedule recurring engineering chores
- Add human approval steps to agent workflows
- Share reusable skills across a fleet of agents

## Install

### Claude Code (Terminal)

```sh
claude mcp add agent-swarm --env AGENT_SWARM_API_KEY='<AGENT_SWARM_API_KEY>' -- npx -y @desplega.ai/agent-swarm
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "agent-swarm": {
      "command": "npx",
      "args": [
        "-y",
        "@desplega.ai/agent-swarm"
      ],
      "env": {
        "AGENT_SWARM_API_KEY": "<AGENT_SWARM_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "agent-swarm": {
      "command": "npx",
      "args": [
        "-y",
        "@desplega.ai/agent-swarm"
      ],
      "env": {
        "AGENT_SWARM_API_KEY": "<AGENT_SWARM_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "agent-swarm": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@desplega.ai/agent-swarm"
      ],
      "env": {
        "AGENT_SWARM_API_KEY": "<AGENT_SWARM_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "agent-swarm": {
      "command": "npx",
      "args": [
        "-y",
        "@desplega.ai/agent-swarm"
      ],
      "env": {
        "AGENT_SWARM_API_KEY": "<AGENT_SWARM_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "agent-swarm": {
      "command": "npx",
      "args": [
        "-y",
        "@desplega.ai/agent-swarm"
      ],
      "env": {
        "AGENT_SWARM_API_KEY": "<AGENT_SWARM_API_KEY>"
      }
    }
  }
}
```

## FAQ

### How do I deploy it?

The README points to Docker Compose or Kubernetes, with an operator skill installable through npx skills.

### Which agent harnesses can workers use?

Claude Code, Codex, pi, opencode, Cursor, Amp, Grok, fx, Devin or ACP agents.

### How does the MCP server authenticate?

With a bearer token built from your instance API key plus an X-Agent-ID header.

### Is there a hosted version?

The privacy and terms links mention a Cloud service alongside self-hosted software.

### Is Agent Swarm free?

Yes. Agent Swarm is open source, so you can use and self-host it for free.

### How do I add Agent Swarm to Claude Code?

Run this command in your terminal: claude mcp add agent-swarm --env AGENT_SWARM_API_KEY='<AGENT_SWARM_API_KEY>' -- npx -y @desplega.ai/agent-swarm

### What are the best alternatives to Agent Swarm?

The closest alternatives to Agent Swarm are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/agent-swarm
