Skip to main content
POST
/
v1
/
environments
/
{environmentId}
/
mcps
Create Environment MCP
curl --request POST \
  --url https://api.tryreplicas.com/v1/environments/{environmentId}/mcps \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "config": {
    "command": "<string>",
    "args": [
      "<string>"
    ],
    "env": {}
  }
}
'
{
  "environment_mcp": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "config": {
      "command": "<string>",
      "args": [
        "<string>"
      ],
      "env": {}
    },
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Obtain your API key from the Replicas dashboard under Settings > API Keys.

Path Parameters

​
environmentId
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 prefix replicas- is 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.