list_connector_installation_actions
List what a project's installation of a connector can do for the creator right now, beyond gating.
A connector declares the things its installation can set up on its platform as data: each action with its key, the label a button would say, a description of what will happen, the fields the creator fills in first (the same shape as the connector directory's install fields) and the "confirm" question to put to the creator before running, when the action needs one. The list is empty for a connector that offers none, while the connector is paused, and while the installation cannot act. Run one with run_connector_installation_action. The REST twin is GET /v1/projects/{project}/connectors/{key}/installation/actions.
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": [ { "key": "setup_members_area", "label": "Set up a members area", "description": "Creates a Members category with a text channel, an announcements channel and a voice channel, and the role behind them.", "fields": [ { "name": "category_name", "type": "text", "label": "Category name", "help": null, "required": false, "rules": ["string", "max:100"], "options": [], "value": "Members", "steps": [], "links": [] } ], "confirm": "Create the members area in this server now?", "needs_confirmation": true } ], "meta": { "total": 1 }}How it fails
CONNECTOR_NOT_INSTALLEDthe project has no installation of the connector.
RESOURCE_NOT_FOUNDproject_id is not a project the token can see, or connector names no connector.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-connector:view.
How is this guide?
Last updated on
install_connector
Install a connector on a project — a pending installation with no credentials yet, which the creator connects from the dashboard.
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.