umami-mcp

Instructions

Implementation Reference

• src/tools/events.ts:61-79 (handler)

  The tool "get_event_data_events" is defined and implemented within the registerEventTools function in src/tools/events.ts. It calls the client with a GET request to the Umami API.

  server.tool(
    "get_event_data_events",
    "Get event data events (custom event names and counts) for a website",
    {
      websiteId: z.string().describe("Website UUID"),
      startAt: z.number().describe("Start timestamp in milliseconds"),
      endAt: z.number().describe("End timestamp in milliseconds"),
      eventName: z.string().optional().describe("Filter by event name"),
    },
    async ({ websiteId, startAt, endAt, eventName }) => {
      const data = await client.call(
        "GET",
        `/api/websites/${websiteId}/event-data/events`,
        undefined,
        { startAt, endAt, eventName }
      );
      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
    }
  );