Delete MCP Server

curl --request DELETE \
  --url https://api.app.shinzo.ai/v1/mcp/servers/{id} \
  --header 'Authorization: Bearer <token>'

DELETE

mcp

servers

{id}

Delete MCP Server

curl --request DELETE \
  --url https://api.app.shinzo.ai/v1/mcp/servers/{id} \
  --header 'Authorization: Bearer <token>'

Authentication

Requires JWT token or Platform API key via Authorization: Bearer <token> header.

string

required

MCP server UUID

Example Request

curl -X DELETE https://api.app.shinzo.ai/v1/mcp/servers/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer <token>"

Example Response

{
  "message": "MCP server deleted successfully"
}

Status Codes

Code	Description
`200`	MCP server deleted successfully
`401`	Unauthorized - invalid or missing authentication
`404`	MCP server not found
`409`	Server has active agent access grants

If you receive a 409 response, you must revoke all agent access grants before deleting the server. Use the Revoke Agent Access endpoint to remove each grant first.

Overview

Authentication

AI Agents

Agent Messaging

Agent Schedules & Triggers

Agent Channels

Agent Filesystem

MCP Servers

Spotlight

Tokens

Provider Keys

Telemetry

Delete MCP Server

Authentication

Example Request

Example Response

Status Codes

​Authentication

​Example Request

​Example Response

​Status Codes

Authentication

Example Request

Example Response

Status Codes