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. Supports model, lifecycle_policy, and repository_set_id.
list_replicasList all replicas with optional filters (user_id, source, status)
get_replicaGet replica details with optional include param (environment, diffs) for rich workspace state
send_replica_messageSend a message to a replica. Supports chat_id, model, and plan_mode.
delete_replicaDelete a replica
list_repositoriesList available repositories
list_repository_setsList available repository sets (named groups of repositories)
list_chatsList chats in a replica workspace
create_chatCreate a new chat in a replica workspace
delete_chatDelete a chat from a replica workspace
read_replica_historyRead conversation history from a replica, optionally for a specific chat_id
get_replica_hooksGet warm and start hook logs for a replica
See the API reference for full parameter details.

​
Prerequisites

Same as the Public API.