Connectors (built-in) Tools

Tools for managing connected app accounts and integrations.

7 tools

Available Tools

connectorAccounts_searchConnectors

Which connectors can be added today: the ready-made vendor connectors that work and every built-in one, searched by name. Optional param "query" (part of the name). Returns up to 50 { name, provider, auth: "sign-in" | "own-app" | "key" | "none", verified } — "own-app" means the person connects it with their own developer app at that service (they paste its Client ID and Client Secret in the connect form, which shows where to create the app and the redirect URI to add); verified means a real sign-in or a passed key check proved it. Use it before telling someone a service can be connected; anything not listed cannot be added today (they can still add any MCP server by URL as a Custom connector under Automations → Connectors), and a connection they already have keeps working.

Input Schema

query string

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connectorAccounts_searchConnectors",
    "arguments": {
          "query": "example"
    }
  }
}

connectorAccounts_create

Connect a new app account. Params: mcpServerId (required, from mcpServer.list), connectionName (required), credentials (object with API keys/tokens).

Input Schema

`mcpServerId`	stringrequired
`connectionName`	stringrequired
`credentials`	objectrequired

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connectorAccounts_create",
    "arguments": {
          "mcpServerId": "example",
          "connectionName": "example",
          "credentials": {}
    }
  }
}

connectorAccounts_list

List connected app accounts (OAuth integrations). Optional param "mcpServerId" to filter. Returns accounts with connection status and mayManage (true when you may change, switch on or off, or remove it; when false the server refuses, so say so and do not retry).

Input Schema

mcpServerId string

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connectorAccounts_list",
    "arguments": {
          "mcpServerId": "example"
    }
  }
}

connectorAccounts_getById

Get one app account (connection) with its MCP server and agent links. Param "appAccountId". Credentials are never returned — only non-sensitive auth metadata (authType, key location/name, username). Also mayManage: true when you may change, switch on or off, or remove it; when false the server refuses, so say so and do not retry.

Input Schema

appAccountId stringrequired

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connectorAccounts_getById",
    "arguments": {
          "appAccountId": "example"
    }
  }
}

connectorAccounts_delete

Disconnect an app account. Param "appAccountId". Act only on what the person named or picked.

Input Schema

appAccountId stringrequired

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connectorAccounts_delete",
    "arguments": {
          "appAccountId": "example"
    }
  }
}

connectorAccounts_toggleActive

Switch one connected account on or off. Params: appAccountId (from list), isActive (true = on, false = off). Off pauses every use of it (the AI chat, agents, functions and flows can no longer run its tools) until it is switched on again; nothing is removed and its saved sign-in is kept. Returns { id, connectionName, isActive, testStatus, createdAt, updatedAt }.

Input Schema

`appAccountId`	stringrequired
`isActive`	booleanrequired

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connectorAccounts_toggleActive",
    "arguments": {
          "appAccountId": "example",
          "isActive": true
    }
  }
}

connectorAccounts_test

Check that a connected account still signs in: tries its SAVED sign-in against its service and records the result (testStatus). Param: appAccountId (from list); nothing else is sent or needed, and the sign-in is never shown. Returns { success }: true when the service accepted it, false when it did not; when the service gave a reason, { error } carries it (with anything that quotes the sign-in hidden). Use it after a person reports a connector stopped working.

Input Schema

appAccountId stringrequired

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connectorAccounts_test",
    "arguments": {
          "appAccountId": "example"
    }
  }
}