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

# List MCP Servers

> Return the organisation's live (not soft-deleted) MCP servers, ordered by name then id. Each item reports the capability status, when capabilities were last observed, and the discovered tool count.



## OpenAPI

````yaml /api-reference/agents/mcp.oas.yaml get /v1/agents/mcp-servers
openapi: 3.1.0
info:
  title: SLNG Agent Resources — MCP servers
  version: 1.0.0
  description: >-
    Public API for organisation tools, MCP servers, Vault entries, and BYOK
    client models.
  contact:
    name: SLNG Support
    email: support@slng.ai
servers:
  - url: https://api.agents.slng.ai
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/agents/mcp-servers:
    get:
      summary: List MCP Servers
      description: >-
        Return the organisation's live (not soft-deleted) MCP servers, ordered
        by name then id. Each item reports the capability status, when
        capabilities were last observed, and the discovered tool count.
      operationId: listMcp
      parameters:
        - name: limit
          in: query
          required: false
          description: >-
            Maximum number of MCP servers to return in one page. Defaults to
            100.
          schema:
            type: integer
            maximum: 200
            minimum: 1
            default: 100
            title: Limit
        - name: offset
          in: query
          required: false
          description: >-
            Number of MCP servers to skip before collecting the page, applied
            after any name filter. Defaults to 0.
          schema:
            type: integer
            maximum: 10000
            minimum: 0
            default: 0
            title: Offset
        - name: name
          in: query
          required: false
          description: >-
            Filter by exact, case-sensitive MCP server names. Repeat the
            parameter for OR matching. Pagination is applied after filtering.
          style: form
          explode: true
          schema:
            type: array
            maxItems: 128
            items:
              type: string
              maxLength: 200
              minLength: 1
      responses:
        '200':
          description: A page of the organisation's MCP servers.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/McpServerListItem'
                title: Response V1 List Mcp
              example:
                - id: 4f9a2b1c-8d3e-4a2b-9c1d-2e3f4a5b6c7d
                  name: crawler
                  url_template: https://mcp.example.com
                  transport: streamable_http
                  revision: 1
                  capability_status: healthy
                  capability_observed_at: '2026-08-01T12:00:00Z'
                  capability_tool_count: 3
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          $ref: '#/components/responses/ForbiddenError'
        '422':
          $ref: '#/components/responses/ValidationError'
        '429':
          $ref: '#/components/responses/RateLimitError'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    McpServerListItem:
      description: >-
        Condensed MCP server record returned by the list endpoint, including the
        latest capability status, when it was observed, and the discovered tool
        count.
      properties:
        id:
          type: string
          format: uuid
          title: Id
        name:
          type: string
          title: Name
        url_template:
          type: string
          description: >-
            Endpoint URL of the MCP server, with any {{$NAME}} Vault secret
            placeholders left unresolved.
          title: Url Template
        transport:
          type: string
          enum:
            - streamable_http
            - sse
          description: Configured transport, either `streamable_http` or `sse`.
          title: Transport
        revision:
          type: integer
          title: Revision
        capability_status:
          type: string
          enum:
            - unknown
            - healthy
            - unavailable
            - invalid
            - circuit_open
          description: >-
            Latest capability health, one of `unknown`, `healthy`,
            `unavailable`, `invalid`, or `circuit_open`. Fetch the full server
            record for the meaning of each value.
          title: Capability Status
        capability_observed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Capability Observed At
        capability_tool_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Capability Tool Count
      type: object
      required:
        - id
        - name
        - url_template
        - transport
        - revision
        - capability_status
      title: McpServerListItem
    ApiErrorResponse:
      type: object
      description: Error envelope returned when a request fails.
      required:
        - detail
        - error
      properties:
        detail:
          type: string
        error:
          $ref: '#/components/schemas/ApiErrorDetail'
    ApiErrorDetail:
      type: object
      description: >-
        Machine-readable error detail with a stable code, a human-readable
        message, and optional field-level entries.
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: Stable machine-readable error code.
        message:
          type: string
        request_id:
          type:
            - string
            - 'null'
        retryable:
          type: boolean
        fields:
          type: array
          items:
            type: object
            additionalProperties: true
  responses:
    UnauthorizedError:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
    ForbiddenError:
      description: >-
        The caller cannot perform this operation, or public resource access is
        disabled for the organisation. Disabled access returns code
        PUBLIC_SHARED_RESOURCES_DISABLED with retryable set to false.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
    ValidationError:
      description: Request validation failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
    RateLimitError:
      description: The organisation's request limit was exceeded.
      headers:
        Retry-After:
          schema:
            type: integer
        X-RateLimit-Limit:
          schema:
            type: integer
        X-RateLimit-Remaining:
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
    InternalServerError:
      description: The operation failed. The response does not expose secret values.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: SLNG API key
      description: Your SLNG consumer API key.

````