POHODA MCP Server

Instructions

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);
      }
    }
  );