Connections and sync read MCP reference

MCP read tool for inspecting connection health and sync status.

get_sync_status

Returns the status of all bank connections: provider type, sync state, last sync time, and any error details. Agents call this to check data freshness or diagnose “why don’t I see yesterday’s transactions”.

Scope: Read

Mirrors: GET /api/v1/connections

Parameters

None.

Example input

{}

Example output

[
  {
    "id": "c1Xm9pQ2",
    "institution_name": "Chase",
    "institution_id": "ins_3",
    "provider": "plaid",
    "status": "active",
    "last_synced_at": "2026-04-23T14:32:00Z",
    "error_code": null,
    "error_message": null,
    "user_id": "u4Xm9pQ2",
    "user_name": "Alice",
    "created_at": "2026-01-15T09:00:00Z",
    "updated_at": "2026-04-23T14:32:00Z"
  },
  {
    "id": "c2Yn0qR3",
    "institution_name": "Bank of America",
    "institution_id": "ins_127",
    "provider": "plaid",
    "status": "pending_reauth",
    "last_synced_at": "2026-04-18T09:15:00Z",
    "error_code": "ITEM_LOGIN_REQUIRED",
    "error_message": "User must re-authenticate via Plaid Link.",
    "user_id": "u5Yn0qR3",
    "user_name": "Bob",
    "created_at": "2026-02-01T11:20:00Z",
    "updated_at": "2026-04-18T09:15:00Z"
  }
]

Status values

Status	Meaning
active	Healthy and syncing normally.
error	Last sync failed. Check error_message.
pending_reauth	Bank requires re-authentication in the admin UI.
disconnected	Connection was removed; accounts and transactions are preserved with FKs set to NULL.