shipitagent

Tools · Services

connections

Read-only

List which external services are connected and which need authenticating, or request a connection you need.

When to use: Check `connections` before using a connector for the first time in a task, and whenever a connector call fails for want of credentials. If something you need is not connected, call this with action="request" and a reason. That surfaces it to the user as a decision. Do not keep retrying the connector, and do not invent an alternative route to the same data.

Example

Run for real by scripts/tool-examples.py in a small demo project, with Haiku 5.5 where the tool calls a model. The output is exactly what the tool returned, in 6.3s.

The call

tool call
{
  "tool": "connections",
  "arguments": {
    "action": "list"
  }
}

Real output

· Confluence — not connected
      tools: confluence
      → Connect Confluence — it needs an API key.
  · Custom API — not connected
      tools: custom_api
      → Connect Custom API — it needs an API key.
  · Figma — not connected
      tools: figma
      → Connect Figma — it needs a token.
  · GitHub — not connected
      tools: github
      → Connect GitHub — it needs a token.
  · GitLab — not connected
      tools: gitlab
      → Connect GitLab — it needs a token.
  · Gmail — not connected
      tools: gmail_search
      → Connect Gmail — it needs you to sign in.
  · Google Calendar — not connected
      tools: google_calendar
      → Connect Google Calendar — it needs you to sign in.
  · Google Drive — not connected
      tools: google_drive
      → Connect Google Drive — it needs you to sign in.
  · Google Sheets — not connected
      tools: google_sheets
      → Connect Google Sheets — it needs you to sign in.
  · Jira — not connected
      tools: jira
      → Connect Jira — it needs an API key.
  · Linear — not connected
      tools: linear
      → Connect Linear — it needs an API key.
  · LinkedIn — not connected
      tools: linkedin_search
      → Connect LinkedIn — it needs you to sign in.
  · Notion — not connected
      tools: notion
      → Connect Notion — it needs a token.
  · Salesforce — not connected
… 11 more lines

Parameters

NameTypeDescription
actionstring'list' shows everything; 'check' reports one connection; 'request' asks the user to connect one.listcheckrequest
connectionstringWhich connection, for 'check' and 'request' — e.g. 'slack', 'github'.
reasonstringFor 'request': why you need it, in one line. The user reads this to decide.
connected_onlybooleanFor 'list': hide what isn't connected.

* required

Work in GitHub, Slack, Jira, Linear, Notion, Google, Stripe and more.