Delete a custom MCP server
POST/api/v1/mcp-servers/delete
Removes the server record. Deleting an absent server succeeds with deleted: false.
Conversations and profiles retain references to the deleted ID, so remove those
references separately. New resolution fails once deletion is observed; in-flight
calls and previously loaded definitions are not recalled. The referenced secret
is left in place.
To retain the configuration while disabling the server, set enabled: false
through update.
Request
Responses
- 200
Delete processed
Document ID: DOC-IN-tools-connections-servers-api-deleteCustomMcpServer. Section identities and revisions.
| Section | Stable reference |
|---|---|
| Overview | DOC-IN-tools-connections-servers-api-deleteCustomMcpServer#overview |
| Request | DOC-IN-tools-connections-servers-api-deleteCustomMcpServer#request |
| Responses | DOC-IN-tools-connections-servers-api-deleteCustomMcpServer#responses |