get_connector_installation
Read a project's live installation of one connector — its state, health and the platform's own account for it — and learn why it is missing when it is.
Reads the project's live installation of one connector: the state (pending, connected, degraded, revoked, disconnected) with its reason and detail, whether the creator can fix it (creator_actionable), whether it can act right now (operational), the platform's own external_id, display_name, handle and avatar_url, and the timestamps of its life. The REST twin is GET /v1/projects/{project}/connectors/{key}/installation.
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.
Annotations
It reads and never changes anything.
Arguments
project_id*stringUUID of the project.
connector*stringThe connector key, as `list_connectors` returns it.
What it returns
{ "data": { "id": "3b8f0c6e-2d41-4a97-9e5f-1c7d6b2a8e40", "connector": "telegram", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "scope": "project", "role": "live", "state": "degraded", "state_reason": "connector_api_unauthorized", "state_detail": "The token was revoked in @BotFather.", "creator_actionable": true, "operational": true, "external_id": "7123456789", "display_name": "Research Bot", "handle": "research_bot", "avatar_url": null, "health_checked_at": "2026-09-12T06:00:00Z", "connected_at": "2026-04-21T09:15:00Z", "verified_at": "2026-09-11T06:00:00Z", "revoked_at": null, "disconnected_at": null, "uninstalled_at": null, "created_at": "2026-04-21T09:15:00Z" }, "meta": {}}How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-connector:view.
RESOURCE_NOT_FOUNDthe project is not visible to this token; or context.reason is unknown_connector (the key names no connector) or not_installed (the project has no live installation of it).
How is this guide?
Last updated on
get_connector
Read one Connectors Marketplace card by key — its lane, badges and, for a connector that exists as a package, its manifest and the form that connects it.
get_connector_uninstall_preview
Show what uninstalling a connector from a project would touch, changing nothing — the dialog to confirm before uninstall_connector.