Skip to main content
PATCH
Update an MCP server

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

mcp_server_id
string<uuid>
required

Body

application/json

A partial MCP server update; absent fields keep their value.

enabled
boolean | null
headers
Headers · object | null

When present, REPLACES the whole header dict — values are never echoed back, so an edit re-enters every kept header.

name
string | null
Required string length: 1 - 255
url
string | null
Required string length: 1 - 2048

Response

Successful Response

One org-level MCP server as the agent editor renders it.

account_label
string | null
required

OAuth servers only: best-effort account/workspace name of the grant.

auth_mode
string
required

How requests authenticate: 'headers' (static) or 'oauth'.

catalog_slug
string | null
required

The curated-catalog entry this server came from; null for custom servers.

created_at
string<date-time>
required
enabled
boolean
required
header_names
string[]
required

The names of the configured request headers. Values are credentials and are never returned by the API.

id
string<uuid>
required
name
string
required
oauth_status
string | null
required

OAuth servers only: 'active' or 'needs_reconnect'; null for static-header servers and never-connected rows.

updated_at
string<date-time>
required
url
string
required