Integration Manage Tool
integration_manageManage third-party integrations: list, connect, disconnect, ping, and execute actions on upstream services via typed capabilities.
Instructions
Third-party service integrations (Airtable, Notion, Linear, Stripe, Slack, GitHub via OAuth2 + driver interface). Each integration declares typed capabilities (action endpoints) discoverable at runtime. execute invokes one capability with params validated against the driver's schema; output is normalized to JSON.
Actions:
list (read) — optional: driver, status filter.
connect (write) — driver, name, credentials (object — driver-specific). Initiates OAuth or stores API keys.
disconnect (DESTRUCTIVE) — integration_id. Revokes tokens and deletes the connection.
ping (read) — integration_id. Health-check the upstream API.
execute (write — side effects on upstream) — integration_id, integration_action (capability name), params (object).
capabilities (read) — integration_id. Available actions + parameter schemas.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Action to perform: list, connect, disconnect, ping, execute, capabilities | |
| deadline_ms | No | Optional: max wall-clock time (ms) the tool may spend. If exceeded during the call, returns a DEADLINE_EXCEEDED error. Minimum 100 ms. Leave unset for no deadline. | |
| driver | No | Filter by driver slug (e.g. github, slack, notion) | |
| include_drivers | No | Include list of available drivers (default false) | |
| name | Yes | Human-readable name for this integration instance | |
| credentials | No | Credential key-value pairs, e.g. {"token": "ghp_..."} | |
| config | No | Driver-specific config, e.g. {"database_id": "..."} for Notion | |
| integration_id | Yes | Integration UUID | |
| integration_action | Yes | Driver action key, e.g. post_tweet, create_issue, send_message | |
| params | No | Action parameters (driver-specific) |