---
title: "List environment MCPs"
method: GET
path: "/v1/environments/{environment_id}/mcps"
tags: ["Environment MCPs"]
---

# List environment MCPs

`GET /v1/environments/{environment_id}/mcps`

## Request

- Base URL: `https://api.replicas.dev`
- URL: `https://api.replicas.dev/v1/environments/{environment_id}/mcps`
- Auth: HTTP bearer

## Path parameters

- `environment_id` string, required

## Headers

- `X-Replicas-Api-Version` '2026-10-07'

## Response `200`

Successful response

- ListEnvironmentMcpsResponse
  - `environment_mcps` EnvironmentMcp[], required
    - `id` string, uuid, required
    - `organization_id` string, uuid, required
    - `environment_id` string, uuid, required
    - `name` string, required: MCP name (1–64 chars, must match `^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$`; cannot start with reserved prefixes `relay-`, `replicas-`, or `subagents`)
    - `transport` 'stdio' | 'http' | 'sse', required
    - `config` union, required: MCP transport-specific configuration. Discriminate by the parent `transport` field.
      - EnvironmentMcpStdioConfig: Configuration for an MCP that runs a local subprocess (`transport: stdio`).
        - `command` string, required: Executable to run (e.g. `npx`)
        - `args` string[], required: Arguments passed to the command
        - `env` object, required: Environment variables for the subprocess
      - EnvironmentMcpHttpConfig: Configuration for an MCP reached over HTTP or SSE (`transport: http` or `transport: sse`).
        - `auth` union: Authenticate using a short-lived workspace identity token minted for the given audience, or an OAuth account connected in the app.
          - object
            - `type` 'workspace_identity', required
            - `audience` string, required: Audience (`aud`) the MCP server verifies, usually its URL.
          - object
            - `type` 'oauth', required
        - `url` string, uri, required: MCP server URL
        - `headers` object, required: Headers attached to every request (e.g. `Authorization`)
    - `oauth` object: Connection state for MCPs using OAuth. Returned when listing MCPs.
      - `status` 'disconnected' | 'connected' | 'reconnect_required', required
      - `reason` string, nullable, required: Why a reconnect is required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400`: Bad request - Missing or invalid parameters
- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal server error

---

[API](https://skmtc.dev/replicas/apis/replicas-api.md) - [All operations](https://skmtc.dev/replicas/apis/replicas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/replicas/apis/replicas-api/revisions/2703ac1c9cb7?raw)