pohoda_list_addresses

Retrieve and filter address records from POHODA accounting software by ID, company name, IČO, last changes date, or code. Returns matching addresses in JSON format.

Instructions

List addresses from POHODA addressbook. Supports filtering by id, company name, IČO, last changes date, or code. Returns JSON array of matching address records.

Input Schema

TableJSON Schema

Name	Required	Description
`id`	No	Filter by address ID
`companyName`	No	Filter by company name
`ico`	No	Filter by IČO (company ID number)
`lastChanges`	No	Filter by last changes date (DD.MM.YYYY or YYYY-MM-DD)
`code`	No	Filter by address code

Implementation Reference

src/tools/addresses.ts:21-44 (handler)

Handler function for the 'pohoda_list_addresses' tool. It builds an XML request using provided filters, sends it via the Pohoda client, parses the response, and returns the result.

async (params) => {
  try {
    const filterParams: ListFilterParams = {
      id: params.id,
      companyName: params.companyName,
      ico: params.ico,
      lastChanges: params.lastChanges,
      code: params.code,
    };
    const xml = buildExportRequest(
      { ico: client.ico },
      "lst:listAddressBookRequest",
      NS.lAdb,
      "lst:requestAddressBook",
      (req) => applyFilter(req, filterParams)
    );
    const response = await client.sendXml(xml);
    const parsed = parseResponse(response);
    const data = extractListData(parsed);
    return jsonResult("Addresses", data, Array.isArray(data) ? data.length : 0);
  } catch (e) {
    return err((e as Error).message);
  }
}

src/tools/addresses.ts:11-20 (registration)

Registration of the 'pohoda_list_addresses' tool with its schema definition within the 'registerAddressTools' function.

server.tool(
  "pohoda_list_addresses",
  "List addresses from POHODA addressbook. Supports filtering by id, company name, IČO, last changes date, or code. Returns JSON array of matching address records.",
  {
    id: z.number().optional().describe("Filter by address ID"),
    companyName: z.string().optional().describe("Filter by company name"),
    ico: z.string().optional().describe("Filter by IČO (company ID number)"),
    lastChanges: z.string().optional().describe("Filter by last changes date (DD.MM.YYYY or YYYY-MM-DD)"),
    code: z.string().optional().describe("Filter by address code"),
  },

POHODA MCP Server