SecureAuth Agent Authority
secureauth.com
Request demoFree trial
APIMCP gateway

Get MCP gateway settings

Get the organization's MCP gateway settings. Settings never changed read as their defaults.

GET
/gateway/settings

Get the organization's MCP gateway settings. Settings never changed read as their defaults.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

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

Required permission

view_gateway_settings

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 GET 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/gateway/settings'
Example Response
{  "tool_search": "off"}

Inference Connections_test POST

Verifies the endpoint accepts the stored credential, so a bad key fails here rather than in use.

Update MCP gateway settings PATCH

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.