Sign in
MCP

Update MCP server config

patch/api/v2/organizations/{organization}/mcp-servers/{mcpserverconfig}

Path parameters

organizationstring required

Organization name or ID

mcpserverconfigstring uuid required

MCP server config ID

Request body

allow_in_plan_modeboolean
api_key_headerstring
api_key_valuestring
auth_type'none' | 'oauth2' | 'api_key' | 'custom_headers' | 'user_oidc'
availability'force_on' | 'default_on' | 'default_off'
custom_headersobject
descriptionstring
display_namestring
enabledboolean
forward_coder_headersboolean

ForwardCoderHeaders, when set, updates whether Coder identity headers are forwarded on every outgoing MCP request.

icon_urlstring
model_intentboolean
oauth2_auth_urlstring
oauth2_client_idstring
oauth2_client_secretstring
oauth2_revocation_urlstring

OAuth2RevocationURL is validated in the handler because a validate tag would reject the pointer to "" that clears it.

oauth2_scopesstring
oauth2_token_urlstring
slugstring
tool_allow_liststring[]
tool_deny_liststring[]
transport'streamable_http' | 'sse'
urlstring

Response

OK

allow_in_plan_modeboolean
api_key_headerstring

API key fields (only populated for admins).

auth_connectedboolean

Per-user state (populated for non-admin requests).

auth_typestring

"none", "oauth2", "api_key", "custom_headers", "user_oidc"

availabilitystring

Availability policy set by admin.

created_atstring date-time
descriptionstring
display_namestring
enabledboolean
forward_coder_headersboolean

ForwardCoderHeaders forwards the same Coder identity headers we send to LLM providers (X-Coder-Owner-Id, X-Coder-Chat-Id, and the optional X-Coder-Subchat-Id and X-Coder-Workspace-Id) to this MCP server on every request. Off by default to avoid leaking chat identity to third-party servers.

has_api_keyboolean
has_custom_headersboolean
has_oauth2_secretboolean
icon_urlstring
idstring uuid
model_intentboolean
oauth2_auth_urlstring
oauth2_client_idstring

OAuth2 fields (only populated for admins).

oauth2_revocation_urlstring
oauth2_scopesstring
oauth2_token_urlstring
organization_idstring uuid
slugstring
tool_allow_liststring[]

Tool governance.

tool_deny_liststring[]
transportstring

"streamable_http" or "sse"

updated_atstring date-time
urlstring

Changes