MCP Discovery
Operations of the MCP Gateway API. Paths are relative to your deployment's API host.
GET /api/mcp-gateway-api/mcp/discovery/attachable
List visible MCP servers with catalog memberships for attach flows
Authentication: bearer token (Authorization: Bearer <token>)
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
attachmentAuthIntent | query | one of "USER", "APP", "AUTO" | no | Requested auth intent for attach/preflight: USER, APP, or AUTO. |
executionMode | query | one of "pipeline", "interactive", "bootstrap" | no | Execution surface requesting discovery. Used to derive typed readiness states for policy enforcement (pipeline/interactive/bootstrap). |
| Status | Description | Body |
|---|---|---|
| 200 | application/json McpDiscoveryServerResponseDtoDataArrayEnvelope | |
| 400 | application/problem+json ProblemDetailsDto | |
| 401 | application/problem+json ProblemDetailsDto | |
| 403 | application/problem+json ProblemDetailsDto | |
| 404 | application/problem+json ProblemDetailsDto | |
| 409 | application/problem+json ProblemDetailsDto | |
| 422 | application/problem+json ProblemDetailsDto | |
| 500 | application/problem+json ProblemDetailsDto |
GET /api/mcp-gateway-api/mcp/discovery/attachable-catalogs
List visible MCP catalogs as attachable units
Authentication: bearer token (Authorization: Bearer <token>)
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
attachmentAuthIntent | query | one of "USER", "APP", "AUTO" | no | Requested auth intent for attach/preflight: USER, APP, or AUTO. |
executionMode | query | one of "pipeline", "interactive", "bootstrap" | no | Execution surface requesting discovery. Used to derive typed readiness states for policy enforcement (pipeline/interactive/bootstrap). |
| Status | Description | Body |
|---|---|---|
| 200 | application/json McpDiscoveryCatalogSnapshotDtoDataArrayEnvelope | |
| 400 | application/problem+json ProblemDetailsDto | |
| 401 | application/problem+json ProblemDetailsDto | |
| 403 | application/problem+json ProblemDetailsDto | |
| 404 | application/problem+json ProblemDetailsDto | |
| 409 | application/problem+json ProblemDetailsDto | |
| 422 | application/problem+json ProblemDetailsDto | |
| 500 | application/problem+json ProblemDetailsDto |
GET /api/mcp-gateway-api/mcp/discovery/attachable-inventory
List all visible MCP attach targets as a unified inventory
Authentication: bearer token (Authorization: Bearer <token>)
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
attachmentAuthIntent | query | one of "USER", "APP", "AUTO" | no | Requested auth intent for attach/preflight: USER, APP, or AUTO. |
executionMode | query | one of "pipeline", "interactive", "bootstrap" | no | Execution surface requesting discovery. Used to derive typed readiness states for policy enforcement (pipeline/interactive/bootstrap). |
| Status | Description | Body |
|---|---|---|
| 200 | application/json McpDiscoveryInventoryResponseDtoDataArrayEnvelope | |
| 400 | application/problem+json ProblemDetailsDto | |
| 401 | application/problem+json ProblemDetailsDto | |
| 403 | application/problem+json ProblemDetailsDto | |
| 404 | application/problem+json ProblemDetailsDto | |
| 409 | application/problem+json ProblemDetailsDto | |
| 422 | application/problem+json ProblemDetailsDto | |
| 500 | application/problem+json ProblemDetailsDto |