Agent Swarm
Self-hosted platform where a lead agent hands coding tasks to Docker worker agents
- Pricing
- Open source
- Platforms
- self-hosted, CLI, Web
- Runs
- Remotely
- Version
- 2.10.0
- Listing updated
- 3 days ago
About Agent Swarm
Agent Swarm is an open-source MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.
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.
Install
Run in a terminal
claude mcp add agent-swarm --env AGENT_SWARM_API_KEY='<AGENT_SWARM_API_KEY>' -- npx -y @desplega.ai/agent-swarmAdd to claude_desktop_config.json
{
"mcpServers": {
"agent-swarm": {
"command": "npx",
"args": [
"-y",
"@desplega.ai/agent-swarm"
],
"env": {
"AGENT_SWARM_API_KEY": "<AGENT_SWARM_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"agent-swarm": {
"command": "npx",
"args": [
"-y",
"@desplega.ai/agent-swarm"
],
"env": {
"AGENT_SWARM_API_KEY": "<AGENT_SWARM_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"agent-swarm": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@desplega.ai/agent-swarm"
],
"env": {
"AGENT_SWARM_API_KEY": "<AGENT_SWARM_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"agent-swarm": {
"command": "npx",
"args": [
"-y",
"@desplega.ai/agent-swarm"
],
"env": {
"AGENT_SWARM_API_KEY": "<AGENT_SWARM_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"agent-swarm": {
"command": "npx",
"args": [
"-y",
"@desplega.ai/agent-swarm"
],
"env": {
"AGENT_SWARM_API_KEY": "<AGENT_SWARM_API_KEY>"
}
}
}
}Configuration
AGENT_SWARM_API_KEYAPI key for your local Agent Swarm instance.Required
What it does
- 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
Pricing
Open source
Self-hosted open source; a Cloud service is mentioned, prices not published
Prices change. Check docs.agent-swarm.dev before you buy.
Agent Swarm 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 to Agent Swarm

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity