Delete an MCP server
/api/v1/mcp-servers/{server_id}Delete an MCP server. Owner or org admin/owner only.
Required access
Credentials: delegated token, user session
Scope: mcp_servers:delete
A delegated token may delete only a connector owned by its user. Deleting it atomically removes its saved agent attachments and appends a new immutable configuration revision to every affected agent. A racing attachment change answers 409; retrieve the latest state before retrying.
Authorization
DelegatedToken A token issued to an external application acting for a specific user, prefixed gsmc_dt_. Carries that user's identity for attribution and ownership, is bound to the organization chosen when it was issued, and stays capped at member role however privileged the user is.
In: header
Path Parameters
uuidHeader Parameters
Selects the active organization for a direct user session that has more than one membership. Service-principal keys and delegated tokens are each bound to one organization and ignore it.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/api/v1/mcp-servers/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Authorization: Bearer $GUEST_MACHINES_API_KEY"{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}Update an MCP server PATCH
Update selected connector fields. Omitted fields are unchanged. Changing the endpoint or credential clears cached tool discovery; run the connection probe again to refresh it. An authenticated connector's endpoint is origin-bound: changing its URL requires re-entering `auth_token` or explicitly setting `auth_type` to `none`. Connector edits are compare-and-swapped against the configuration read for validation; a concurrent edit answers `409`, and the caller must retrieve and reconcile the latest configuration.
List agents GET
List agents visible to the caller in the active organization.