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

# List MCP Servers

`GET /mcp-servers`

Retrieves all MCP servers configured for the authenticated user.

## Response `200`

Success

- object — List of MCP servers for the authenticated user.
  - `object` 'list', required
  - `data` object[], required
    - `object` 'mcp_server', required — The object type.
    - `id` string, required — The unique identifier for the MCP server.
    - `name` string, required — The display name of the MCP server.
    - `url` string, uri, required — The URL of the MCP server.
    - `description` string — An optional description of the MCP server.
    - `enabled` boolean, required — Whether the MCP server is enabled for use in chats.
    - `auth` object, required — Authentication type for the MCP server. Sensitive values like tokens and headers are not returned.
      - `type` 'none' | 'bearer' | 'custom-headers' | 'oauth', required — The type of authentication configured.
    - `scope` 'user' | 'team', required — The scope of the MCP server (user or team).
    - `createdAt` string, date-time, required — The ISO timestamp when the MCP server was created.
    - `updatedAt` string, date-time — The ISO timestamp when the MCP server was last updated.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `413` — Payload Too Large
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2026-03-06** `b73ab7a6f317` — 1 info
  - endpoint added
- **2025-08-24** `3521652a43a7` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/vercel/apis/v0-platform-api-beta/changes/mcp-servers/get.md)

---

[API](https://skmtc.dev/vercel/apis/v0-platform-api-beta.md) · [All operations](https://skmtc.dev/vercel/apis/v0-platform-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/v0-platform-api-beta/revisions/9758850b2db9/schema)