Skip to Content
MCPs

Create MCP

Create an MCP. Set origin to "catalog" with a catalog_slug, or "custom" with full config.

POST
/mcps

Create an MCP. Set origin to "catalog" with a catalog_slug, or "custom" with full config.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

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

Required permission

manage_mcps

Request Body

application/json
  1. body

An MCP (Model Context Protocol) server configuration.

origin*McpOrigin

How this resource was added to the gateway.

Value in"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?string

What 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.

Lengthlength <= 500
image_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.

Response Body

The request has succeeded and a new resource has been created as a result.

application/json
  1. response

An MCP (Model Context Protocol) server configuration.

id*uuid
Formatuuid
slug*string

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

Length1 <= length <= 63
origin*McpOrigin

How this resource was added to the gateway.

Value in"catalog""custom"
kind?McpKind

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.

tool_pinning?boolean

Whether 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?integer

How many tools wait for an admin to review.

Formatint32
description?string

What 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.

Lengthlength <= 500
icon_url?string

Address of this resource's custom icon, which loads without credentials. Absent when no icon is set.

Formaturi
created_at*string
Formatdate-time
updated_at*string
Formatdate-time
Example Request
curl -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"  }}'
Example Response
{  "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"}