revoke_connection - Agentcard

Connect to https://mcp.agentcard.sh/mcp with the user’s connection token (or a buy_token for org-owned accounts). Behavior: destructive, idempotent.

What it does

Revoke a third-party app’s access to the user’s Agentcard account. Disconnects the app and invalidates its OAuth tokens; it must reconnect via OAuth to regain access. Pass the clientId shown by list_connections.

Inputs

Field	Type	Description
`client_id` (required)	string	The OAuth client ID of the app to revoke (from list_connections).

Returns

Field	Type	Description
`message` (required)	string	Human-readable outcome.
`status`	string	Result status: “revoked” when tokens were invalidated, “not_connected” when the app had no active access.
`revoked`	number	Number of OAuth tokens that were revoked.
`clientId`	string	The client ID that was revoked.

Example call

{
  "tool": "revoke_connection",
  "arguments": {
    "client_id": "\u2026"
  }
}