list_connector_installations
List every connector installation a project holds — live and standby — with its state, health and the platform's own account for it.
Answer "which connectors does this project run, and are they healthy?". Every row the Connectors tab shows: the connector key, the scope (project, or platform for a shared presence Subscriby runs), the role (live for the one that acts, standby for the spare the Disaster Recovery Program keeps), the state (pending, connected, degraded, revoked, disconnected) with its state_reason and state_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 when it was connected, verified, revoked, disconnected or uninstalled. Credentials and settings never appear. The REST twin is GET /v1/projects/{project}/connectors.
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 whose installations to list.
What it returns
{ "data": [ { "id": "3b8f0c6e-2d41-4a97-9e5f-1c7d6b2a8e40", "connector": "telegram", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "scope": "project", "role": "live", "state": "connected", "state_reason": null, "state_detail": null, "creator_actionable": false, "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-12T06:00:00Z", "revoked_at": null, "disconnected_at": null, "uninstalled_at": null, "created_at": "2026-04-21T09:15:00Z" } ], "meta": { "total": 1 }}Rows come oldest first.
How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-connector:view-any.
RESOURCE_NOT_FOUNDthe project is not visible to this token.
How is this guide?
Last updated on