APIMCP gateway

Update MCP gateway settings

Change the organization's MCP gateway settings. Omitted fields keep their current value. Changes apply when agents refresh their tool list or reconnect. Previously discovered tools remain callable.

PATCH
/gateway/settings

Change the organization's MCP gateway settings. Omitted fields keep their current value. Changes apply when agents refresh their tool list or reconnect. Previously discovered tools remain callable.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

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

Required permission

manage_gateway_settings

Request Body

application/json
  1. body

The settings to change; omitted fields keep their current value.

tool_search?ToolSearchMode

Controls the advertised tool list: every authorized tool or two tools for searching and invoking them. Both meta-tools remain callable in every mode so cached tool lists keep working.

Value in"off""opt_in""on"

Response Body

The request has succeeded.

application/json
  1. response

Organization-wide settings for the MCP gateway.

tool_search*ToolSearchMode

How agents discover tools: the full list, or two tools that search for and call the rest.

Value in"off""opt_in""on"
Example Request
curl -X PATCH 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/gateway/settings' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "tool_search": "off"}