PATCH /v1/mcp-servers/{server_id} - Update MCP server

PATCH

/v1/mcp-servers/{server_id}

• Production API

Parameters

Path Parameters

server_id

required

string

MCP server ID (prefixed, e.g., mcp_…)

Request Body ^required

Request to update an MCP server. Only provided fields will be updated.

object

api_key

API key for authentication. Set to update.

string | null

description

A human-readable description of what the MCP server provides.

string | null

Example

Updated description

headers

Additional HTTP headers for authentication.

object | null

name

The name of the MCP server.

string | null

Example

updated-mcp-server

status

One of:

null

null

string

The status of the MCP server. Set to “disabled” to disable.

string

Allowed values: active disabled

transport_type

One of:

null

null

string

Transport type.

string

Allowed values: http

url

The URL of the MCP server endpoint.

string | null

Example

https://mcp.example.com/v1/mcp

Responses

200

MCP server updated successfully

MCP Server configuration. Represents a remote MCP server that can provide tools and resources.

object

api_key_set

required

Whether an API key has been configured.

boolean

created_at

required

Timestamp when the MCP server was created.

string format: date-time

description

Human-readable description of the MCP server.

string | null

Example

Atlassian MCP Server for Jira and Confluence

headers

Additional HTTP headers for authentication. Keys are header names, values are header values.

object

key

additional properties

string

id

required

Unique identifier for the MCP server.

string

Example

mcp_01933b5a00007000800000000000001

name

required

Display name of the MCP server.

string

Example

atlassian-mcp-server

status

required

Current lifecycle status of the MCP server.

string

Allowed values: active disabled

transport_type

required

Transport type (currently only HTTP supported).

string

Allowed values: http

updated_at

required

Timestamp when the MCP server was last updated.

string format: date-time

url

required

URL of the MCP server endpoint.

string

Example

https://mcp.atlassian.com/v1/mcp

400

Invalid server ID or input

Standard error response for API endpoints.

object

error

required

Error message describing what went wrong.

string

404

MCP server not found

Standard error response for API endpoints.

object

error

required

Error message describing what went wrong.

string

500

Internal server error

Standard error response for API endpoints.

object

error

required

Error message describing what went wrong.

string