> ## 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.

# Create MCP server

> Creates an MCP server (current behavior).

## Notes

* Creates a new MCP server with full configuration


## OpenAPI

````yaml post /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:
    post:
      tags:
        - MCP Server Management
      summary: Create MCP server
      description: >-
        Creates a new MCP server with full configuration. Requires
        X-Service-Key, orgId, and Content-Type: application/json.
      operationId: createMcpServer
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - config
              properties:
                config:
                  type: object
                  required:
                    - name
                    - url
                    - approval_policy
                    - transport
                  properties:
                    name:
                      type: string
                      description: MCP server name
                    url:
                      type: string
                      description: MCP server URL
                    description:
                      type: string
                      description: Optional description
                    approval_policy:
                      type: string
                      description: >-
                        auto_approve_all | require_approval_all |
                        auto_approve_read_only
                    transport:
                      type: string
                      description: SSE | WebSocket | HTTP
                    request_headers:
                      type: object
                      additionalProperties: true
                      description: Custom headers for MCP server
                    secret_token:
                      type: object
                      properties:
                        secret_id:
                          type: string
                      description: Optional secret token
            example:
              config:
                name: Everything MCP Server
                url: >-
                  https://raw.githubusercontent.com/modelcontextprotocol/server-everything/main/package.json
                description: Reference implementation MCP server with all features
                approval_policy: require_approval_all
                transport: SSE
                request_headers:
                  User-Agent: MCP-Client/1.0
                  Accept: application/json
                secret_token:
                  secret_id: secret_token_123
        required: true
      responses:
        '200':
          description: MCP server created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  status:
                    type: string
                  error:
                    type: string
                    nullable: true
                  data:
                    type: object
              example:
                message: MCP server created successfully
                status: success
                error: null
                data:
                  id: mcp_8c180796-e6d7-4343-88b5-5df0846fef69
                  organization_id: org_2zC2v0GqxbrfKq1rKazb3gFcPEq
                  url: >-
                    https://raw.githubusercontent.com/modelcontextprotocol/server-everything/main/package.json
                  name: Everything MCP Server
                  approval_policy: require_approval_all
                  transport: SSE
                  description: Reference implementation MCP server with all features
                  request_headers:
                    User-Agent: MCP-Client/1.0
                    Accept: application/json
                  is_creator: true
                  role: admin
                  created_at: 1751401457604
                  updated_at: 1751401457604
                  tool_approval_hashes: []
                  dependent_agents: []
                  config:
                    tool_approval_hashes: []
                    approval_policy: require_approval_all
                    name: Everything MCP Server
                    request_headers:
                      User-Agent: MCP-Client/1.0
                      Accept: application/json
                    description: Reference implementation MCP server with all features
                    transport: SSE
                    url: >-
                      https://raw.githubusercontent.com/modelcontextprotocol/server-everything/main/package.json
                  access_info:
                    role: admin
                    creator_email: null
                    creator_name: null
                    is_creator: true
                  metadata:
                    owner_user_id: null
                    created_at: 1751401457604
        '400':
          description: Validation failed
          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: Validation failed
                status: error
                error: MCP server name is required
                data: null
        '409':
          description: Duplicate name or URL
          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: MCP server name already exists
                status: error
                error: >-
                  MCP server with name 'Test Server' already exists in
                  organization
                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

````