APIMCPs

Update MCP

Update an existing MCP.

PATCH
/mcps/{mcp_id}

Update an existing MCP.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.

Required permission

manage_mcps

Path Parameters

mcp_id*string
Formatuuid

Request Body

application/json
  1. body

An MCP (Model Context Protocol) server configuration.

config?|
connection_lifetime?

Connection lifetime bounds for this resource. Only meaningful where users connect their own accounts. Replaced wholesale on update: sending this object with a bound omitted clears that bound rather than leaving it untouched.

Response Body

The request has succeeded.

application/json
  1. response

An MCP (Model Context Protocol) server configuration.

id*string
Formatuuid
slug*string

Unique slug identifying this resource — the catalog slug for catalog-origin resources, the custom slug otherwise.

Length1 <= length <= 63
origin*string

How this resource was added to the gateway.

Value in"catalog""custom"
kind?string

Where a resource comes from.

Value in"builtin""external"
display_name?string

Name shown for this resource. For catalog resources it comes from the catalog entry.

server_url?string

The upstream server's URL. For catalog resources it comes from the catalog entry.

Formaturi
gateway_url?string

Per-org gateway URL agents use to reach just this resource.

Formaturi
available_tools?array<>

Tools this resource exposes to agents.

config*|
connection_lifetime?

Connection lifetime bounds for this resource. Only meaningful where users connect their own accounts. Replaced wholesale on update: sending this object with a bound omitted clears that bound rather than leaving it untouched.

created_at*string
Formatdate-time
updated_at*string
Formatdate-time
curl -X PATCH "https://example.com/mcps/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": null,  "slug": "string",  "origin": "catalog",  "kind": "builtin",  "display_name": "string",  "server_url": "http://example.com",  "gateway_url": "http://example.com",  "available_tools": [    {      "name": "string",      "description": "string",      "input_schema": {        "property1": null,        "property2": null      },      "upstream_id": "string",      "upstream_name": "string"    }  ],  "config": {    "catalog_slug": "string",    "mode": "embedded",    "byo_client_id": "string",    "token_endpoint_auth_method": "client_secret_basic"  },  "connection_lifetime": {    "max_age_seconds": 1,    "idle_timeout_seconds": 1  },  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z"}