pohoda_list_bank
Retrieve bank documents (receipts and expenses) from POHODA accounting software. Filter results by ID, date range, company name, or last changes to access specific financial records.
Instructions
List bank documents (receipts and expenses) from POHODA. Supports filtering by ID, date range, company name, or last changes. Returns JSON array of matching records.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Filter by bank document ID | |
| dateFrom | No | Filter from date (DD.MM.YYYY or YYYY-MM-DD) | |
| dateTill | No | Filter till date (DD.MM.YYYY or YYYY-MM-DD) | |
| companyName | No | Filter by company name | |
| lastChanges | No | Filter by last changes date |
Implementation Reference
- src/tools/bank.ts:31-47 (handler)Handler implementation for the "pohoda_list_bank" tool.
async (params) => { try { const xml = buildExportRequest( { ico: client.ico }, "lst:listBankRequest", NS.lst, "lst:requestBank", (req) => applyFilter(req, params) ); const response = await client.sendXml(xml); const parsed = parseResponse(response); const data = extractListData(parsed); return jsonResult("Bank documents", data, Array.isArray(data) ? data.length : 0); } catch (e) { return err((e as Error).message); } } - src/tools/bank.ts:21-48 (registration)Registration of the "pohoda_list_bank" tool within the MCP server.
server.tool( "pohoda_list_bank", "List bank documents (receipts and expenses) from POHODA. Supports filtering by ID, date range, company name, or last changes. Returns JSON array of matching records.", { id: z.number().optional().describe("Filter by bank document ID"), dateFrom: z.string().optional().describe("Filter from date (DD.MM.YYYY or YYYY-MM-DD)"), dateTill: z.string().optional().describe("Filter till date (DD.MM.YYYY or YYYY-MM-DD)"), companyName: z.string().optional().describe("Filter by company name"), lastChanges: z.string().optional().describe("Filter by last changes date"), }, async (params) => { try { const xml = buildExportRequest( { ico: client.ico }, "lst:listBankRequest", NS.lst, "lst:requestBank", (req) => applyFilter(req, params) ); const response = await client.sendXml(xml); const parsed = parseResponse(response); const data = extractListData(parsed); return jsonResult("Bank documents", data, Array.isArray(data) ? data.length : 0); } catch (e) { return err((e as Error).message); } } );