> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryreplicas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Use Replicas from Claude Desktop, Poke, and other MCP clients.

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):

```json theme={null}
{
  "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](https://tryreplicas.com/dashboard/settings?tab=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](/features/api) 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](/features/api#prerequisites).