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

# List MCP servers

> Lists MCP servers (current behavior).

## Notes

* Supports pagination, filtering, and sorting
* `limit=0` returns all records
* Pagination metadata may be included (total\_count, page, limit, total\_pages, has\_next, has\_previous)


## OpenAPI

````yaml get /api/mcp-servers
openapi: 3.0.3
info:
  title: Zudu API
  description: >-
    Comprehensive REST API for LiveKit Backend - Call Management, Agent
    Configuration, and Real-time Communication Services
  version: 1.0.0
  contact:
    name: Zudu AI Team
    url: https://zudu.ai
    email: support@zudu.ai
  license:
    name: Proprietary
    url: https://zudu.ai/license
servers:
  - url: https://api.zudu.ai
    description: Production (Customer-facing)
security:
  - apiKey: []
    apiSecret: []
tags:
  - name: Agent Management
    description: Create and manage AI agents
  - name: Call Data Management
    description: Call records and history
  - name: Customer API Keys
    description: Manage API keys
  - name: Post-Call Webhooks
    description: Webhook configuration
  - name: phone-number-controller
    description: Phone numbers
  - name: batch-call-controller
    description: Batch calls
  - name: MCP Server Management
    description: MCP servers
  - name: Knowledge Base Management
    description: Knowledge bases
  - name: Call Analysis
    description: Call analysis
paths:
  /api/mcp-servers:
    get:
      tags:
        - MCP Server Management
      summary: List MCP servers
      description: >-
        Lists MCP servers with pagination, filtering, and sorting. Requires
        X-Service-Key and orgId headers. limit=0 returns all records.
      operationId: listMcpServers
      parameters:
        - name: page
          in: query
          required: false
          description: Page number (0-based)
          schema:
            type: integer
            format: int32
            minimum: 0
            default: 0
            example: 0
        - name: limit
          in: query
          required: false
          description: Items per page (1-100, 0 = all)
          schema:
            maximum: 100
            minimum: 0
            type: integer
            format: int32
            default: 20
            example: 20
        - name: sort
          in: query
          required: false
          description: 'Sort field: name, url, created_at, updated_at'
          schema:
            type: string
            default: created_at
            example: created_at
        - name: order
          in: query
          required: false
          description: 'Sort order: asc, desc'
          schema:
            type: string
            default: desc
            example: desc
        - name: search
          in: query
          required: false
          description: Search in name, URL, description
          schema:
            type: string
        - name: approval_policy
          in: query
          required: false
          description: Filter by approval policy
          schema:
            type: string
        - name: transport
          in: query
          required: false
          description: Filter by transport type (SSE, WebSocket, HTTP)
          schema:
            type: string
      responses:
        '200':
          description: MCP servers retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  status:
                    type: string
                  error:
                    type: string
                    nullable: true
                  data:
                    type: array
                    items:
                      type: object
              example:
                message: MCP servers retrieved successfully
                status: success
                error: null
                data:
                  - id: mcp_016e64b3-7782-45ca-87be-3fc343b8242e
                    organization_id: org_2zC2v0GqxbrfKq1rKazb3gFcPEq
                    url: https://test-mcp-server.example.com
                    name: Test MCP Server
                    approval_policy: auto_approve_all
                    transport: WebSocket
                    description: Test server for API validation
                    request_headers: {}
                    is_creator: true
                    role: admin
                    created_at: 1751401457880
                    updated_at: 1751401457880
                    tool_approval_hashes: []
                    dependent_agents: []
                    config:
                      tool_approval_hashes: []
                      approval_policy: auto_approve_all
                      name: Test MCP Server
                      request_headers: {}
                      description: Test server for API validation
                      transport: WebSocket
                      url: https://test-mcp-server.example.com
                    access_info:
                      role: admin
                      creator_email: null
                      creator_name: null
                      is_creator: true
                    metadata:
                      owner_user_id: null
                      created_at: 1751401457880
        '400':
          description: Invalid sort field or parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  status:
                    type: string
                  error:
                    type: string
                    nullable: true
                  data:
                    type: string
                    nullable: true
              example:
                message: Invalid sort field
                status: error
                error: 'Sort field must be one of: name, url, created_at, updated_at'
                data: null
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  status:
                    type: string
                  error:
                    type: string
                    nullable: true
                  data:
                    type: string
                    nullable: true
              example:
                message: Internal server error
                status: error
                error: Server error
                data: null
components:
  securitySchemes:
    apiKey:
      type: apiKey
      description: API Key for MCP server and external service authentication
      name: X-API-KEY
      in: header
    apiSecret:
      type: apiKey
      description: API Secret for MCP server and external service authentication
      name: X-API-SECRET
      in: header

````