> ## Documentation Index
> Fetch the complete documentation index at: https://breadbox-mintlify-7401d007.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`](/api/overview)

### Parameters

None.

### Example input

```json theme={null}
{}
```

<Accordion title="Example output" icon="braces">
  ```json theme={null}
  [
    {
      "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"
    }
  ]
  ```
</Accordion>

### 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`. |