> ## Documentation Index > Fetch the complete documentation index at: https://docs.voice.wixzel.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve an MCP server ## OpenAPI ````yaml /openapi.json get /v1/mcp-servers/{id} openapi: 3.1.0 info: title: Wixzel Voice API version: '2026-09-01' description: >- APIs for agentic telephony. One API key, one balance, every voice engine. ## Authentication Send your key as `Authorization: Bearer wv_live_...`. Keys are scoped: grant only what an integration needs. There is no admin scope. ## Versioning The `/v1` prefix covers additive changes. Behavioural changes ship behind a dated `Wixzel-Version` header, and existing keys keep the behaviour they were created with. ## Money Amounts are integer **micro-USD** (1,000,000 = $1.00). Voice usage is billed per second, per token and per character, so a float dollar figure cannot represent it without disagreeing with the ledger. ## Errors Every error carries a stable `code` and a `request_id`. Match on `code`; the `message` is for humans and may change. contact: name: Wixzel Voice url: https://voice.wixzel.com servers: - url: https://api.voice.wixzel.com description: Production security: [] tags: - name: Calls description: Place calls and read what happened on them. - name: Realtime description: Talk to an agent from a browser or app, with no phone line. - name: Agents description: The prompt, voice and behaviour of a caller. - name: Leads description: People to call, and data to merge into prompts. - name: Campaigns description: Call a list of leads with one agent. - name: Knowledge bases description: Facts an agent can draw on mid-call. - name: Phone numbers description: Numbers on your SIP trunks. - name: SIP trunks description: Your carrier connections. - name: Appointments description: Bookings, including ones agents make on calls. - name: Usage description: Itemised billing lines. - name: Billing description: Balance, ledger and top-ups. - name: API keys description: Create, scope and rotate keys. - name: Engines description: What the platform can serve, and what it costs. - name: Webhooks description: Where events are sent, and what happened when they got there. - name: MCP servers description: Other apps’ tools, for agents to use while they are on a call. paths: /v1/mcp-servers/{id}: get: tags: - MCP servers summary: Retrieve an MCP server parameters: - schema: type: string pattern: ^[0-9a-f]{24}$ example: 6a96a3ead6e886d42462dd3e required: true name: id in: path responses: '200': description: The an MCP server content: application/json: schema: $ref: '#/components/schemas/McpServer' '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Key lacks the required scope content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: No such record content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Rate limited. Retry after the interval in `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearerAuth: [] components: schemas: McpServer: type: object properties: id: type: string pattern: ^[0-9a-f]{24}$ example: 6a96a3ead6e886d42462dd3e object: type: string enum: - mcp_server name: type: string url: type: string transport: type: string enum: - auto - streamable_http - sse auth: type: object properties: type: type: string enum: - none - headers - oauth header_names: type: array items: type: string description: >- The names of the stored headers. Their values are never returned. oauth: type: - object - 'null' properties: client_id: type: - string - 'null' scope: type: - string - 'null' connected: type: boolean connected_at: type: - string - 'null' format: date-time description: ISO 8601, always UTC. example: '2026-09-01T12:00:00.000Z' required: - client_id - scope - connected - connected_at required: - type - header_names - oauth status: type: string enum: - pending - ready - needs_auth - error description: >- `ready` once its tools have been read. `needs_auth` until an OAuth server is connected, or after its sign-in expires. `error` when it could not be reached; `last_error` says why. Agents only use servers that are `ready`. last_error: type: - string - 'null' server_info: type: - object - 'null' properties: name: type: - string - 'null' version: type: - string - 'null' required: - name - version tools: type: array items: $ref: '#/components/schemas/McpServerTool' tools_refreshed_at: type: - string - 'null' format: date-time description: ISO 8601, always UTC. example: '2026-09-01T12:00:00.000Z' created_at: type: string format: date-time description: ISO 8601, always UTC. example: '2026-09-01T12:00:00.000Z' required: - id - object - name - url - transport - auth - status - last_error - server_info - tools - tools_refreshed_at - created_at Error: type: object properties: error: type: object properties: type: type: string enum: - invalid_request_error - authentication_error - permission_error - rate_limit_error - insufficient_credits - not_found_error - conflict_error - api_error code: type: string description: Stable machine-readable code. example: agent_not_found message: type: string description: >- Human-readable explanation. Do not match on this — match on code. param: type: string description: Which field caused the failure, when applicable. doc_url: type: string request_id: type: string description: Quote this when asking for help. example: req_01HXYZ... required: - type - code - message - request_id required: - error McpServerTool: type: object properties: name: type: string title: type: - string - 'null' description: type: string input_schema: type: - object - 'null' additionalProperties: {} description: The JSON Schema of the tool’s arguments, as the server published it. read_only: type: boolean description: The server says this tool does not change anything (readOnlyHint). destructive: type: boolean description: >- The server says this tool may delete or overwrite data (destructiveHint). enabled: type: boolean description: >- Whether agents may call it. Only enabled tools are ever offered to a call. required: - name - title - description - input_schema - read_only - destructive - enabled securitySchemes: bearerAuth: type: http scheme: bearer description: >- Your Wixzel Voice API key: `Authorization: Bearer wv_live_...`. Keys are scoped; grant only what the integration needs. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.