---
title: "Update MCP Server"
method: PATCH
path: "/mcp-servers/{mcpServerId}"
tags: ["mcpServers"]
---

# Update MCP Server

`PATCH /mcp-servers/{mcpServerId}`

Updates the configuration of an existing MCP server, including its name, URL, description, enabled status, and authentication settings.

## Path parameters

- `mcpServerId` string, required

## Request body

- object
  - `name` string — The display name of the MCP server.
  - `url` string, uri — The URL of the MCP server.
  - `description` string — An optional description of the MCP server.
  - `enabled` boolean — Whether the MCP server is enabled.
  - `auth` union — Authentication configuration.
    - object
      - `type` 'none', required — No authentication required.
    - object
      - `type` 'bearer', required — Bearer token authentication.
      - `token` string, required — The bearer token for authentication.
    - object
      - `type` 'custom-headers', required — Custom headers authentication.
      - `headers` object, required — Key-value pairs of custom headers to include in requests.
  - `scope` 'user' | 'team' — The scope of the MCP server.

## Response `200`

Success

- object — Summary information about an MCP server.
  - `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/:mcpServerId/patch.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/b73ab7a6f317/schema)