Skip to Content
MCPs

Get MCP

Get an MCP by ID.

GET
/mcps/{mcp_id}

Get an MCP by ID.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

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

Required permission

view_mcps

Path Parameters

mcp_id*string
Formatuuid

Response Body

The request has succeeded.

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 GET 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/mcps/497f6eca-6276-4993-bfeb-53cbbbba6f08'
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"}