MCPMCP Tools/Connections/list_connected_accounts

list_connected_accounts

Readconnections:read

List the agency's connected publisher/social accounts (Google, Facebook, Instagram, LinkedIn, X, Pinterest, etc.) — the OAuth credentials connected for listings + posting. Agency-scoped: no clientId required (pass one to narrow). Each account shows platform, displayName, and a computed connectionStatus (CONNECTED / DISCONNECTED / RENEW / MISSING / SUSPENDED), credential validity, fetch state, and fetched-listing count. For a `channel: "local"` (location-bound) account, correlate it to a location via `clientLocationId` (the native ClientLocation.id) — NOT `synupLocationId`, which is legacy-only and null on every fresh, natively-created account; a caller matching on it will silently miss native locations. `channel: "brand"` accounts are client-shared and have no location to correlate to. Use it to find an account to act on, or to spot broken accounts (connectionStatus != CONNECTED). Filter by platform / credentialsValid / fetchStatus. Cursor-paginated.

Parameters
clientIdstringoptional
Optional — restrict to accounts scoped to this client
platform"google" | "facebook" | "instagram" | "linkedin" | "x" | "pinterest" | "apple" | "bluesky" | "mastodon"optional
Platform filter
credentialsValidbooleanoptional
Only valid (true) or invalid (false) credentials
fetchStatus"idle" | "fetching" | "disconnecting"optional
idle | fetching | disconnecting
cursorstringoptional
Pagination cursor from a prior nextCursor
limitnumberoptional
Page size (1–100, default 20)
Example request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_connected_accounts",
    "arguments": {}
  }
}
Example response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Response shape shown for illustration — the actual content depends on the tool and your data.