Skip to content
MCP server

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-swarm

Add 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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity