> ## 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. # Create Environment MCP > Adds a new MCP server to the environment. `name` must match `^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$` and cannot start with reserved prefix `replicas-`. The `config` shape depends on the `transport`: stdio uses `{ command, args, env }`; http and sse use `{ url, headers }`. ## OpenAPI ````yaml /openapi.json post /v1/environments/{environmentId}/mcps openapi: 3.1.0 info: title: Replica API version: 2.0.0 description: >- The Replica API allows you to programmatically manage cloud workspaces for AI agents. Use this API to manage environments (the org-scoped primitive workspaces are created from — including variables, files, skills, MCPs, warm hooks, start hooks, and warm pools), create and manage replicas, send messages, manage chats, stream events, read connected repositories and repository sets, and configure automations. servers: - url: https://api.tryreplicas.com description: Production API security: - apiKey: [] tags: - name: Environments description: >- Manage environments — the primitive that workspaces are created from. Variables, files, skills, MCPs, warm-hooks, and warm-pools are all scoped to an environment. Every organization has a singleton Global environment whose values apply to every workspace. Personal environments are scoped to the authenticated user and can be standalone or source-backed by a team environment. - name: Repository description: >- Read repositories and repository sets connected to your organization. Repositories are the underlying GitHub-connection layer; bind them to an environment to use them in workspaces. - name: Replica description: >- Manage replicas (workspaces) for AI agents. `/v1/replica` endpoints accept API keys and workspace engine-secret authentication; user-session JWTs are not accepted. - name: Terminal description: Manage interactive terminal sessions in active workspaces - name: Preview description: Manage public preview URLs for workspace ports - name: Profile description: Read and update the authenticated user's profile - name: Credentials description: >- Manage coding-agent credentials for an organization or the authenticated user - name: Google Search Console description: >- Read Search Console properties, performance, sitemaps, and URL inspection results through a connected Google account - name: Slack description: Connect Slack identities and route threads to Replicas workspaces - name: Linear description: Connect Linear identities to Replicas accounts - name: Automation description: >- Create and manage automations that trigger replicas on a schedule or in response to events - name: Downloads description: Download Replicas applications - name: Media description: >- Read workspace media and obtain short-lived download or inline preview URLs - name: Analytics description: >- Read aggregated activity and usage metrics for your organization: compute minutes, workspaces created by source, and pull request throughput over a time range. - name: Presence description: >- Read and report ephemeral member presence: who is online, where they are (environment or workspace), and whether they are typing. Presence is backed by short-lived keys rather than the database and broadcast to other members over the events stream. paths: /v1/environments/{environmentId}/mcps: post: tags: - Environments summary: Create Environment MCP description: >- Adds a new MCP server to the environment. `name` must match `^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$` and cannot start with reserved prefix `replicas-`. The `config` shape depends on the `transport`: stdio uses `{ command, args, env }`; http and sse use `{ url, headers }`. operationId: createEnvironmentMcp parameters: - name: environmentId in: path required: true description: Environment UUID, or the literal string `global`. schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateEnvironmentMcpRequest' responses: '201': description: MCP created content: application/json: schema: $ref: '#/components/schemas/EnvironmentMcpResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '409': $ref: '#/components/responses/Conflict' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CreateEnvironmentMcpRequest: type: object description: >- Request body for creating an MCP. The `config` shape must match the chosen `transport`. properties: name: type: string description: >- 1–64 chars, `^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$`; reserved prefix `replicas-` is rejected. transport: type: string enum: - stdio - http - sse config: $ref: '#/components/schemas/EnvironmentMcpConfig' required: - name - transport - config EnvironmentMcpResponse: type: object properties: environment_mcp: $ref: '#/components/schemas/EnvironmentMcp' required: - environment_mcp EnvironmentMcpConfig: description: >- MCP transport-specific configuration. Discriminate by the parent `transport` field. oneOf: - $ref: '#/components/schemas/EnvironmentMcpStdioConfig' - $ref: '#/components/schemas/EnvironmentMcpHttpConfig' EnvironmentMcp: type: object description: An MCP (Model Context Protocol) server attached to an environment. properties: id: type: string format: uuid organization_id: type: string format: uuid environment_id: type: string format: uuid name: type: string description: >- MCP name (1–64 chars, must match `^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$`; cannot start with reserved prefix `replicas-`) transport: type: string enum: - stdio - http - sse config: $ref: '#/components/schemas/EnvironmentMcpConfig' created_at: type: string format: date-time updated_at: type: string format: date-time required: - id - organization_id - environment_id - name - transport - config - created_at - updated_at Error: type: object properties: error: type: string description: Error message details: type: - string - 'null' description: Additional error details required: - error EnvironmentMcpStdioConfig: type: object description: >- Configuration for an MCP that runs a local subprocess (`transport: stdio`). properties: command: type: string description: Executable to run (e.g. `npx`) args: type: array items: type: string description: Arguments passed to the command env: type: object additionalProperties: type: string description: Environment variables for the subprocess required: - command - args - env EnvironmentMcpHttpConfig: type: object description: >- Configuration for an MCP reached over HTTP or SSE (`transport: http` or `transport: sse`). properties: url: type: string format: uri description: MCP server URL headers: type: object additionalProperties: type: string description: Headers attached to every request (e.g. `Authorization`) required: - url - headers responses: BadRequest: description: Bad request - Missing or invalid parameters content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/Error' Conflict: description: >- Conflict - Resource already exists or operation conflicts with current state content: application/json: schema: $ref: '#/components/schemas/Error' InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: apiKey: type: http scheme: bearer description: >- API key authentication. Obtain your API key from the Replicas dashboard under Organization → Settings → API Keys. User-session JWTs are not accepted by `/v1/replica` endpoints. ````