MCPFerramentas MCP/Conexões/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, RENEW, SIGN_IN_EXPIRED, ACCESS_LOST, PERMISSION_MISSING, PAGE_NOT_SHARED, NEEDS_ATTENTION, DISCONNECTED, SUSPENDED); every problem state also carries an `issue` with a plain-language `message` (what happened) and `action` (what to do), 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. `isAgency: true` marks an agency-owned Google/Facebook/Apple listing account (no client) whose locations can be assigned across clients — pass scope: "agency" to list only those. Use it to find an account to act on, or to spot broken accounts (connectionStatus != CONNECTED). Filter by platform / credentialsValid / fetchStatus. Cursor-paginated.

Parâmetros
clientIdstringopcional
Optional — restrict to accounts scoped to this client Accepts the database ID or public cli- ID. IDs must belong to the authenticated agency and permitted client.
platform"google" | "facebook" | "instagram" | "linkedin" | "x" | "pinterest" | "apple" | "bluesky" | "mastodon" | "youtube"opcional
Platform filter
credentialsValidbooleanopcional
Only valid (true) or invalid (false) credentials
fetchStatus"idle" | "fetching" | "disconnecting"opcional
idle | fetching | disconnecting
scope"agency"opcional
agency = only the agency's own Google/Facebook/Apple listing accounts (not tied to a client); each carries assignedLocationCount
cursorstringopcional
Pagination cursor from a prior nextCursor
limitnumberopcional
Page size (1–100, default 20)
Exemplo de solicitação
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_connected_accounts",
    "arguments": {}
  }
}
Exemplo de resposta
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

O formato da resposta é ilustrativo — o conteúdo real depende da ferramenta e dos seus dados.