umami-mcp

Instructions

Implementation Reference

• src/tools/events.ts:101-120 (handler)

  The MCP tool 'get_event_data_values' is defined and implemented here, querying the Umami API endpoint '/api/websites/{websiteId}/event-data/values' to retrieve aggregated event data.

  server.tool(
    "get_event_data_values",
    "Get event data values (aggregated counts for a specific property) 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"),
      propertyName: z.string().optional().describe("Filter by property name"),
    },
    async ({ websiteId, startAt, endAt, eventName, propertyName }) => {
      const data = await client.call(
        "GET",
        `/api/websites/${websiteId}/event-data/values`,
        undefined,
        { startAt, endAt, eventName, propertyName }
      );
      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
    }
  );