Skip to main content
POST
Create environment MCP

Authorizations

Authorization
string
header
required

Organization or personal API key from Settings → API Keys.

Headers

X-Replicas-Api-Version
enum<string>

API version. 2026-10-07 returns snake_case responses. See versioning.

Available options:
2026-10-07

Path Parameters

environment_id
string
required

Environment UUID, or the literal string global.

Body

application/json

Request body for creating an MCP. The config shape must match the chosen transport.

name
string
required

1–64 chars, ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$; reserved prefixes relay-, replicas-, and subagents are rejected.

transport
enum<string>
required
Available options:
stdio,
http,
sse
config
object
required

MCP transport-specific configuration. Discriminate by the parent transport field.

Response

MCP created

environment_mcp
object
required

An MCP (Model Context Protocol) server attached to an environment.