MCP

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:

Transport	Use Case
Stdio	MCP clients that can run local processes (Claude Desktop, Claude Code)
Streamable HTTP	MCP 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 Organization → Settings → API Keys

Tools

Tool	Description
`create_replica`	Create a workspace for an `environment_id` and send an initial message. Supports `coding_agent` (`claude`, `codex`, `cursor`, `opencode`, `pi`), `model`, `lifecycle_policy`, `plan_mode`, `goal_mode`, `fast_mode`, and `thinking_level` (low, medium, high, xhigh, max, ultra, ultracode).
`list_replicas`	List all replicas with optional filters (`user_id`, `source`, `status`)
`get_replica`	Get replica details with optional `include` param (`environment`, `diffs`) for rich workspace state
`send_replica_message`	Send a message to a replica. Supports `chat_id`, `coding_agent` (`claude`, `codex`, `cursor`, `opencode`, `pi`), `model`, `plan_mode`, `goal_mode`, `fast_mode`, and `thinking_level` (low, medium, high, xhigh, max, ultra, ultracode).
`delete_replica`	Delete a replica
`list_repositories`	List available repositories
`list_repository_sets`	List available repository sets (named groups of repositories)
`list_chats`	List chats in a replica workspace
`create_chat`	Create a new chat in a replica workspace
`delete_chat`	Delete a chat from a replica workspace
`read_replica_history`	Read conversation history from a replica, optionally for a specific `chat_id`
`get_replica_hooks`	Get warm and start hook logs for a replica

See the API reference for full parameter details. Use ultra with Codex for proactive multi-agent reasoning, or ultracode with Claude Code for xhigh reasoning plus automatic dynamic workflows.

Prerequisites

Same as the Public API.

Getting Started

Features

Admin

Updates

Stdio MCP

Streamable HTTP MCP

Tools

Prerequisites

​Stdio MCP

​Streamable HTTP MCP

​Tools

​Prerequisites

Stdio MCP

Streamable HTTP MCP

Tools

Prerequisites