amplitude-cli 0.3.0

package/dist/commands/events.js

@@ -0,0 +1,46 @@
+/**
+ * Event discovery commands — list events, get properties.
+ * All queries go through the Amplitude MCP server (OAuth).
+ */
+import { AmplitudeMcpClient } from "../mcp-client.js";
+import { output } from "../utils/format.js";
+import { extractMcpText } from "../utils/mcp-helpers.js";
+import { handleError } from "../utils/errors.js";
+export function registerEventCommands(program) {
+    const events = program
+        .command("events")
+        .description("Discover and inspect event types");
+    events
+        .command("list")
+        .description("List event types in the project")
+        .option("-s, --search <query>", "Filter events by name")
+        .option("--limit <n>", "Max results", "50")
+        .option("-f, --format <format>", "Output format: json, compact, csv", "json")
+        .action(async (opts) => {
+        try {
+            const mcp = new AmplitudeMcpClient();
+            const query = opts.search || "*";
+            const result = await mcp.search(query, ["EVENT", "CUSTOM_EVENT"], parseInt(opts.limit));
+            const data = extractMcpText(result);
+            output(data, opts.format);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    events
+        .command("props <event-type>")
+        .description("Get all properties for an event type")
+        .option("-f, --format <format>", "Output format: json, compact, csv", "json")
+        .action(async (eventType, opts) => {
+        try {
+            const mcp = new AmplitudeMcpClient();
+            const result = await mcp.getEventProperties(eventType);
+            output(extractMcpText(result), opts.format);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=events.js.map

package/dist/commands/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/commands/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAqB,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,kCAAkC,CAAC,CAAC;IAEnD,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,iCAAiC,CAAC;SAC9C,MAAM,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;SACvD,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC;SAC1C,MAAM,CAAC,uBAAuB,EAAE,mCAAmC,EAAE,MAAM,CAAC;SAC5E,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAC7B,KAAK,EACL,CAAC,OAAO,EAAE,cAAc,CAAC,EACzB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CACrB,CAAC;YACF,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,MAAsB,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CAAC,sCAAsC,CAAC;SACnD,MAAM,CAAC,uBAAuB,EAAE,mCAAmC,EAAE,MAAM,CAAC;SAC5E,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;YACvD,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAsB,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/experiments.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Experiment commands — analyze A/B tests and feature flags.
+ * All via MCP server (OAuth).
+ */
+import { Command } from "commander";
+export declare function registerExperimentCommands(program: Command): void;

package/dist/commands/experiments.js

@@ -0,0 +1,57 @@
+/**
+ * Experiment commands — analyze A/B tests and feature flags.
+ * All via MCP server (OAuth).
+ */
+import { AmplitudeMcpClient } from "../mcp-client.js";
+import { output } from "../utils/format.js";
+import { extractMcpText } from "../utils/mcp-helpers.js";
+import { handleError } from "../utils/errors.js";
+export function registerExperimentCommands(program) {
+    const experiments = program
+        .command("experiments")
+        .description("Analyze experiments and feature flags");
+    experiments
+        .command("search <query>")
+        .description("Search for experiments and feature flags")
+        .option("--limit <n>", "Max results", "10")
+        .option("-f, --format <format>", "Output format: json, compact, csv", "json")
+        .action(async (query, opts) => {
+        try {
+            const mcp = new AmplitudeMcpClient();
+            const result = await mcp.search(query, ["EXPERIMENT"], parseInt(opts.limit));
+            output(extractMcpText(result), opts.format);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    experiments
+        .command("get <experiment-id...>")
+        .description("Get detailed experiment information")
+        .option("-f, --format <format>", "Output format: json, compact, csv", "json")
+        .action(async (experimentIds, opts) => {
+        try {
+            const mcp = new AmplitudeMcpClient();
+            const result = await mcp.getExperiments(experimentIds);
+            output(extractMcpText(result), opts.format);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    experiments
+        .command("results <experiment-id>")
+        .description("Get experiment results with statistical significance")
+        .option("-f, --format <format>", "Output format: json, compact, csv", "json")
+        .action(async (experimentId, opts) => {
+        try {
+            const mcp = new AmplitudeMcpClient();
+            const result = await mcp.queryExperiment(experimentId);
+            output(extractMcpText(result), opts.format);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=experiments.js.map

package/dist/commands/experiments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiments.js","sourceRoot":"","sources":["../../src/commands/experiments.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAqB,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,MAAM,WAAW,GAAG,OAAO;SACxB,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,uCAAuC,CAAC,CAAC;IAExD,WAAW;SACR,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC;SAC1C,MAAM,CAAC,uBAAuB,EAAE,mCAAmC,EAAE,MAAM,CAAC;SAC5E,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7E,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAsB,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,WAAW;SACR,OAAO,CAAC,wBAAwB,CAAC;SACjC,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,uBAAuB,EAAE,mCAAmC,EAAE,MAAM,CAAC;SAC5E,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE;QACpC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;YACvD,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAsB,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,WAAW;SACR,OAAO,CAAC,yBAAyB,CAAC;SAClC,WAAW,CAAC,sDAAsD,CAAC;SACnE,MAAM,CAAC,uBAAuB,EAAE,mCAAmC,EAAE,MAAM,CAAC;SAC5E,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE;QACnC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;YACvD,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAsB,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/query.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Query commands — event segmentation, funnels, retention, revenue, sessions.
+ * All queries go through the Amplitude MCP server via query_dataset.
+ */
+import { Command } from "commander";
+export declare function registerQueryCommands(program: Command): void;

package/dist/commands/query.js

@@ -0,0 +1,227 @@
+/**
+ * Query commands — event segmentation, funnels, retention, revenue, sessions.
+ * All queries go through the Amplitude MCP server via query_dataset.
+ */
+import { AmplitudeMcpClient } from "../mcp-client.js";
+import { output } from "../utils/format.js";
+import { extractMcpText } from "../utils/mcp-helpers.js";
+import { handleError } from "../utils/errors.js";
+/**
+ * Build a query_dataset definition for event segmentation.
+ */
+function buildSegmentDefinition(opts) {
+    const definition = {
+        chart_type: "LINE",
+        time_range: {
+            start: opts.from,
+            end: opts.to,
+        },
+        series: [
+            {
+                event: opts.event,
+                metric: opts.metric || "uniques",
+                ...(opts.groupBy ? { group_by: parseGroupBy(opts.groupBy) } : {}),
+                ...(opts.filters ? { filters: JSON.parse(opts.filters) } : {}),
+            },
+        ],
+    };
+    if (opts.interval) {
+        definition.interval = intervalToString(opts.interval);
+    }
+    return definition;
+}
+/**
+ * Parse group-by string: "user:platform" → { type: "user", name: "platform" }
+ */
+function parseGroupBy(groupBy) {
+    const parts = groupBy.split(":");
+    if (parts.length > 1) {
+        return [{ type: parts[0], name: parts.slice(1).join(":") }];
+    }
+    return [{ type: "user", name: parts[0] }];
+}
+/**
+ * Map numeric interval to human-readable string for MCP.
+ */
+function intervalToString(interval) {
+    switch (interval) {
+        case "1": return "daily";
+        case "7": return "weekly";
+        case "30": return "monthly";
+        case "-300000": return "realtime";
+        default: return "daily";
+    }
+}
+export function registerQueryCommands(program) {
+    const query = program
+        .command("query")
+        .description("Run analytics queries");
+    // --- Event Segmentation ---
+    query
+        .command("segment")
+        .description("Event segmentation — count events/users over time")
+        .requiredOption("-e, --event <type>", "Event type (_active, _all, or custom)")
+        .requiredOption("--from <date>", "Start date (YYYY-MM-DD)")
+        .requiredOption("--to <date>", "End date (YYYY-MM-DD)")
+        .option("-m, --metric <metric>", "Metric: uniques, totals, avg, pctdau", "uniques")
+        .option("-i, --interval <n>", "Interval: 1 (daily), 7 (weekly), 30 (monthly)", "1")
+        .option("-g, --group-by <property>", "Group by (format: user:prop or event:prop)")
+        .option("--filters <json>", "Event filters as JSON array")
+        .option("-f, --format <format>", "Output format: json, compact, csv", "json")
+        .action(async (opts) => {
+        try {
+            const mcp = new AmplitudeMcpClient();
+            const definition = buildSegmentDefinition(opts);
+            const result = await mcp.queryDataset(definition);
+            output(extractMcpText(result), opts.format);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    // --- Funnel Analysis ---
+    query
+        .command("funnel")
+        .description("Funnel analysis — conversion through event sequence")
+        .requiredOption("-e, --events <types...>", "Events in funnel order (space-separated)")
+        .requiredOption("--from <date>", "Start date (YYYY-MM-DD)")
+        .requiredOption("--to <date>", "End date (YYYY-MM-DD)")
+        .option("-g, --group-by <property>", "Group by property")
+        .option("-f, --format <format>", "Output format: json, compact, csv", "json")
+        .action(async (opts) => {
+        try {
+            const mcp = new AmplitudeMcpClient();
+            const definition = {
+                chart_type: "FUNNEL",
+                time_range: {
+                    start: opts.from,
+                    end: opts.to,
+                },
+                series: opts.events.map((e) => ({
+                    event: e,
+                })),
+            };
+            if (opts.groupBy) {
+                definition.group_by = parseGroupBy(opts.groupBy);
+            }
+            const result = await mcp.queryDataset(definition);
+            output(extractMcpText(result), opts.format);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    // --- Retention Analysis ---
+    query
+        .command("retention")
+        .description("Retention analysis — how users return over time")
+        .requiredOption("--start-event <type>", "Starting event (e.g. signup, _new)")
+        .requiredOption("--return-event <type>", "Return event (e.g. _active, purchase)")
+        .requiredOption("--from <date>", "Start date (YYYY-MM-DD)")
+        .requiredOption("--to <date>", "End date (YYYY-MM-DD)")
+        .option("-f, --format <format>", "Output format: json, compact, csv", "json")
+        .action(async (opts) => {
+        try {
+            const mcp = new AmplitudeMcpClient();
+            const definition = {
+                chart_type: "RETENTION",
+                time_range: {
+                    start: opts.from,
+                    end: opts.to,
+                },
+                series: [
+                    { event: opts.startEvent, role: "start" },
+                    { event: opts.returnEvent, role: "return" },
+                ],
+            };
+            const result = await mcp.queryDataset(definition);
+            output(extractMcpText(result), opts.format);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    // --- Chart Data ---
+    query
+        .command("chart <chart-id>")
+        .description("Get data from a saved Amplitude chart by ID")
+        .option("-f, --format <format>", "Output format: json, compact, csv", "json")
+        .action(async (chartId, opts) => {
+        try {
+            const mcp = new AmplitudeMcpClient();
+            const result = await mcp.queryChart(chartId);
+            output(extractMcpText(result), opts.format);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    // --- Revenue ---
+    query
+        .command("revenue")
+        .description("Revenue analysis (LTV, ARPU, etc.)")
+        .requiredOption("--from <date>", "Start date (YYYY-MM-DD)")
+        .requiredOption("--to <date>", "End date (YYYY-MM-DD)")
+        .option("-m, --metric <type>", "Metric: total, paying, arppu, arpu, avg-revenue, ltv", "total")
+        .option("-i, --interval <n>", "Interval: 1 (daily), 7 (weekly), 30 (monthly)", "1")
+        .option("-g, --group-by <property>", "Group by property")
+        .option("-f, --format <format>", "Output format: json, compact, csv", "json")
+        .action(async (opts) => {
+        try {
+            const mcp = new AmplitudeMcpClient();
+            const definition = {
+                chart_type: "LINE",
+                time_range: {
+                    start: opts.from,
+                    end: opts.to,
+                },
+                series: [
+                    {
+                        event: "_any_revenue_event",
+                        metric: opts.metric || "total",
+                        ...(opts.groupBy ? { group_by: parseGroupBy(opts.groupBy) } : {}),
+                    },
+                ],
+            };
+            if (opts.interval) {
+                definition.interval = intervalToString(opts.interval);
+            }
+            const result = await mcp.queryDataset(definition);
+            output(extractMcpText(result), opts.format);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    // --- Sessions ---
+    query
+        .command("sessions")
+        .description("Session analytics")
+        .requiredOption("--from <date>", "Start date (YYYY-MM-DD)")
+        .requiredOption("--to <date>", "End date (YYYY-MM-DD)")
+        .option("-f, --format <format>", "Output format: json, compact, csv", "json")
+        .action(async (opts) => {
+        try {
+            const mcp = new AmplitudeMcpClient();
+            const definition = {
+                chart_type: "LINE",
+                time_range: {
+                    start: opts.from,
+                    end: opts.to,
+                },
+                series: [
+                    {
+                        event: "_active",
+                        metric: "sessions",
+                    },
+                ],
+            };
+            const result = await mcp.queryDataset(definition);
+            output(extractMcpText(result), opts.format);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=query.js.map

package/dist/commands/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"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"}

package/dist/commands/users.d.ts

@@ -0,0 +1,6 @@
+/**
+ * User lookup commands — search and activity.
+ * Uses MCP get_users tool.
+ */
+import { Command } from "commander";
+export declare function registerUserCommands(program: Command): void;

package/dist/commands/users.js

@@ -0,0 +1,49 @@
+/**
+ * User lookup commands — search and activity.
+ * Uses MCP get_users tool.
+ */
+import { AmplitudeMcpClient } from "../mcp-client.js";
+import { output } from "../utils/format.js";
+import { extractMcpText } from "../utils/mcp-helpers.js";
+import { handleError } from "../utils/errors.js";
+export function registerUserCommands(program) {
+    const users = program
+        .command("users")
+        .description("User search and activity lookup");
+    users
+        .command("search <query>")
+        .description("Search for users by user ID, device ID, or Amplitude ID")
+        .option("-f, --format <format>", "Output format: json, compact, csv", "json")
+        .action(async (query, opts) => {
+        try {
+            const mcp = new AmplitudeMcpClient();
+            const result = await mcp.callTool("get_users", {
+                user_id: query,
+            });
+            output(extractMcpText(result), opts.format);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    users
+        .command("activity <amplitude-id>")
+        .description("Get event timeline for a specific user")
+        .option("--limit <n>", "Max events to return", "100")
+        .option("-f, --format <format>", "Output format: json, compact, csv", "json")
+        .action(async (amplitudeId, opts) => {
+        try {
+            const mcp = new AmplitudeMcpClient();
+            const result = await mcp.callTool("get_users", {
+                amplitude_id: amplitudeId,
+                include_events: true,
+                event_limit: parseInt(opts.limit),
+            });
+            output(extractMcpText(result), opts.format);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=users.js.map

package/dist/commands/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/commands/users.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAqB,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,KAAK,GAAG,OAAO;SAClB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,iCAAiC,CAAC,CAAC;IAElD,KAAK;SACF,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,yDAAyD,CAAC;SACtE,MAAM,CAAC,uBAAuB,EAAE,mCAAmC,EAAE,MAAM,CAAC;SAC5E,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE;gBAC7C,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;YACH,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAsB,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,yBAAyB,CAAC;SAClC,WAAW,CAAC,wCAAwC,CAAC;SACrD,MAAM,CAAC,aAAa,EAAE,sBAAsB,EAAE,KAAK,CAAC;SACpD,MAAM,CAAC,uBAAuB,EAAE,mCAAmC,EAAE,MAAM,CAAC;SAC5E,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE;gBAC7C,YAAY,EAAE,WAAW;gBACzB,cAAc,EAAE,IAAI;gBACpB,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;aAClC,CAAC,CAAC;YACH,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAsB,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * amplitude-cli (amp)
+ *
+ * CLI for querying and managing Amplitude analytics data.
+ * All commands go through Amplitude's MCP server (OAuth).
+ *
+ * Auth: AMPLITUDE_ACCESS_TOKEN env var (Nango) or `amp auth login` (interactive).
+ * Designed for AI agents (OpenClaw) and humans alike.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+/**
+ * amplitude-cli (amp)
+ *
+ * CLI for querying and managing Amplitude analytics data.
+ * All commands go through Amplitude's MCP server (OAuth).
+ *
+ * Auth: AMPLITUDE_ACCESS_TOKEN env var (Nango) or `amp auth login` (interactive).
+ * Designed for AI agents (OpenClaw) and humans alike.
+ */
+import { Command } from "commander";
+import { registerAuthCommands } from "./commands/auth.js";
+import { registerEventCommands } from "./commands/events.js";
+import { registerQueryCommands } from "./commands/query.js";
+import { registerUserCommands } from "./commands/users.js";
+import { registerCohortCommands } from "./commands/cohorts.js";
+import { registerChartCommands } from "./commands/charts.js";
+import { registerDashboardCommands } from "./commands/dashboards.js";
+import { registerExperimentCommands } from "./commands/experiments.js";
+const program = new Command();
+program
+    .name("amp")
+    .description("CLI for Amplitude analytics — query data, create charts, build dashboards, analyze experiments")
+    .version("0.3.0");
+registerAuthCommands(program);
+registerEventCommands(program);
+registerQueryCommands(program);
+registerUserCommands(program);
+registerCohortCommands(program);
+registerChartCommands(program);
+registerDashboardCommands(program);
+registerExperimentCommands(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CACV,gGAAgG,CACjG;KACA,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,yBAAyB,CAAC,OAAO,CAAC,CAAC;AACnC,0BAA0B,CAAC,OAAO,CAAC,CAAC;AAEpC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/mcp-client.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Amplitude MCP client.
+ * Calls Amplitude's MCP server tools (search, query_dataset, save_chart_edits,
+ * create_dashboard, etc.) using OAuth tokens.
+ *
+ * The MCP server exposes tools via JSON-RPC over HTTP (Streamable HTTP transport).
+ */
+export interface McpToolResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: unknown;
+    }>;
+    isError?: boolean;
+}
+export declare class AmplitudeMcpClient {
+    private region;
+    private sessionId?;
+    private initialized;
+    constructor(region?: string);
+    /**
+     * Initialize MCP session. Must be called before any tool calls.
+     * Auto-called by callTool if not yet initialized.
+     */
+    private ensureSession;
+    /**
+     * Call an MCP tool on the Amplitude server.
+     */
+    callTool(toolName: string, args?: Record<string, unknown>): Promise<McpToolResult>;
+    private _callToolOnce;
+    /**
+     * Parse SSE response from MCP server.
+     */
+    private parseSSEResponse;
+    /**
+     * List available MCP tools.
+     */
+    listTools(): Promise<unknown>;
+    /**
+     * Search for entities (charts, dashboards, events, cohorts, etc.)
+     */
+    search(query: string, entityTypes?: string[], limit?: number): Promise<McpToolResult>;
+    /**
+     * Get context (project info, user info).
+     */
+    getContext(): Promise<McpToolResult>;
+    /**
+     * Get chart definitions by ID.
+     */
+    getCharts(chartIds: string[]): Promise<McpToolResult>;
+    /**
+     * Get dashboard by ID.
+     */
+    getDashboard(dashboardId: string): Promise<McpToolResult>;
+    /**
+     * Query a dataset (create/preview a chart).
+     * Returns data + an editId that can be saved.
+     */
+    queryDataset(definition: Record<string, unknown>): Promise<McpToolResult>;
+    /**
+     * Save a chart from query_dataset results.
+     */
+    saveChart(editId: string, name: string, description?: string): Promise<McpToolResult>;
+    /**
+     * Create a dashboard with charts and layout.
+     */
+    createDashboard(name: string, rows: unknown[], description?: string): Promise<McpToolResult>;
+    /**
+     * Get event properties for an event type.
+     */
+    getEventProperties(eventType: string): Promise<McpToolResult>;
+    /**
+     * Query an existing chart's data.
+     */
+    queryChart(chartId: string): Promise<McpToolResult>;
+    /**
+     * Get experiment details.
+     */
+    getExperiments(experimentIds: string[]): Promise<McpToolResult>;
+    /**
+     * Query experiment results.
+     */
+    queryExperiment(experimentId: string): Promise<McpToolResult>;
+}
+export declare class McpError extends Error {
+    code: number;
+    detail: string;
+    tool: string;
+    constructor(code: number, detail: string, tool: string);
+}