> ## Documentation Index > Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt > Use this file to discover all available pages before exploring further. # Delete an MCP server > Removes an MCP server and returns it as it was. Its `id` stays in the tool permissions that name it until they are next set. The instance must be `ready`; otherwise the request answers `409`. ## OpenAPI ````yaml /openapi/source/external/agent-gateway/agent-gateway.json delete /agent_gateways/{instance_id}/mcp_servers/{server_id} openapi: 3.1.0 info: version: 1.0.0 title: Telnyx API x-latency-category: interactive x-endpoint-cost: light description: >- Agent Gateway authenticates, authorizes, and audits the requests agents send to models, tools, and other agents. Each gateway runs as a dedicated instance on the account's [*Network*](https://developers.telnyx.com/docs/network/overview). This API creates, lists, and deletes instances, and manages the keys, teams, spend logs, MCP servers, APIs, tool permissions, and guardrails on them. Each instance serves an OpenAI-compatible API at its `gateway_url`. servers: - url: https://api.telnyx.com/v2 description: Telnyx API v2 security: - bearerAuth: [] tags: - name: Agent Gateways description: Create, list, retrieve, and delete Agent Gateway instances. - name: Agent Gateway Keys description: Keys on an instance. - name: Agent Gateway Teams description: 'Teams on an instance: shared model lists, budgets, and rate limits.' - name: Agent Gateway Spend Logs description: The requests an instance served, with their cost. - name: Agent Gateway MCP Servers description: MCP servers on an instance, served to agents at one MCP endpoint. - name: Agent Gateway APIs description: REST APIs on an instance, served to agents as tools. - name: Agent Gateway Tool Permissions description: The MCP servers and tools a key or team may use. - name: Agent Gateway Guardrails description: Checks an instance runs on model and tool requests. - name: Agent Gateway Policies description: Named sets of guardrails an instance applies to requests. - name: Agent Gateway Policy Attachments description: Where an instance applies each policy. paths: /agent_gateways/{instance_id}/mcp_servers/{server_id}: delete: tags: - Agent Gateway MCP Servers summary: Delete an MCP server description: >- Removes an MCP server and returns it as it was. Its `id` stays in the tool permissions that name it until they are next set. The instance must be `ready`; otherwise the request answers `409`. operationId: DeleteAgentGatewayMcpServer parameters: - name: instance_id in: path required: true description: The Agent Gateway's `id`. schema: type: string format: uuid example: 32ce035d-3165-4031-b1a7-a7c0c259590a - name: server_id in: path required: true description: The MCP server's `id`. schema: type: string format: uuid example: 88d5a97b-4080-4855-8bac-a39811b1dc24 responses: '200': description: The deleted MCP server content: application/json: schema: $ref: '#/components/schemas/AgentGatewayMcpServerResponse' example: data: id: 88d5a97b-4080-4855-8bac-a39811b1dc24 name: orders url: http://10.40.3.7:9000/mcp transport: http auth: type: api_key tools: [] static_headers: X-Env: prod forwarded_headers: - X-Request-Id open_to_every_key: false created_at: '2026-10-28T16:50:43.184000Z' updated_at: '2026-10-28T16:50:43.184000Z' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/TelnyxErrors' example: errors: - code: '10009' title: Authentication failed detail: >- The required authentication headers were either invalid or not included in the request. meta: url: https://developers.telnyx.com/docs/overview/errors/10009 '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/TelnyxErrors' example: errors: - code: '10005' title: Resource not found detail: The requested resource or URL could not be found. meta: url: https://developers.telnyx.com/docs/overview/errors/10005 '409': description: The instance is not `ready` content: application/json: schema: $ref: '#/components/schemas/TelnyxErrors' example: errors: - code: '99901' title: Instance not ready detail: The instance is not ready; its engine is not running. '502': description: The instance's engine did not answer content: application/json: schema: $ref: '#/components/schemas/TelnyxErrors' example: errors: - code: '99903' title: Engine unavailable detail: The instance's engine did not answer; try again shortly. components: schemas: AgentGatewayMcpServerResponse: type: object required: - data properties: data: $ref: '#/components/schemas/AgentGatewayMcpServer' TelnyxErrors: type: object properties: errors: type: array items: $ref: '#/components/schemas/TelnyxError' AgentGatewayMcpServer: type: object required: - id - name - url - transport - auth - tools - static_headers - forwarded_headers - open_to_every_key - created_at - updated_at properties: id: type: string format: uuid description: Identifies the server. name: type: string description: >- A name for the server, unique on the instance across MCP servers and APIs, regardless of case. Letters, digits, `_`, and `.`. The gateway prefixes the server's tools with it and a hyphen. url: type: string description: The server's MCP endpoint. transport: type: string enum: - http - sse description: '`http` for Streamable HTTP, or `sse` for Server-Sent Events.' auth: $ref: '#/components/schemas/AgentGatewayShownAuth' tools: type: array items: type: string description: >- The tools the server exposes to every key, by name. `[]` exposes every tool. static_headers: type: object additionalProperties: type: string description: Headers sent on every request. forwarded_headers: type: array items: type: string maxItems: 32 description: Headers copied from the agent's request, by name. open_to_every_key: type: boolean default: false description: >- `true` lets every key on the instance use the server, granted or not. created_at: type: - string - 'null' format: date-time updated_at: type: - string - 'null' format: date-time TelnyxError: type: object properties: code: type: string title: type: string detail: type: string source: type: object properties: pointer: type: string parameter: type: string meta: type: object properties: url: type: string AgentGatewayShownAuth: type: object description: >- The server's outbound authentication method. Credentials are never returned. properties: type: type: string description: The method's `type`. required: - type securitySchemes: bearerAuth: type: http scheme: bearer description: Telnyx API key ````