list_accounts — Paginated accounts with balances

The list_accounts tool returns a paginated list of accounts for a single organization, including balance information when available. Use it to let your agent discover accounts and their holdings. The token must carry the accounts.read scope and every request must include intent and organizationId.

Scope

Required OAuth scope: accounts.read

Input

string

required

The organization to query. Must be one of the organizations the token can access.

string

Opaque pagination cursor from a previous response. Keep the same pageSize when following cursors. Never parse, edit, or reuse a cursor across different filter sets.

integer

default:"50"

Number of results per page. Must be between 1 and 100.

string

required

What the user asked for and why this call serves it, in 1 to 500 characters. Required on every tool call. See Common tool arguments.

Output

Account[]

required

Array of accounts.

Show Account

string

required

Always "account".

string

required

Unique account identifier.

string

required

Organization the account belongs to.

string

required

Display name of the account.

string

required

Account type. Values: checking, savings, credit, external.

string

required

Account status. Values: open, frozen, closed.

string

required

Always "USD".

object

Balance values as Money objects. Omitted when unavailable or not readable. Absence never means zero: your agent must not report a missing balance as $0.

Show Balances

Money

Available balance.

Money

Current balance.

Money

Pending balance.

string

required

Last four digits of the account number. Only four digits are ever returned.

string

required

Timestamp when the account was created, in RFC 3339 format.

object

required

Cursor-based pagination metadata.

Show Pagination

boolean

required

Whether more results are available.

integer

required

Number of results in this page.

string

Opaque cursor to fetch the next page. Present only when hasNextPage is true.

Example

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "list_accounts",
    "arguments": {
      "intent": "User asked which accounts the business has and their balances.",
      "organizationId": "org_1",
      "pageSize": 10
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "structuredContent": {
      "data": [
        {
          "object": "account",
          "id": "acc_1",
          "organizationId": "org_1",
          "name": "Operating",
          "type": "checking",
          "status": "open",
          "currency": "USD",
          "balances": {
            "available": { "cents": 100000, "display": "1,000.00", "currency": "USD" },
            "current": { "cents": 120000, "display": "1,200.00", "currency": "USD" },
            "pending": { "cents": 20000, "display": "200.00", "currency": "USD" }
          },
          "accountNumberLast4": "1234",
          "createdAt": "2026-01-04T00:00:00.000Z"
        }
      ],
      "pagination": {
        "hasNextPage": false,
        "pageSize": 10
      }
    }
  }
}

Notes

The balances object may be omitted when balances are unavailable or not readable. Absence never means zero. Your agent must not report a missing balance as $0.
Only the last four digits of the account number are ever returned via accountNumberLast4.
Follow nextCursor until hasNextPage is false. Keep the same pageSize on every page.
If an invalid cursor is supplied, the tool returns an MCP error: The pagination cursor is invalid. Restart pagination without a cursor and keep the same pageSize for subsequent pages.

get_account

Fetch a single account by ID.

Result conventions

Learn how pagination and dual-channel output work across all tools.

Organizations

Transactions

Accounts

Cards

Statements

Contacts

Catalog items

Invoices

list_accounts — Paginated accounts with balances

Scope

Input

Output

Example

Notes

get_account

Result conventions

​Scope

​Input

​Output

​Example

​Notes

get_account

Result conventions

Scope

Input

Output

Example

Notes