PEX MCP Server

Instructions

Implementation Reference

• src/tools/details.ts:206-237 (handler)

  The handler for 'pex_get_all_cardholder_transactions' is registered in src/tools/details.ts. It fetches data from the PEX API and returns a paginated response.

  server.registerTool(
    "pex_get_all_cardholder_transactions",
    {
      description: "Get all cardholder transactions within a date range. Results are paginated.",
      inputSchema: {
        startDate: z.string().describe("Start date (ISO 8601)"),
        endDate: z.string().describe("End date (ISO 8601)"),
        includePendings: z.boolean().optional().describe("Include pending transactions"),
        includeDeclines: z.boolean().optional().describe("Include declined transactions"),
        page: z.number().optional().default(1).describe("Page number (1-based, default: 1)"),
        pageSize: z.number().optional().default(50).describe("Results per page (default: 50, max: 100)"),
      },
    },
    async ({ startDate, endDate, includePendings, includeDeclines, page, pageSize }) => {
      try {
        const result = await client.get("/Details/AllCardholderTransactions", {
          StartDate: startDate,
          EndDate: endDate,
          IncludePendings: includePendings,
          IncludeDeclines: includeDeclines,
        });
        const paginated = paginateNestedArray(
          result as Record<string, unknown>,
          "TransactionList",
          { page, pageSize }
        );
        return toolResponse(paginated);
      } catch (error) {
        return toolError(error);
      }
    }
  );