---
title: "Delete an MCP server"
method: DELETE
path: "/api/v3.1/mcp/{id}"
tags: ["MCP", "Servers"]
---

# Delete an MCP server

`DELETE /api/v3.1/mcp/{id}`

Performs a soft delete on a Model Control Protocol (MCP) server, making it unavailable for future use. This operation is reversible in the database but cannot be undone through the API. Any applications or services connected to this server will lose access after deletion.

## Path parameters

- `id` string, required — Unique identifier of the MCP server to retrieve, update, or delete

## Response `200`

Successfully deleted MCP server. The server has been soft-deleted and is no longer available for use.

- object — Response indicating the success of the delete operation
  - `id` string, required — Unique identifier of the MCP server to retrieve, update, or delete
  - `deleted` boolean, required — Indicates whether the MCP server was successfully deleted

## Other responses

- `400` — Bad request. The server ID parameter may be invalid or in an incorrect format.
- `401` — Unauthorized. Authentication is required or the provided credentials are invalid.
- `403` — Forbidden. The authenticated user does not have permission to delete this MCP server.
- `404` — MCP server not found. No server with the specified ID exists or it has already been deleted.
- `500` — Internal server error. An unexpected error occurred while processing the request.

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/versions/4239836857f8/schema)