Update MCP Server

Updates the configuration of an existing MCP server, including its name, URL, authentication, or enabled status. Supports partial updates.

PATCH/v1/mcp-servers/{mcpServerId}

Usage

TypeScript Example

import { v0 } from 'v0-sdk'const result = await v0.mcpServers.update({  mcpServerId: 'mcp_123',  name: 'Updated MCP Server',  enabled: false,})console.log(result)

API Signature

Request

Path Parameters

mcpServerId: string

The ID of the MCP server to update. Provided as a path parameter.

Body

name?: string

A new name for the MCP server. Must be between 1 and 100 characters.

url?: string

A new URL for the MCP server endpoint. Must be a valid URL and use HTTPS in production. Maximum 500 characters.

description?: string

A new description for the MCP server. Maximum 500 characters.

enabled?: boolean

Whether the MCP server should be enabled.

auth?: object

New authentication configuration for the MCP server.

type: 'none' | 'bearer' | 'custom-headers' | 'oauth'

The authentication method. Use 'oauth' for OAuth MCP servers, 'bearer' for token-based auth, or 'custom-headers' for key-value header pairs.

token?: string

The bearer token. Required when type is 'bearer'. Maximum 1000 characters.

headers?: Record<string, string>

Key-value pairs of custom headers. Required when type is 'custom-headers'. Maximum 10 headers.

config?: object

OAuth configuration. Required when type is 'oauth'. The server needs an active user authorization through the Platform API OAuth flow before it can be used.

authorizationUrl: string

The OAuth authorization endpoint URL.

tokenUrl: string

The OAuth token endpoint URL.

registrationUrl?: string

The optional dynamic client registration endpoint URL.

clientId: string

The OAuth client ID.

clientSecret?: string

The optional OAuth client secret. This value is stored securely and is never returned by the API.

scopes?: string[]

OAuth scopes to request during authorization. Defaults to an empty array.

usePKCE?: boolean

Whether to use PKCE for the authorization code flow. Defaults to true.

issuer?: string

Optional issuer identifier for mix-up protection.

resource?: string

Optional RFC 8707 resource indicator. For MCP servers, this is usually the MCP server URL.

clientIdMetadataDocumentSupported?: boolean

Whether the authorization server supports Client ID Metadata Documents.

scope?: 'user' | 'team'

Whether the server should be scoped to the user or a team.

Response

id: string

A unique identifier for the MCP server.

object: 'mcp_server'

Fixed value identifying this object as an MCP server.

name: string

The name of the MCP server.

url: string

The URL of the MCP server endpoint.

description?: string

The description of the MCP server.

enabled: boolean

Whether the MCP server is currently enabled.

auth: object

The authentication configuration. Only the type is returned; sensitive values are redacted.

type: 'none' | 'bearer' | 'custom-headers' | 'oauth'

The authentication method used by the server.

scope: 'user' | 'team'

Whether the server is scoped to the user or a team.

createdAt: string

The ISO 8601 timestamp when the server was created.

updatedAt?: string

The ISO 8601 timestamp when the server was last updated.