Get MCP
Get an MCP by ID.
Get an MCP by ID.
ApiKeyAuthAuthorizationBearer <token>Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.
Required permission
view_mcpsmcp_id*stringuuidThe request has succeeded.
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 GET 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/mcps/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "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"}