POHODA MCP Server

Instructions

Implementation Reference

• src/tools/vouchers.ts:31-47 (handler)

  The handler function for 'pohoda_list_vouchers' which builds the XML request, sends it via the client, and parses/returns the voucher list.

  async (params) => {
    try {
      const xml = buildExportRequest(
        { ico: client.ico },
        "lst:listCashRequest",
        NS.lst,
        "lst:requestCash",
        (req) => applyFilter(req, params)
      );
      const response = await client.sendXml(xml);
      const parsed = parseResponse(response);
      const data = extractListData(parsed);
      return jsonResult("Vouchers", data, Array.isArray(data) ? data.length : 0);
    } catch (e) {
      return err((e as Error).message);
    }
  }

• src/tools/vouchers.ts:22-30 (registration)

  The registration and input schema definition for 'pohoda_list_vouchers'.

  "pohoda_list_vouchers",
  "List cash vouchers (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 voucher 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"),
  },