Create MCP
Create an MCP. Set origin to "catalog" with a catalog_slug, or "custom" with full config.
Create an MCP. Set origin to "catalog" with a catalog_slug, or "custom" with full config.
ApiKeyAuthAuthorizationBearer <token>Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.
Required permission
manage_mcpsapplication/json- body
An MCP (Model Context Protocol) server configuration.
origin*McpOriginHow this resource was added to the gateway.
"catalog""custom"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.
description?stringWhat this resource is for, in one line. Shown to users on Connections and the resource page, and sent to agents next to the tool prefix. For a catalog resource it replaces the catalog's generic description. Send an empty string on update to clear it.
length <= 500image_id?|An uploaded image to show as this resource's icon. Upload it first with POST /images, then send its id here. On update, omit it to keep the current icon and send null to remove it. Catalog resources keep their brand logo, so setting this on one is rejected.
The request has succeeded and a new resource has been created as a result.
application/json- response
An MCP (Model Context Protocol) server configuration.
id*uuiduuidslug*stringUnique slug identifying this resource — the catalog slug for catalog-origin resources, the custom slug otherwise.
1 <= length <= 63origin*McpOriginHow this resource was added to the gateway.
"catalog""custom"kind?McpKindWhere a resource comes from.
"builtin""external"display_name?stringName shown for this resource. For catalog resources it comes from the catalog entry.
server_url?stringThe upstream server's URL. For catalog resources it comes from the catalog entry.
urigateway_url?stringPer-org gateway URL agents use to reach just this resource.
uriavailable_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.
tool_pinning?booleanWhether changed and new tools are held back from agents until an admin approves them. Turning it off approves every tool that is waiting. Not available for built-in resources.
tools_to_review?integerHow many tools wait for an admin to review.
int32description?stringWhat this resource is for, in one line. Shown to users on Connections and the resource page, and sent to agents next to the tool prefix. For a catalog resource it replaces the catalog's generic description. Send an empty string on update to clear it.
length <= 500icon_url?stringAddress of this resource's custom icon, which loads without credentials. Absent when no icon is set.
uricreated_at*stringdate-timeupdated_at*stringdate-timecurl -X POST 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/mcps' \ -H 'Content-Type: application/json' \ -d '{ "origin": "catalog", "config": { "catalog_slug": "string" }}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "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", "last_changed_at": "2019-08-24T14:15:22Z", "fingerprint": "string", "title": "string", "output_schema": { "property1": null, "property2": null }, "annotations": { "property1": null, "property2": null } } ], "config": { "catalog_slug": "string", "mode": "embedded", "byo_client_id": "string", "token_endpoint_auth_method": "client_secret_basic", "user_authorization": "interactive", "id_jag": { "client": { "client_id": "string", "token_endpoint_auth_method": "client_secret_basic" } } }, "connection_lifetime": { "max_age_seconds": 1, "idle_timeout_seconds": 1 }, "tool_pinning": true, "tools_to_review": 0, "description": "string", "icon_url": "http://example.com", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}