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

# List MCP Servers

`GET /mcp-servers`

Retrieves all MCP servers configured for the current user.

## Response `200`

Response for status 200

- object[]
  - `id` string, required — Unique identifier for the MCP server.
  - `name` string, required — Display name of the MCP server.
  - `url` string, required — URL endpoint of the MCP server.
  - `description` string, required — Optional description of the MCP server.
  - `createdAt` string, date-time, required — ISO timestamp of when the server was created.
  - `updatedAt` string, date-time, required — ISO timestamp of the last update.
  - `userId` string, required — ID of the user who created the server.
  - `enabled` boolean, required — Whether the MCP server is enabled.
  - `auth` union, required — Authentication configuration for the MCP server.
    - object
      - `type` 'none', required
    - object
      - `type` 'bearer', required
      - `token` string, required — Bearer token for authentication.
    - object
      - `type` 'custom-headers', required
      - `headers` object, required — Custom headers to include in requests.
    - object
      - `type` 'oauth', required
      - `config` object — OAuth configuration discovered or manually set.
        - `authorizationUrl` string, uri, required
        - `tokenUrl` string, uri, required
        - `registrationUrl` string, uri
        - `clientId` string, required
        - `clientSecret` string
        - `scopes` string[], required
        - `usePKCE` boolean, required
        - `issuer` string
        - `resource` string
        - `clientIdMetadataDocumentSupported` boolean
      - `connected` boolean, required — Whether OAuth is currently connected.
      - `expiresAt` string — ISO timestamp when the token expires.
  - `scope` 'user' | 'team', required — Scope of the MCP server configuration.

## Other responses

- `401` — Response for status 401
- `500` — Response for status 500

---

[API](https://skmtc.net/vercel/apis/v0-platform-api-beta.md) · [All operations](https://skmtc.net/vercel/apis/v0-platform-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/v0-platform-api-beta/versions/7c7a496f8022/schema)