get_account — Retrieve a single account

The get_account tool returns a single account by accountId within an organization, including balance information when available. Use it when your agent already knows the account ID and needs full details. intent, organizationId, and accountId are required, and the token must carry the accounts.read scope.

Scope

Required OAuth scope: accounts.read

Input

string

required

The organization that owns the account. Must be one of the organizations the token can access.

string

required

The unique account identifier to retrieve.

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

The requested account object.

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.

Example

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "get_account",
    "arguments": {
      "intent": "User asked for the current balance of their Operating account.",
      "organizationId": "org_1",
      "accountId": "acc_1"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 5,
  "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"
      }
    }
  }
}

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.
If the account does not exist or is not accessible with the provided token, the tool returns an MCP error: Account not found or not accessible.

list_accounts

List all accounts for an organization with pagination.

Errors

Learn how MCP tool errors and HTTP auth failures are surfaced.

Organizations

Transactions

Accounts

Cards

Statements

Contacts

Catalog items

Invoices

get_account — Retrieve a single account

Scope

Input

Output

Example

Notes

list_accounts

Errors

​Scope

​Input

​Output

​Example

​Notes

list_accounts

Errors

Scope

Input

Output

Example

Notes