Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.replicas.dev/llms.txt

Use this file to discover all available pages before exploring further.

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.tryreplicas.com/v1/mcp
Authorization: Bearer sk_replicas_...
Get your API key from Settings

​
Tools

ToolDescription
create_replicaCreate a workspace for an environment_id and send an initial message. Supports model, lifecycle_policy, and thinking_level (low, medium, high, max).
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, plan_mode, and thinking_level (low, medium, high, max).
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.