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

# List MCP Catalog

> Lists available MCP servers from the global catalog with pagination and search.

Lists MCP servers available in the global catalog.

Use this endpoint to discover providers and server metadata before creating or selecting user servers.

## Usage

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://app.splox.io/api/v1/mcp-catalog?page=1&per_page=20&search=github" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

  ```python Python theme={null}
  from splox import SploxClient

  client = SploxClient(api_key="YOUR_API_KEY")
  resp = client.mcp.list_catalog(page=1, per_page=20, search="github")
  for item in resp.mcp_servers:
      print(item.id, item.name, item.url)
  ```

  ```typescript Node.js theme={null}
  import Splox from "splox";

  const client = new Splox("YOUR_API_KEY");
  const resp = await client.mcp.listCatalog({ page: 1, per_page: 20, search: "github" });
  for (const item of resp.mcp_servers) {
    console.log(item.id, item.name, item.url);
  }
  ```

  ```go Go theme={null}
  resp, err := client.MCP.ListCatalog(ctx, &splox.CatalogParams{
      Page:    1,
      PerPage: 20,
      Search:  "github",
  })
  if err != nil {
      panic(err)
  }
  for _, item := range resp.MCPServers {
      fmt.Println(item.ID, item.Name, item.URL)
  }
  ```
</CodeGroup>


## OpenAPI

````yaml GET /mcp-catalog
openapi: 3.1.0
info:
  title: Splox API
  description: >-
    Run workflows, manage chats, receive events, and monitor execution via the
    Splox API
  version: 1.0.0
  contact:
    name: Splox Support
    email: support@splox.io
    url: https://community.splox.io
servers:
  - url: https://app.splox.io/api/v1
    description: Production API
security: []
tags:
  - name: MCP
    description: Discover MCP servers, manage connections, and execute MCP tools
  - name: Workflows
    description: List, get, and inspect workflows, versions, and nodes
  - name: Workflow Requests
    description: Run workflows, monitor execution, and retrieve results
  - name: Events
    description: Receive external events via Event Hub webhooks
  - name: Chats
    description: Manage chat sessions for workflow interactions
paths:
  /mcp-catalog:
    get:
      tags:
        - MCP
      summary: List MCP Catalog
      description: >-
        Lists available MCP servers from the global catalog with pagination and
        search.
      operationId: listMCPCatalog
      parameters:
        - name: page
          in: query
          description: Page number (default 1)
          schema:
            type: integer
            default: 1
            minimum: 1
        - name: per_page
          in: query
          description: Items per page (default 20, max 100)
          schema:
            type: integer
            default: 20
            minimum: 1
            maximum: 100
        - name: search
          in: query
          description: Search by name, description, or URL
          schema:
            type: string
        - name: featured
          in: query
          description: Filter to featured MCP servers
          schema:
            type: boolean
      responses:
        '200':
          description: Catalog retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  mcp_servers:
                    type: array
                    items:
                      $ref: '#/components/schemas/MCPCatalogItem'
                  current_page:
                    type: integer
                  per_page:
                    type: integer
                  total_count:
                    type: integer
                  total_pages:
                    type: integer
      security:
        - bearerAuth: []
components:
  schemas:
    MCPCatalogItem:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        description:
          type: string
          nullable: true
        url:
          type: string
        transport_type:
          type: string
        auth_type:
          type: string
        auth_config:
          type: object
          additionalProperties: true
          nullable: true
        image_url:
          type: string
          nullable: true
        category:
          type: string
          nullable: true
        is_featured:
          type: boolean
        display_order:
          type: integer
          nullable: true
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - id
        - name
        - url
        - transport_type
        - auth_type
        - is_featured
        - created_at
        - updated_at
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API token generated from your Splox account settings. Create tokens at
        https://app.splox.io/account?tab=settings

````