apphud-mcp 0.2.2 → 0.2.5

package/dist/src/mcp/server.js

@@ -1,28 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
 import { toToolError } from "../errors/toolError.js";
-import { resolveAuth } from "../security/authResolver.js";
-const authSchema = z
-    .object({
-    tenant_id: z.string().min(1),
-    role: z.enum(["analyst", "support", "admin"]),
-    actor_id: z.string().min(1).optional(),
-})
-    .optional();
-const analyticsPlatformSchema = z.enum(["ios", "android", "web"]);
-const analyticsFiltersSchema = z
-    .record(z.union([z.string(), z.number(), z.boolean(), z.null()]))
-    .optional();
-const analyticsEventsFiltersSchema = z
-    .object({
-    user_id: z.string().min(1).optional(),
-    product_id: z.string().min(1).optional(),
-    event_type: z.string().min(1).optional(),
-    country: z.string().min(1).optional(),
-    platform: analyticsPlatformSchema.optional(),
-})
-    .optional();
+import { executeRemoteTool, getRemoteToolEntries } from "../tools/remoteTools.js";
 function jsonResult(payload, isError = false) {
     return {
         content: [{ type: "text", text: JSON.stringify(payload) }],
@@ -32,819 +11,19 @@ function jsonResult(payload, isError = false) {
 export function createMcpServer(container) {
     const server = new McpServer({
         name: "apphud-mcp",
-        version: "0.2.0",
-    });
-    server.tool("apphud_etl_local_status", "Get local ETL worker status and TODO alerts", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_etl_local_status", async () => container.etlService.localStatus());
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_apps_list_local", "List apps available in local ETL SQLite storage", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_apps_list_local", async () => container.etlService.localAppsList({ include_raw: input.include_raw }));
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_dashboard_local", "Local dashboard summary (Money, Subscriptions, selected range, events, users)", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        from: z.string().datetime().optional(),
-        to: z.string().datetime().optional(),
-        filters: analyticsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_dashboard_local", async () => container.etlService.localDashboard({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                from: input.from,
-                to: input.to,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_events_list_local", "List raw subscription events from local ETL SQLite storage", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        limit: z.number().int().min(1).max(500).optional(),
-        cursor: z.string().min(1).optional(),
-        filters: analyticsEventsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_events_list_local", async () => container.etlService.localEventsList({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                from: input.from,
-                to: input.to,
-                limit: input.limit,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_active_subscriptions_local", "Fetch active paid subscriptions from local ETL SQLite storage", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        platform: analyticsPlatformSchema.optional(),
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_active_subscriptions_local", async () => container.etlService.localMetricValue({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                metric_key: "active_subs",
-                include_raw: input.include_raw,
-                filters: input.platform ? { platform: input.platform } : undefined,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_capabilities_get_local", "Get local analytics capabilities and available metrics", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_capabilities_get_local", async () => container.etlService.localCapabilities({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_metrics_list_local", "List local analytics metric keys", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_metrics_list_local", async () => container.etlService.localMetricsList({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_metric_value_local", "Get single metric value from local ETL SQLite storage", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        metric_key: z.string().min(1),
-        from: z.string().datetime().optional(),
-        to: z.string().datetime().optional(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_metric_value_local", async () => container.etlService.localMetricValue({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                metric_key: input.metric_key,
-                from: input.from,
-                to: input.to,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_metric_timeseries_local", "Get metric timeseries from local ETL SQLite storage", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        metric_key: z.string().min(1),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        granularity: z.enum(["day", "week"]).optional(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_metric_timeseries_local", async () => container.etlService.localMetricTimeseries({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                metric_key: input.metric_key,
-                from: input.from,
-                to: input.to,
-                granularity: input.granularity,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_metric_breakdown_local", "Get metric breakdown from local ETL SQLite storage", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        metric_key: z.string().min(1),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        dimension: z.string().min(1),
-        granularity: z.enum(["day", "week"]).optional(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        limit: z.number().int().min(1).max(200).optional(),
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_metric_breakdown_local", async () => container.etlService.localMetricBreakdown({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                metric_key: input.metric_key,
-                from: input.from,
-                to: input.to,
-                dimension: input.dimension,
-                granularity: input.granularity,
-                limit: input.limit,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_revenue_summary_local", "Get revenue summary from local ETL SQLite storage", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        compare_prev_period: z.boolean().optional(),
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_revenue_summary_local", async () => container.etlService.localRevenueSummary({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                from: input.from,
-                to: input.to,
-                filters: input.filters,
-                compare_prev_period: input.compare_prev_period,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_subscriptions_summary_local", "Get subscriptions KPI summary from local ETL SQLite storage", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        from: z.string().datetime().optional(),
-        to: z.string().datetime().optional(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_subscriptions_summary_local", async () => container.etlService.localSubscriptionsSummary({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                from: input.from,
-                to: input.to,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_conversion_trial_to_paid_local", "Get trial to paid conversion summary from local ETL SQLite storage", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_conversion_trial_to_paid_local", async () => container.etlService.localConversionTrialToPaid({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                from: input.from,
-                to: input.to,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_cohorts_retention_local", "Get cohorts retention from local ETL SQLite storage", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        granularity: z.enum(["day", "week"]).optional(),
-        max_periods: z.number().int().min(1).max(104).optional(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_cohorts_retention_local", async () => container.etlService.localCohortsRetention({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                from: input.from,
-                to: input.to,
-                granularity: input.granularity,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_cohorts_ltv_local", "Get cohorts cumulative LTV from local ETL SQLite storage", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        granularity: z.enum(["day", "week"]).optional(),
-        max_periods: z.number().int().min(1).max(104).optional(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_cohorts_ltv_local", async () => container.etlService.localCohortsLtv({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                from: input.from,
-                to: input.to,
-                granularity: input.granularity,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_query_raw_local", "Low-level local analytics query tool (value/timeseries/breakdown/raw)", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        query: z.object({
-            shape: z.enum(["value", "timeseries", "breakdown", "raw"]),
-            metric_key: z.string().optional(),
-            from: z.string().datetime().optional(),
-            to: z.string().datetime().optional(),
-            granularity: z.enum(["day", "week"]).optional(),
-            dimension: z.string().optional(),
-            endpoint_path: z.string().optional(),
-            method: z.enum(["GET", "POST"]).optional(),
-            query_params: z.record(z.string()).optional(),
-            body: z.record(z.unknown()).optional(),
-            filters: analyticsFiltersSchema,
-            platform: analyticsPlatformSchema.optional(),
-            limit: z.number().int().min(1).max(500).optional(),
-        }),
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_query_raw_local", async () => container.etlService.localQueryRaw({
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                query: input.query,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_apps_list", "List apps available in authenticated Apphud dashboard account", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_apps_list", async () => container.analyticsService.appsList(auth, {
-                include_raw: input.include_raw,
-            }));
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_events_list", "List raw subscription events from Apphud dashboard event feed", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        limit: z.number().int().min(1).max(500).optional(),
-        cursor: z.string().min(1).optional(),
-        filters: analyticsEventsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_events_list", async () => container.analyticsService.eventsList(auth, {
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                from: input.from,
-                to: input.to,
-                limit: input.limit,
-                cursor: input.cursor,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_active_subscriptions", "Fetch active paid subscriptions directly from Apphud analytics endpoint", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        platform: analyticsPlatformSchema.optional(),
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_active_subscriptions", async () => container.analyticsService.activeSubscriptions(auth, {
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                platform: input.platform,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_capabilities_get", "Get analytics capabilities and available metrics", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_capabilities_get", async () => container.analyticsService.capabilities(auth, {
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_metrics_list", "List analytics metric keys", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_metrics_list", async () => container.analyticsService.metricsList(auth, {
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_metric_value", "Get single metric value for period/snapshot", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        metric_key: z.string().min(1),
-        from: z.string().datetime().optional(),
-        to: z.string().datetime().optional(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_metric_value", async () => container.analyticsService.metricValue(auth, {
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                metric_key: input.metric_key,
-                from: input.from,
-                to: input.to,
-                platform: input.platform,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_metric_timeseries", "Get metric timeseries by date range", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        metric_key: z.string().min(1),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        granularity: z.enum(["day", "week"]).optional(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_metric_timeseries", async () => container.analyticsService.metricTimeseries(auth, {
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                metric_key: input.metric_key,
-                from: input.from,
-                to: input.to,
-                granularity: input.granularity,
-                platform: input.platform,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_metric_breakdown", "Get metric breakdown by dimension", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        metric_key: z.string().min(1),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        dimension: z.string().min(1),
-        granularity: z.enum(["day", "week"]).optional(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        limit: z.number().int().min(1).max(200).optional(),
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_metric_breakdown", async () => container.analyticsService.metricBreakdown(auth, {
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                metric_key: input.metric_key,
-                from: input.from,
-                to: input.to,
-                dimension: input.dimension,
-                granularity: input.granularity,
-                platform: input.platform,
-                filters: input.filters,
-                limit: input.limit,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_revenue_summary", "Get revenue summary for date range", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        compare_prev_period: z.boolean().optional(),
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_revenue_summary", async () => container.analyticsService.revenueSummary(auth, {
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                from: input.from,
-                to: input.to,
-                platform: input.platform,
-                filters: input.filters,
-                compare_prev_period: input.compare_prev_period,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_subscriptions_summary", "Get subscriptions KPI summary", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        from: z.string().datetime().optional(),
-        to: z.string().datetime().optional(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_subscriptions_summary", async () => container.analyticsService.subscriptionsSummary(auth, {
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                from: input.from,
-                to: input.to,
-                platform: input.platform,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_conversion_trial_to_paid", "Get trial to paid conversion summary", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_conversion_trial_to_paid", async () => container.analyticsService.conversionTrialToPaid(auth, {
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                from: input.from,
-                to: input.to,
-                platform: input.platform,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_cohorts_retention", "Get cohorts retention from analytics", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        granularity: z.enum(["day", "week"]).optional(),
-        max_periods: z.number().int().min(1).max(104).optional(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_cohorts_retention", async () => container.analyticsService.cohortsRetention(auth, {
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                from: input.from,
-                to: input.to,
-                granularity: input.granularity,
-                max_periods: input.max_periods,
-                platform: input.platform,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_cohorts_ltv", "Get cohorts cumulative LTV from analytics", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        from: z.string().datetime(),
-        to: z.string().datetime(),
-        granularity: z.enum(["day", "week"]).optional(),
-        max_periods: z.number().int().min(1).max(104).optional(),
-        platform: analyticsPlatformSchema.optional(),
-        filters: analyticsFiltersSchema,
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_cohorts_ltv", async () => container.analyticsService.cohortsLtv(auth, {
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                from: input.from,
-                to: input.to,
-                granularity: input.granularity,
-                max_periods: input.max_periods,
-                platform: input.platform,
-                filters: input.filters,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
-    server.tool("apphud_analytics_query_raw", "Low-level analytics query tool (value/timeseries/breakdown/raw)", {
-        tenant_id: z.string().optional(),
-        auth: authSchema,
-        app_id: z.string().min(1).optional(),
-        apphud_app_id: z.string().min(1).optional(),
-        query: z.object({
-            shape: z.enum(["value", "timeseries", "breakdown", "raw"]),
-            metric_key: z.string().optional(),
-            from: z.string().datetime().optional(),
-            to: z.string().datetime().optional(),
-            granularity: z.enum(["day", "week"]).optional(),
-            dimension: z.string().optional(),
-            endpoint_path: z.string().optional(),
-            method: z.enum(["GET", "POST"]).optional(),
-            query_params: z.record(z.string()).optional(),
-            body: z.record(z.unknown()).optional(),
-            filters: analyticsFiltersSchema,
-            platform: analyticsPlatformSchema.optional(),
-            limit: z.number().int().min(1).max(500).optional(),
-        }),
-        include_raw: z.boolean().optional(),
-    }, async (input) => {
-        const auth = resolveAuth(input, container.config);
-        try {
-            const result = await container.toolGuard.run(auth, "apphud_analytics_query_raw", async () => container.analyticsService.queryRaw(auth, {
-                app_id: input.app_id,
-                apphud_app_id: input.apphud_app_id,
-                query: input.query,
-                include_raw: input.include_raw,
-            }), { appId: input.app_id ?? input.apphud_app_id });
-            return jsonResult(result);
-        }
-        catch (error) {
-            return jsonResult(toToolError(error), true);
-        }
-    });
+        version: "0.2.4",
+    });
+    for (const [toolName, definition] of getRemoteToolEntries()) {
+        server.tool(toolName, definition.description, definition.inputShape, async (input) => {
+            try {
+                const result = await executeRemoteTool(container, toolName, input);
+                return jsonResult(result);
+            }
+            catch (error) {
+                return jsonResult(toToolError(error), true);
+            }
+        });
+    }
     return server;
 }
 export async function startMcpStdioServer(container) {