uninstall_connector
Uninstall a connector from a project — grants revoked, resources detached, the row kept — with two opt-ins for the plans it empties. Destructive.
Distinct from disconnecting and never a deletion. Every live grant on the connector's resources is revoked (members are put outside; member.resource_removed per grant), its resources are deactivated as detached with their external ids kept, the installation row stays with uninstalled_at, identities are never removed, and no money moves by itself. Two opt-ins, both on by default, act on the plans left with nothing to grant: unpublish_emptied_plans takes them off sale; cancel_recurring_subscriptions cancels their live recurring subscriptions at the end of the paid period and emails each member. One-time and lifetime purchases are never cancelled. Always read get_connector_uninstall_preview and confirm with the creator first. The REST twin is DELETE /v1/projects/{project}/connectors/{key}.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Delivered to every endpoint subscribed to it once the change is made.
Annotations
A client that honours annotations asks a person before running it.
Arguments
project_id*stringUUID of the project.
connector*stringThe connector key, as `list_connectors` returns it.
unpublish_emptied_plansbooleanoptionalTake the plans left with nothing to grant off sale. Default true.
cancel_recurring_subscriptionsbooleanoptionalCancel the live recurring subscriptions on those plans at the end of their paid period and email each member. Default true. One-time purchases are never cancelled.
What it returns
{ "data": { "installation": { "id": "3b8f0c6e-2d41-4a97-9e5f-1c7d6b2a8e40", "connector": "discord", "state": "disconnected", "operational": false, "uninstalled_at": "2026-09-12T11:30:00+00:00" }, "connector": "discord", "grants_revoked": 41, "resources_detached": 2, "plans_unpublished": 1, "subscriptions_cancelled": 17, "members_notified": 17 }, "meta": {}}How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-connector:delete.
RESOURCE_NOT_FOUNDthe project is not visible to this token, or context.reason is unknown_connector.
CONNECTOR_NOT_INSTALLEDthe project has no installation of the connector.
Events emitted
connector.uninstalledwith the counts.member.resource_removedper revoked grant.plan.deactivatedper emptied plan taken off sale, andsubscription.cancelledper recurring subscription cancelled, when the opt-ins are on.
How is this guide?
Last updated on