Delete MCP server by ID

DELETE/tools/mcp-server/{mcp_server_id}

Deletes a MCP server by ID

RequiresBearerauthentication

Path parameters

mcp_server_idstringrequired

ID of the MCP server to delete

Returns

Successfully deleted MCP server

Response fields

successbooleanoptional

Whether the operation succeeded

messagestringoptional

Status message

dataobjectoptional

Single MCP server (returned by GET /tools/mcp-server/{mcp_server_id}).

idstringoptional

ID of the MCP server

namestringoptional

Name of the MCP server

descriptionstringoptional

Description of the MCP server

mcp_server_urlstringoptional

URL of the MCP server

mcp_serversobject[]optional

List of MCP servers. Returned by /tools/mcp-server/create (the newly created server) and /tools/mcp-server/list (all servers).

idstringoptional

ID of the MCP server

namestringoptional

Name of the MCP server

descriptionstringoptional

Description of the MCP server

mcp_server_urlstringoptional

URL of the MCP server

mcp_server_toolsobject[]optional

Tools loaded from the MCP server. Returned by /tools/mcp-server/create alongside the server record, since tool discovery happens at create time.

idstringoptional

ID of the MCP server tool

namestringoptional

Name of the MCP server tool

descriptionstringoptional

Description of the MCP server tool

input_schemaobjectoptional

Input schema of the MCP server tool

mcp_server_idstringoptional

ID of the MCP server that the tool belongs to

mcp_server_urlstringoptional

URL of the MCP server

DELETERequest

curl -X DELETE 'https://experiment.app.pheno.ml/tools/mcp-server/abc-123-def-456' \
  -H 'Authorization: Bearer YOUR_API_KEY'

200 OKResponse

{
  "success": true,
  "message": "Successfully deleted MCP server",
  "data": {
    "id": "123",
    "name": "My MCP Server",
    "description": "My MCP Server is a server that provides MCP services",
    "mcp_server_url": "https://mcp.example.com"
  },
  "mcp_servers": [
    {
      "id": {},
      "name": {},
      "description": {},
      "mcp_server_url": {}
    }
  ],
  "mcp_server_tools": [
    {
      "id": "123",
      "name": "My MCP Server Tool",
      "description": "My MCP Server Tool is a tool that provides MCP services",
      "input_schema": {
        "name": "string",
        "age": "number"
      },
      "mcp_server_id": "123",
      "mcp_server_url": "https://mcp.example.com"
    }
  ]
}