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

# Export every MCP tool across all servers

> GoModel API reference for GET /admin/mcp-servers/catalog: Export every MCP tool across all servers.



## OpenAPI

````yaml /openapi.json get /admin/mcp-servers/catalog
openapi: 3.0.0
info:
  description: >-
    AI gateway routing requests to multiple LLM providers (OpenAI, Anthropic,
    Gemini, Groq, Fireworks AI, Meta, OpenRouter, Kilo AI, DeepSeek, Z.ai, xAI,
    MiniMax, Xiaomi MiMo, Mistral AI, OpenCode Go, Oracle, Ollama, Bailian).
    Drop-in OpenAI-compatible API.
  title: GoModel API
  contact: {}
  version: '1.0'
servers:
  - url: '{base_url}'
    description: Edit the base URL to point at your GoModel deployment.
    variables:
      base_url:
        default: http://localhost:8080
        description: Your GoModel deployment URL
security: []
paths:
  /admin/mcp-servers/catalog:
    get:
      tags:
        - admin
      summary: Export every MCP tool across all servers
      description: >-
        Lists every tool the MCP servers report, one row per tool with its
        server, for security reviews and audits. name is the name that reaches
        the tool on the aggregated endpoint (/mcp, or /mcp/{virtual_server} with
        virtual_server) and upstream_name the server's own name for the tool,
        which /mcp/{server} serves. exposed is false for a tool the server's
        allowed_tools / disallowed_tools hide. shadowed_by names the server that
        owns the tool's /mcp name when two servers produce the same one: the
        gateway keeps the first in slug order, so that name reaches the other
        server's tool, and this one stays callable only on /mcp/{server}. name
        is empty for a tool that is not exposed or is shadowed. read_only and
        destructive are true only when the upstream set the hint. Each row
        repeats its server's transport, enabled flag, status, and user-path
        scope. virtual_server and user_path describe the endpoint: they narrow
        the servers, combine, and decide name ownership among the servers left;
        without them ownership is decided across all servers. An empty user_path
        does not filter. server only keeps that server's rows. The export reads
        the catalogs the gateway already holds: a disabled server, or one that
        never connected, is listed under servers with its status and no tools,
        and a degraded server that connected before keeps its last catalog and
        its tools. In CSV, a server without tools is one row with empty tool
        columns, and user paths are separated by line breaks.
      parameters:
        - description: 'Export format: json (default) or csv (as an attachment)'
          name: format
          in: query
          schema:
            type: string
        - description: Keep the rows of one MCP server, by slug
          name: server
          in: query
          schema:
            type: string
        - description: Keep the members of one virtual MCP server
          name: virtual_server
          in: query
          schema:
            type: string
        - description: Keep the servers a caller with this user path can see, e.g. /team/x
          name: user_path
          in: query
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/mcpgateway.ToolCatalog'
            text/csv:
              schema:
                type: string
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/core.GatewayError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/core.GatewayError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/core.GatewayError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/core.GatewayError'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/core.GatewayError'
      security:
        - BearerAuth: []
components:
  schemas:
    mcpgateway.ToolCatalog:
      type: object
      properties:
        servers:
          type: array
          items:
            $ref: '#/components/schemas/mcpgateway.ToolCatalogServer'
        tools:
          type: array
          items:
            $ref: '#/components/schemas/mcpgateway.ToolCatalogTool'
    core.GatewayError:
      type: object
      properties:
        code:
          type: string
          nullable: true
        message:
          type: string
        param:
          type: string
          nullable: true
        provider:
          type: string
        status_code:
          type: integer
        type:
          $ref: '#/components/schemas/core.ErrorType'
    mcpgateway.ToolCatalogServer:
      type: object
      properties:
        disallowed_user_paths:
          type: array
          items:
            type: string
        enabled:
          type: boolean
        server:
          type: string
        server_name:
          type: string
        status:
          $ref: '#/components/schemas/mcpgateway.ServerStatus'
        transport:
          type: string
        user_paths:
          type: array
          items:
            type: string
    mcpgateway.ToolCatalogTool:
      type: object
      properties:
        description:
          type: string
        destructive:
          type: boolean
        disallowed_user_paths:
          type: array
          items:
            type: string
        enabled:
          type: boolean
        exposed:
          description: |-
            Exposed is false for a tool the server's allowed_tools /
            disallowed_tools hide from clients. It says nothing about shadowing.
          type: boolean
        name:
          description: >-
            Name is the name that reaches this tool on the aggregated endpoint

            (/mcp, or the virtual server in the filter). It is empty when no
            such

            name exists: the tool is not exposed, or it is shadowed.
          type: string
        read_only:
          type: boolean
        server:
          type: string
        server_name:
          type: string
        shadowed_by:
          description: >-
            ShadowedBy names the server that owns this tool's aggregated name:

            two servers produced the same name and the gateway keeps the first

            in slug order, so that name reaches the other server's tool. The
            tool

            stays callable on /mcp/{server} under UpstreamName.
          type: string
        status:
          $ref: '#/components/schemas/mcpgateway.ServerStatus'
        transport:
          type: string
        upstream_name:
          type: string
        user_paths:
          type: array
          items:
            type: string
    core.ErrorType:
      type: string
      enum:
        - provider_error
        - rate_limit_error
        - invalid_request_error
        - authentication_error
        - not_found_error
        - permission_error
        - internal_error
      x-enum-varnames:
        - ErrorTypeProvider
        - ErrorTypeRateLimit
        - ErrorTypeInvalidRequest
        - ErrorTypeAuthentication
        - ErrorTypeNotFound
        - ErrorTypePermission
        - ErrorTypeInternal
    mcpgateway.ServerStatus:
      type: string
      enum:
        - disabled
        - connecting
        - connected
        - degraded
      x-enum-varnames:
        - StatusDisabled
        - StatusConnecting
        - StatusConnected
        - StatusDegraded
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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