Skip to main content
The Replicas MCP server lets AI assistants spawn, interact with, and destroy replicas (sandboxed coding agents) to complete engineering tasks. Two transport options are available:
TransportUse Case
StdioMCP clients that can run local processes (Claude Desktop, Claude Code)
Streamable HTTPMCP clients that require a remote server URL

​
Stdio MCP

For MCP clients that can run local processes (e.g., Claude Desktop, Claude Code): 
{
  "mcpServers": {
    "replicas": {
      "command": "npx",
      "args": ["-y", "replicas-mcp"],
      "env": {
        "REPLICAS_API_KEY": "sk_replicas_..."
      }
    }
  }
}

​
Streamable HTTP MCP

For MCP clients that require a remote server URL: 
URL: https://api.replicas.dev/v1/mcp
Authorization: Bearer sk_replicas_...
Get your API key from Settings

​
Tools

ToolDescription
create_replicaCreate a workspace and send an initial message
list_replicasList all replicas with status, repository, and associated PRs
get_replicaGet replica details including coding agent, branch, and git diff
send_replica_messageSend a message to a replica
delete_replicaDelete a replica
list_repositoriesList available repositories
read_replica_historyRead conversation history from a replica (paginated)

​
Prerequisites

Same as the Public API.