---
title: "List MCP servers"
method: GET
path: "/api/v1/mcp-servers"
tags: ["MCP Servers"]
---

# List MCP servers

`GET /api/v1/mcp-servers`

Returns all server-managed MCP server definitions with transport env/header values omitted.

## Response `200`

MCP server definitions

- McpServerListResponse — List envelope for MCP server definitions.
  - `data` McpServer[], required
    - `id` string, required — Stable MCP server identifier, used as the runtime MCP server name in qualified tool names.
    - `revision` string, required — Stable revision used with `If-Match` for optimistic concurrency.
    - `display_name` string, required — Human-readable label for display in management UIs.
    - `description` string, nullable, required
    - `transport` union, required — MCP server transport configuration returned by catalog read APIs.
      - McpTransportViewStdio — Stdio transport view. Environment variable values are omitted.
        - `type` 'stdio', required
        - `command` string[], required — Command and arguments used to launch the MCP server.
        - `env_keys` string[], required — Environment variable names configured for this transport.
      - McpTransportViewHttp — HTTP transport view. Header values are omitted.
        - `type` 'http', required
        - `protocol` 'streamable_http' | 'sse' — Wire protocol used by HTTP and sandbox MCP transports.
        - `url` string, uri, required
        - `header_keys` string[], required — HTTP header names configured for this transport.
      - McpTransportViewSandbox — Sandbox transport view. Environment variable values are omitted.
        - `type` 'sandbox', required
        - `protocol` 'streamable_http' | 'sse' — Wire protocol used by HTTP and sandbox MCP transports.
        - `command` string[], required — Command and arguments used to launch the in-sandbox MCP server.
        - `port` integer, required
        - `env_keys` string[], required — Environment variable names configured for this transport.
    - `startup_timeout_secs` integer, required — Seconds to wait for the MCP server to become ready at connect time.
    - `tool_timeout_secs` integer, required — Seconds to allow each MCP tool call before timing out.
  - `meta` McpServerListMeta, required — Metadata for MCP server list responses.
    - `total` integer, required — Total number of server-managed MCP server definitions.

## Other responses

- `500` — MCP server store operation failed

---

[API](https://skmtc.net/fabro-sh/apis/fabro-run-api.md) · [All operations](https://skmtc.net/fabro-sh/apis/fabro-run-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fabro-sh/fabro-run-api/revisions/52f1d8aaf083/schema)