Skip to main content
DELETE
/
api
/
mcp-servers
/
{mcpServerId}
curl -X DELETE "https://api.zudu.ai/api/mcp-servers/mcp_abc123def456" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "message": "MCP server deleted successfully",
  "status": "success",
  "error": null,
  "data": {
    "deleted_server_id": "mcp_abc123def456",
    "organization_id": "org_1234567890"
  }
Permanently delete an MCP server and all its associated data from your organization. 
curl -X DELETE "https://api.zudu.ai/api/mcp-servers/mcp_abc123def456" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "message": "MCP server deleted successfully",
  "status": "success",
  "error": null,
  "data": {
    "deleted_server_id": "mcp_abc123def456",
    "organization_id": "org_1234567890"
  }

​
Headers

​
X-API-KEY
string
required
Your API key (format: sk_...)
​
X-API-SECRET
string
required
Your API secret (format: s3cr3t_...)

​
Path Parameters

​
mcpServerId
string
required
The MCP server ID to delete (format: mcp_...)Example: mcp_abc123def456

​
Response Fields

​
deleted_server_id
string
The ID of the deleted MCP server
​
organization_id
string
Organization ID the server belonged to

​
Error Responses

​
error
string
Not Found - MCP server does not exist
{
  "message": "MCP server not found",
  "status": "error",
  "error": "MCP server with ID 'mcp_abc123' does not exist in organization"
}
​
error
string
Unauthorized - Missing or invalid API key/secret
​
error
string
Internal Server Error - Failed to delete server
{
  "message": "Failed to delete MCP server",
  "status": "error",
  "error": "Database connection failed"
}

​
Notes

  • Warning: This operation is permanent and cannot be undone
  • All associated tool approval hashes and related data will be deleted
  • The server must belong to your organization (automatically enforced)
  • Consider checking for dependent agents before deletion
  • Deletion is immediate and cannot be reversed