mercury_list_treasury_transactions
Audit Treasury cash flows and reconcile yield accruals by listing Treasury account transactions like sweeps and dividend accruals.
Instructions
List transactions for a Mercury Treasury account (sweeps, dividend accruals, etc.).
USE WHEN: auditing Treasury cash flows, reconciling yield accruals, or building a Treasury-only ledger view.
DO NOT USE: for deposit-account transactions (use mercury_list_transactions). For IO Credit transactions, use mercury_list_credit_transactions.
RETURNS: { transactions: [{ id, amount, kind, postedAt, ... }] }.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| accountId | Yes | Treasury account ID | |
| limit | No | ||
| offset | No | ||
| start | No | Filter after this date (YYYY-MM-DD) | |
| end | No | Filter before this date (YYYY-MM-DD) |
Implementation Reference
- src/tools/treasury.ts:45-48 (handler)The handler function that executes the tool logic. It calls GET /treasury/{accountId}/transactions with optional query parameters (limit, offset, start, end) and returns the result.
async ({ accountId, ...query }) => { const data = await client.get(`/treasury/${accountId}/transactions`, query); return textResult(data); }, - src/tools/treasury.ts:38-43 (schema)Zod schema defining the input validation for the tool. Accepts accountId (UUID required), plus optional limit, offset, start, and end filters.
{ accountId: z.string().uuid().describe("Treasury account ID"), limit: z.number().int().min(1).max(500).optional(), offset: z.number().int().min(0).optional(), start: z.iso.date().optional().describe("Filter after this date (YYYY-MM-DD)"), end: z.iso.date().optional().describe("Filter before this date (YYYY-MM-DD)"), - src/tools/treasury.ts:26-49 (registration)Registration via defineTool() which internally calls server.registerTool(). The tool is named 'mercury_list_treasury_transactions' with description, schema, and handler.
defineTool( server, "mercury_list_treasury_transactions", [ "List transactions for a Mercury Treasury account (sweeps, dividend accruals, etc.).", "", "USE WHEN: auditing Treasury cash flows, reconciling yield accruals, or building a Treasury-only ledger view.", "", "DO NOT USE: for deposit-account transactions (use `mercury_list_transactions`). For IO Credit transactions, use `mercury_list_credit_transactions`.", "", "RETURNS: `{ transactions: [{ id, amount, kind, postedAt, ... }] }`.", ].join("\n"), { accountId: z.string().uuid().describe("Treasury account ID"), limit: z.number().int().min(1).max(500).optional(), offset: z.number().int().min(0).optional(), start: z.iso.date().optional().describe("Filter after this date (YYYY-MM-DD)"), end: z.iso.date().optional().describe("Filter before this date (YYYY-MM-DD)"), }, async ({ accountId, ...query }) => { const data = await client.get(`/treasury/${accountId}/transactions`, query); return textResult(data); }, );