> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getprimo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get the catalog of MCP Gateway connectors

> Return the MCP servers Primo verified, as JSON `items`: each entry its `key`, name, category, default tool prefix, server URL, transport, authentication and the credential modes it supports (`per_employee`: each employee connects their own account; `shared`: IT connects one account for everyone). Use it to find the `catalogKey` for `createMcpGatewayConnector`; the connectors the company already has are `getMcpGatewayConnectors`. The MCP Gateway serves employees, through their one Primo connection, the tools of the MCP servers (connectors) IT added. No credential is ever sent or returned here: IT connects a shared account, lists the tools and sets their policy in the cockpit, at `cockpitUrl`. A company without the MCP Gateway gets a 403 `McpGatewayNotEnabledError`; a 503 means Primo could not check it, try again in a minute.

Key: ReadScope: Company


## OpenAPI

````yaml https://api.getprimo.com/openapi.json get /mcp-gateway/catalog
openapi: 3.1.1
info:
  title: Public API - BETA
  description: Read docs on https://docs.getprimo.com/
  version: '1.0'
  contact: {}
servers:
  - url: https://api.getprimo.com
security:
  - apikey: []
tags: []
paths:
  /mcp-gateway/catalog:
    get:
      tags:
        - McpGateway
      summary: Get the catalog of MCP Gateway connectors
      description: >-
        Return the MCP servers Primo verified, as JSON `items`: each entry its
        `key`, name, category, default tool prefix, server URL, transport,
        authentication and the credential modes it supports (`per_employee`:
        each employee connects their own account; `shared`: IT connects one
        account for everyone). Use it to find the `catalogKey` for
        `createMcpGatewayConnector`; the connectors the company already has are
        `getMcpGatewayConnectors`. The MCP Gateway serves employees, through
        their one Primo connection, the tools of the MCP servers (connectors) IT
        added. No credential is ever sent or returned here: IT connects a shared
        account, lists the tools and sets their policy in the cockpit, at
        `cockpitUrl`. A company without the MCP Gateway gets a 403
        `McpGatewayNotEnabledError`; a 503 means Primo could not check it, try
        again in a minute.
      operationId: getMcpGatewayCatalog
      parameters: []
      responses:
        default:
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMcpGatewayCatalogResponse_Output'
components:
  schemas:
    GetMcpGatewayCatalogResponse_Output:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              key:
                description: The `catalogKey` to give `createMcpGatewayConnector`
                type: string
              name:
                type: string
              category:
                type: string
              defaultToolPrefix:
                description: The tool prefix a connector gets when none is given
                type: string
              serverUrl:
                type: string
              transport:
                description: >-
                  How the gateway talks to the server: `streamable_http`, or
                  `sse` for an older server
                type: string
                enum:
                  - streamable_http
                  - sse
              authentication:
                description: >-
                  How the server is signed in to: OAuth (`oauth_dynamic`, or
                  `oauth_client` with its client id), a token in a header
                  (`header_token`, its header name and scheme), several headers
                  (`custom_headers`, their names) or `none`. Never a secret: the
                  credential itself is connected in the cockpit
                anyOf:
                  - type: object
                    properties:
                      type:
                        type: string
                        const: oauth_dynamic
                      scopes:
                        type: array
                        items:
                          type: string
                    required:
                      - type
                      - scopes
                    additionalProperties: false
                  - type: object
                    properties:
                      type:
                        type: string
                        const: oauth_client
                      clientId:
                        type: string
                      scopes:
                        type: array
                        items:
                          type: string
                    required:
                      - type
                      - clientId
                      - scopes
                    additionalProperties: false
                  - type: object
                    properties:
                      type:
                        type: string
                        const: header_token
                      headerName:
                        type: string
                      scheme:
                        anyOf:
                          - type: string
                          - type: 'null'
                    required:
                      - type
                      - headerName
                      - scheme
                    additionalProperties: false
                  - type: object
                    properties:
                      type:
                        type: string
                        const: custom_headers
                      headerNames:
                        type: array
                        items:
                          type: string
                    required:
                      - type
                      - headerNames
                    additionalProperties: false
                  - type: object
                    properties:
                      type:
                        type: string
                        const: none
                    required:
                      - type
                    additionalProperties: false
              credentialModes:
                description: The credential modes the server supports
                type: array
                items:
                  description: >-
                    `per_employee`: each employee connects their own account;
                    `shared`: IT connects one account that every employee uses
                  type: string
                  enum:
                    - per_employee
                    - shared
              documentationUrl:
                type: string
            required:
              - key
              - name
              - category
              - defaultToolPrefix
              - serverUrl
              - transport
              - authentication
              - credentialModes
              - documentationUrl
            additionalProperties: false
      required:
        - items
      additionalProperties: false
  securitySchemes:
    apikey:
      scheme: bearer
      bearerFormat: API key
      type: http
      description: >-
        Use your Primo API key in the Authorization header as `Bearer
        <API_KEY>`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.