---
title: "List Platform Mcp Catalog"
method: GET
path: "/workspaces/{workspace_id}/mcp-integrations/catalog"
tags: ["mcp-integrations"]
---

# List Platform Mcp Catalog

`GET /workspaces/{workspace_id}/mcp-integrations/catalog`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/workspaces/{workspace_id}/mcp-integrations/catalog`
- Auth: one of:
  - API key in cookie `fastapiusersauth`
  - HTTP bearer

List platform MCP catalog rows with workspace connection state.

## Path parameters

- `workspace_id` string, uuid, required

## Query parameters

- `q` string, nullable: Search name, slug, description
- `category` string, nullable: Filter by category
- `status` 'available' | 'coming_soon' | 'deprecated' | 'hidden', nullable: Filter by catalog status
- `cursor` string, nullable: Cursor for pagination
- `limit` integer

## Response `200`

Successful Response

- PlatformMCPCatalogListResponse: Cursor-paginated platform MCP catalog response.
  - `items` PlatformMCPCatalogRead[], required
    - `id` string, uuid, required
    - `slug` string, required
    - `name` string, required
    - `description` string, required
    - `category` string, required
    - `status` 'available' | 'coming_soon' | 'deprecated' | 'hidden', required
    - `icon_url` string, nullable, required
    - `docs_url` string, nullable, required
    - `provider_id` string, nullable, required
    - `connection_spec` union, required
      - MCPHTTPOAuth2ConnectionSpec: HTTP MCP server using MCP OAuth.
        - `requires_config` boolean
        - `credentials` MCPConnectionCredential[]
          - `key` string, required
          - `label` string, required
          - `description` string, required
          - `required` boolean
          - `secret` boolean
          - `default_value` string, nullable
          - `placeholder` string, nullable: Optional placeholder shown in the configure dialog to hint the expected value format (e.g. 'https://your-console.example.net').
          - `type` 'string' | 'url': Value type used for light client/server validation. 'url' requires an http(s):// scheme.
          - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
        - `kind` 'http_oauth2'
        - `server_type` 'http'
        - `auth_type` 'OAUTH2'
        - `server_uri` string, required
        - `scopes` string[]
        - `oauth_resource` string, nullable
        - `oauth_authorization_endpoint` string, nullable
        - `oauth_token_endpoint` string, nullable
        - `oauth_authorize_params` object
        - `config_fields` MCPConfigField[], required: Configure-dialog view of ``credentials``; same data, UI field shape.
          - `key` string, required
          - `label` string, required
          - `description` string, required
          - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
          - `required` boolean
          - `secret` boolean
          - `placeholder` string, nullable
          - `type` 'string' | 'url'
      - MCPHTTPCustomConnectionSpec: HTTP MCP server using user-provided headers or API keys.
        - `requires_config` boolean
        - `credentials` MCPConnectionCredential[]
          - `key` string, required
          - `label` string, required
          - `description` string, required
          - `required` boolean
          - `secret` boolean
          - `default_value` string, nullable
          - `placeholder` string, nullable: Optional placeholder shown in the configure dialog to hint the expected value format (e.g. 'https://your-console.example.net').
          - `type` 'string' | 'url': Value type used for light client/server validation. 'url' requires an http(s):// scheme.
          - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
        - `kind` 'http_custom'
        - `server_type` 'http'
        - `auth_type` 'CUSTOM'
        - `server_uri` string, required
        - `config_fields` MCPConfigField[], required: Configure-dialog view of ``credentials``; same data, UI field shape.
          - `key` string, required
          - `label` string, required
          - `description` string, required
          - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
          - `required` boolean
          - `secret` boolean
          - `placeholder` string, nullable
          - `type` 'string' | 'url'
      - MCPHTTPNoneConnectionSpec: HTTP MCP server with no authentication.
        - `requires_config` boolean
        - `credentials` MCPConnectionCredential[]
          - `key` string, required
          - `label` string, required
          - `description` string, required
          - `required` boolean
          - `secret` boolean
          - `default_value` string, nullable
          - `placeholder` string, nullable: Optional placeholder shown in the configure dialog to hint the expected value format (e.g. 'https://your-console.example.net').
          - `type` 'string' | 'url': Value type used for light client/server validation. 'url' requires an http(s):// scheme.
          - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
        - `kind` 'http_none'
        - `server_type` 'http'
        - `auth_type` 'NONE'
        - `server_uri` string, required
        - `config_fields` MCPConfigField[], required: Configure-dialog view of ``credentials``; same data, UI field shape.
          - `key` string, required
          - `label` string, required
          - `description` string, required
          - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
          - `required` boolean
          - `secret` boolean
          - `placeholder` string, nullable
          - `type` 'string' | 'url'
      - MCPStdioCustomConnectionSpec: Stdio MCP server using user-provided env vars.
        - `requires_config` boolean
        - `credentials` MCPConnectionCredential[]
          - `key` string, required
          - `label` string, required
          - `description` string, required
          - `required` boolean
          - `secret` boolean
          - `default_value` string, nullable
          - `placeholder` string, nullable: Optional placeholder shown in the configure dialog to hint the expected value format (e.g. 'https://your-console.example.net').
          - `type` 'string' | 'url': Value type used for light client/server validation. 'url' requires an http(s):// scheme.
          - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
        - `kind` 'stdio_custom'
        - `server_type` 'stdio'
        - `auth_type` 'CUSTOM'
        - `stdio_command` string, nullable
        - `stdio_args` string[]
        - `stdio_env` string[]
        - `packages` MCPPackageOption[]
          - `manager` string, required
          - `command` string, required
          - `args` string[]
          - `package` string, nullable
        - `config_fields` MCPConfigField[], required: Configure-dialog view of ``credentials``; same data, UI field shape.
          - `key` string, required
          - `label` string, required
          - `description` string, required
          - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
          - `required` boolean
          - `secret` boolean
          - `placeholder` string, nullable
          - `type` 'string' | 'url'
      - MCPStdioNoneConnectionSpec: Stdio MCP server with no authentication.
        - `requires_config` boolean
        - `credentials` MCPConnectionCredential[]
          - `key` string, required
          - `label` string, required
          - `description` string, required
          - `required` boolean
          - `secret` boolean
          - `default_value` string, nullable
          - `placeholder` string, nullable: Optional placeholder shown in the configure dialog to hint the expected value format (e.g. 'https://your-console.example.net').
          - `type` 'string' | 'url': Value type used for light client/server validation. 'url' requires an http(s):// scheme.
          - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
        - `kind` 'stdio_none'
        - `server_type` 'stdio'
        - `auth_type` 'NONE'
        - `stdio_command` string, nullable
        - `stdio_args` string[]
        - `stdio_env` string[]
        - `packages` MCPPackageOption[]
          - `manager` string, required
          - `command` string, required
          - `args` string[]
          - `package` string, nullable
        - `config_fields` MCPConfigField[], required: Configure-dialog view of ``credentials``; same data, UI field shape.
          - `key` string, required
          - `label` string, required
          - `description` string, required
          - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
          - `required` boolean
          - `secret` boolean
          - `placeholder` string, nullable
          - `type` 'string' | 'url'
    - `connection_options` MCPConnectionOption[]
      - `id` string, required
      - `label` string, required
      - `description` string, nullable
      - `docs_url` string, nullable
      - `connection_spec` union, required
        - MCPHTTPOAuth2ConnectionSpec: HTTP MCP server using MCP OAuth.
          - `requires_config` boolean
          - `credentials` MCPConnectionCredential[]
            - `key` string, required
            - `label` string, required
            - `description` string, required
            - `required` boolean
            - `secret` boolean
            - `default_value` string, nullable
            - `placeholder` string, nullable: Optional placeholder shown in the configure dialog to hint the expected value format (e.g. 'https://your-console.example.net').
            - `type` 'string' | 'url': Value type used for light client/server validation. 'url' requires an http(s):// scheme.
            - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
          - `kind` 'http_oauth2'
          - `server_type` 'http'
          - `auth_type` 'OAUTH2'
          - `server_uri` string, required
          - `scopes` string[]
          - `oauth_resource` string, nullable
          - `oauth_authorization_endpoint` string, nullable
          - `oauth_token_endpoint` string, nullable
          - `oauth_authorize_params` object
          - `config_fields` MCPConfigField[], required: Configure-dialog view of ``credentials``; same data, UI field shape.
            - `key` string, required
            - `label` string, required
            - `description` string, required
            - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
            - `required` boolean
            - `secret` boolean
            - `placeholder` string, nullable
            - `type` 'string' | 'url'
        - MCPHTTPCustomConnectionSpec: HTTP MCP server using user-provided headers or API keys.
          - `requires_config` boolean
          - `credentials` MCPConnectionCredential[]
            - `key` string, required
            - `label` string, required
            - `description` string, required
            - `required` boolean
            - `secret` boolean
            - `default_value` string, nullable
            - `placeholder` string, nullable: Optional placeholder shown in the configure dialog to hint the expected value format (e.g. 'https://your-console.example.net').
            - `type` 'string' | 'url': Value type used for light client/server validation. 'url' requires an http(s):// scheme.
            - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
          - `kind` 'http_custom'
          - `server_type` 'http'
          - `auth_type` 'CUSTOM'
          - `server_uri` string, required
          - `config_fields` MCPConfigField[], required: Configure-dialog view of ``credentials``; same data, UI field shape.
            - `key` string, required
            - `label` string, required
            - `description` string, required
            - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
            - `required` boolean
            - `secret` boolean
            - `placeholder` string, nullable
            - `type` 'string' | 'url'
        - MCPHTTPNoneConnectionSpec: HTTP MCP server with no authentication.
          - `requires_config` boolean
          - `credentials` MCPConnectionCredential[]
            - `key` string, required
            - `label` string, required
            - `description` string, required
            - `required` boolean
            - `secret` boolean
            - `default_value` string, nullable
            - `placeholder` string, nullable: Optional placeholder shown in the configure dialog to hint the expected value format (e.g. 'https://your-console.example.net').
            - `type` 'string' | 'url': Value type used for light client/server validation. 'url' requires an http(s):// scheme.
            - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
          - `kind` 'http_none'
          - `server_type` 'http'
          - `auth_type` 'NONE'
          - `server_uri` string, required
          - `config_fields` MCPConfigField[], required: Configure-dialog view of ``credentials``; same data, UI field shape.
            - `key` string, required
            - `label` string, required
            - `description` string, required
            - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
            - `required` boolean
            - `secret` boolean
            - `placeholder` string, nullable
            - `type` 'string' | 'url'
        - MCPStdioCustomConnectionSpec: Stdio MCP server using user-provided env vars.
          - `requires_config` boolean
          - `credentials` MCPConnectionCredential[]
            - `key` string, required
            - `label` string, required
            - `description` string, required
            - `required` boolean
            - `secret` boolean
            - `default_value` string, nullable
            - `placeholder` string, nullable: Optional placeholder shown in the configure dialog to hint the expected value format (e.g. 'https://your-console.example.net').
            - `type` 'string' | 'url': Value type used for light client/server validation. 'url' requires an http(s):// scheme.
            - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
          - `kind` 'stdio_custom'
          - `server_type` 'stdio'
          - `auth_type` 'CUSTOM'
          - `stdio_command` string, nullable
          - `stdio_args` string[]
          - `stdio_env` string[]
          - `packages` MCPPackageOption[]
            - `manager` string, required
            - `command` string, required
            - `args` string[]
            - `package` string, nullable
          - `config_fields` MCPConfigField[], required: Configure-dialog view of ``credentials``; same data, UI field shape.
            - `key` string, required
            - `label` string, required
            - `description` string, required
            - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
            - `required` boolean
            - `secret` boolean
            - `placeholder` string, nullable
            - `type` 'string' | 'url'
        - MCPStdioNoneConnectionSpec: Stdio MCP server with no authentication.
          - `requires_config` boolean
          - `credentials` MCPConnectionCredential[]
            - `key` string, required
            - `label` string, required
            - `description` string, required
            - `required` boolean
            - `secret` boolean
            - `default_value` string, nullable
            - `placeholder` string, nullable: Optional placeholder shown in the configure dialog to hint the expected value format (e.g. 'https://your-console.example.net').
            - `type` 'string' | 'url': Value type used for light client/server validation. 'url' requires an http(s):// scheme.
            - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
          - `kind` 'stdio_none'
          - `server_type` 'stdio'
          - `auth_type` 'NONE'
          - `stdio_command` string, nullable
          - `stdio_args` string[]
          - `stdio_env` string[]
          - `packages` MCPPackageOption[]
            - `manager` string, required
            - `command` string, required
            - `args` string[]
            - `package` string, nullable
          - `config_fields` MCPConfigField[], required: Configure-dialog view of ``credentials``; same data, UI field shape.
            - `key` string, required
            - `label` string, required
            - `description` string, required
            - `target` 'server_uri' | 'oauth_client' | 'http_header' | 'stdio_env', required
            - `required` boolean
            - `secret` boolean
            - `placeholder` string, nullable
            - `type` 'string' | 'url'
    - `state` 'not_configured' | 'configured' | 'connected' | 'reauth_required' | 'error', required
    - `mcp_integration_id` string, uuid4, nullable, required
    - `mcp_server_type` 'http' | 'stdio'
    - `mcp_auth_type` 'OAUTH2' | 'CUSTOM' | 'NONE': Authentication type for MCP integrations.
    - `tools` MCPToolSummary[], nullable
      - `name` string, required
      - `description` string, nullable
      - `enabled` boolean
      - `requires_approval` boolean
      - `status` 'available' | 'missing'
      - `input_schema` object, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `last_refreshed_at` string, date-time, nullable, required
  - `next_cursor` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tracecat/apis/tracecat-api.md) - [All operations](https://skmtc.dev/tracecat/apis/tracecat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tracecat/apis/tracecat-api/revisions/2efdda25045f?raw)