@cesteral/meta-mcp 1.0.0

package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const SearchTargetingInputSchema: z.ZodObject<{
+    type: z.ZodString;
+    query: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    query: string;
+    limit?: number | undefined;
+}, {
+    type: string;
+    query: string;
+    limit?: number | undefined;
+}>;
+export declare const SearchTargetingOutputSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+    totalCount: z.ZodNumber;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    results: Record<string, any>[];
+    timestamp: string;
+    totalCount: number;
+}, {
+    results: Record<string, any>[];
+    timestamp: string;
+    totalCount: number;
+}>;
+type SearchTargetingInput = z.infer<typeof SearchTargetingInputSchema>;
+type SearchTargetingOutput = z.infer<typeof SearchTargetingOutputSchema>;
+export declare function searchTargetingLogic(input: SearchTargetingInput, context: RequestContext, sdkContext?: SdkContext): Promise<SearchTargetingOutput>;
+export declare function searchTargetingResponseFormatter(result: SearchTargetingOutput): McpTextContent[];
+export declare const searchTargetingTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        type: z.ZodString;
+        query: z.ZodString;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        query: string;
+        limit?: number | undefined;
+    }, {
+        type: string;
+        query: string;
+        limit?: number | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+        totalCount: z.ZodNumber;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        results: Record<string, any>[];
+        timestamp: string;
+        totalCount: number;
+    }, {
+        results: Record<string, any>[];
+        timestamp: string;
+        totalCount: number;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            type: string;
+            query: string;
+            limit: number;
+        };
+    } | {
+        label: string;
+        input: {
+            type: string;
+            query: string;
+            limit?: undefined;
+        };
+    })[];
+    logic: typeof searchTargetingLogic;
+    responseFormatter: typeof searchTargetingResponseFormatter;
+};
+export {};
+//# sourceMappingURL=search-targeting.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-targeting.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-targeting.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAiBnD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAQkB,CAAC;AAE1D,eAAO,MAAM,2BAA2B;;;;;;;;;;;;EAMF,CAAC;AAEvC,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AACvE,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzE,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAiBhC;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,EAAE,CAahG;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B/B,CAAC"}

package/dist/mcp-server/tools/definitions/search-targeting.tool.js

@@ -0,0 +1,87 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "meta_search_targeting";
+const TOOL_TITLE = "Search Meta Targeting Options";
+const TOOL_DESCRIPTION = `Search for targeting options (interests, behaviors, demographics) by keyword.
+
+**Search types:**
+- \`adinterest\` — Search interests by keyword
+- \`adinterestsuggestion\` — Get suggestions based on existing interests
+- \`adinterestvalid\` — Validate interest IDs
+- \`adbehavior\` — Search behavioral targeting options
+- \`adTargetingCategory\` — Browse targeting categories
+- \`adgeolocation\` — Search geographic locations
+- \`adlocale\` — Search locales/languages
+
+Returns matching options with ID, name, audience size, and path.`;
+export const SearchTargetingInputSchema = z
+    .object({
+    type: z
+        .string()
+        .describe("Search type (adinterest, adinterestsuggestion, adgeolocation, adlocale, etc.)"),
+    query: z.string().min(1).describe("Search keyword or query"),
+    limit: z.number().min(1).max(100).optional().describe("Max results to return (default 25)"),
+})
+    .describe("Parameters for searching targeting options");
+export const SearchTargetingOutputSchema = z
+    .object({
+    results: z.array(z.record(z.any())).describe("Matching targeting options"),
+    totalCount: z.number(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Targeting search result");
+export async function searchTargetingLogic(input, context, sdkContext) {
+    const { metaTargetingService } = resolveSessionServices(sdkContext);
+    const result = await metaTargetingService.searchTargeting(input.type, input.query, input.limit, context);
+    const data = result?.data || [];
+    return {
+        results: data,
+        totalCount: data.length,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function searchTargetingResponseFormatter(result) {
+    const summary = `Found ${result.totalCount} targeting option(s)`;
+    const data = result.totalCount > 0
+        ? `\n\n${JSON.stringify(result.results, null, 2)}`
+        : "\n\nNo matching targeting options found";
+    return [
+        {
+            type: "text",
+            text: `${summary}${data}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const searchTargetingTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: SearchTargetingInputSchema,
+    outputSchema: SearchTargetingOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Search for interest targeting",
+            input: {
+                type: "adinterest",
+                query: "running shoes",
+                limit: 10,
+            },
+        },
+        {
+            label: "Search for geographic locations",
+            input: {
+                type: "adgeolocation",
+                query: "New York",
+            },
+        },
+    ],
+    logic: searchTargetingLogic,
+    responseFormatter: searchTargetingResponseFormatter,
+};
+//# sourceMappingURL=search-targeting.tool.js.map

package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-targeting.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-targeting.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts

@@ -0,0 +1,192 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const SubmitReportInputSchema: z.ZodEffects<z.ZodObject<{
+    entityId: z.ZodString;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    datePreset: z.ZodOptional<z.ZodString>;
+    timeRange: z.ZodOptional<z.ZodObject<{
+        since: z.ZodString;
+        until: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        since: string;
+        until: string;
+    }, {
+        since: string;
+        until: string;
+    }>>;
+    timeIncrement: z.ZodOptional<z.ZodString>;
+    level: z.ZodOptional<z.ZodString>;
+    breakdowns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    entityId: string;
+    fields?: string[] | undefined;
+    datePreset?: string | undefined;
+    level?: string | undefined;
+    breakdowns?: string[] | undefined;
+    timeRange?: {
+        since: string;
+        until: string;
+    } | undefined;
+    timeIncrement?: string | undefined;
+}, {
+    entityId: string;
+    fields?: string[] | undefined;
+    datePreset?: string | undefined;
+    level?: string | undefined;
+    breakdowns?: string[] | undefined;
+    timeRange?: {
+        since: string;
+        until: string;
+    } | undefined;
+    timeIncrement?: string | undefined;
+}>, {
+    entityId: string;
+    fields?: string[] | undefined;
+    datePreset?: string | undefined;
+    level?: string | undefined;
+    breakdowns?: string[] | undefined;
+    timeRange?: {
+        since: string;
+        until: string;
+    } | undefined;
+    timeIncrement?: string | undefined;
+}, {
+    entityId: string;
+    fields?: string[] | undefined;
+    datePreset?: string | undefined;
+    level?: string | undefined;
+    breakdowns?: string[] | undefined;
+    timeRange?: {
+        since: string;
+        until: string;
+    } | undefined;
+    timeIncrement?: string | undefined;
+}>;
+export declare const SubmitReportOutputSchema: z.ZodObject<{
+    reportRunId: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reportRunId: string;
+    timestamp: string;
+}, {
+    reportRunId: string;
+    timestamp: string;
+}>;
+type SubmitReportInput = z.infer<typeof SubmitReportInputSchema>;
+type SubmitReportOutput = z.infer<typeof SubmitReportOutputSchema>;
+export declare function submitReportLogic(input: SubmitReportInput, context: RequestContext, sdkContext?: SdkContext): Promise<SubmitReportOutput>;
+export declare function submitReportResponseFormatter(result: SubmitReportOutput): McpTextContent[];
+export declare const submitReportTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodEffects<z.ZodObject<{
+        entityId: z.ZodString;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        datePreset: z.ZodOptional<z.ZodString>;
+        timeRange: z.ZodOptional<z.ZodObject<{
+            since: z.ZodString;
+            until: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            since: string;
+            until: string;
+        }, {
+            since: string;
+            until: string;
+        }>>;
+        timeIncrement: z.ZodOptional<z.ZodString>;
+        level: z.ZodOptional<z.ZodString>;
+        breakdowns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        entityId: string;
+        fields?: string[] | undefined;
+        datePreset?: string | undefined;
+        level?: string | undefined;
+        breakdowns?: string[] | undefined;
+        timeRange?: {
+            since: string;
+            until: string;
+        } | undefined;
+        timeIncrement?: string | undefined;
+    }, {
+        entityId: string;
+        fields?: string[] | undefined;
+        datePreset?: string | undefined;
+        level?: string | undefined;
+        breakdowns?: string[] | undefined;
+        timeRange?: {
+            since: string;
+            until: string;
+        } | undefined;
+        timeIncrement?: string | undefined;
+    }>, {
+        entityId: string;
+        fields?: string[] | undefined;
+        datePreset?: string | undefined;
+        level?: string | undefined;
+        breakdowns?: string[] | undefined;
+        timeRange?: {
+            since: string;
+            until: string;
+        } | undefined;
+        timeIncrement?: string | undefined;
+    }, {
+        entityId: string;
+        fields?: string[] | undefined;
+        datePreset?: string | undefined;
+        level?: string | undefined;
+        breakdowns?: string[] | undefined;
+        timeRange?: {
+            since: string;
+            until: string;
+        } | undefined;
+        timeIncrement?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        reportRunId: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        reportRunId: string;
+        timestamp: string;
+    }, {
+        reportRunId: string;
+        timestamp: string;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            entityId: string;
+            datePreset: string;
+            level: string;
+            fields?: undefined;
+            timeRange?: undefined;
+            timeIncrement?: undefined;
+            breakdowns?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            entityId: string;
+            fields: string[];
+            timeRange: {
+                since: string;
+                until: string;
+            };
+            timeIncrement: string;
+            breakdowns: string[];
+            datePreset?: undefined;
+            level?: undefined;
+        };
+    })[];
+    logic: typeof submitReportLogic;
+    responseFormatter: typeof submitReportResponseFormatter;
+};
+export {};
+//# sourceMappingURL=submit-report.tool.d.ts.map

package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-report.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/submit-report.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAiBnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDqC,CAAC;AAE1E,eAAO,MAAM,wBAAwB;;;;;;;;;EAKE,CAAC;AAExC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAoB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC5B,CAAC"}

package/dist/mcp-server/tools/definitions/submit-report.tool.js

@@ -0,0 +1,131 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "meta_submit_report";
+const TOOL_TITLE = "Submit Meta Async Insights Report";
+const TOOL_DESCRIPTION = `Submit a Meta Ads async insights report without waiting for completion.
+
+Returns a \`reportRunId\` immediately. Use \`meta_check_report_status\` to poll for completion, then \`meta_download_report\` to fetch results.
+
+**Non-blocking workflow:**
+1. \`meta_submit_report\` → get \`reportRunId\`
+2. \`meta_check_report_status\` (repeat every 10s) → wait for "Job Succeeded"
+3. \`meta_download_report\` with the \`reportRunId\` → get parsed data
+
+**Status values:** "Job Not Started", "Job Started", "Job Running", "Job Succeeded", "Job Failed"
+
+Use \`meta_get_insights\` instead for a blocking convenience shortcut on smaller date ranges.`;
+export const SubmitReportInputSchema = z
+    .object({
+    entityId: z
+        .string()
+        .min(1)
+        .describe("Entity ID to get insights for (account act_XXX, campaign, ad set, or ad ID)"),
+    fields: z
+        .array(z.string())
+        .optional()
+        .describe("Metrics/fields to return (defaults to 12 core metrics)"),
+    datePreset: z
+        .string()
+        .optional()
+        .describe("Date preset (today, yesterday, last_7d, last_30d, etc.)"),
+    timeRange: z
+        .object({
+        since: z
+            .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+            .describe("Start date YYYY-MM-DD"),
+        until: z
+            .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format")
+            .describe("End date YYYY-MM-DD"),
+    })
+        .optional()
+        .describe("Custom date range (mutually exclusive with datePreset)"),
+    timeIncrement: z
+        .string()
+        .optional()
+        .describe("Time granularity: '1' for daily, '7' for weekly, 'monthly', 'all_days'"),
+    level: z
+        .string()
+        .optional()
+        .describe("Aggregation level: 'account', 'campaign', 'adset', 'ad'"),
+    breakdowns: z
+        .array(z.string())
+        .optional()
+        .describe("Breakdown dimensions (e.g., ['age', 'gender', 'country'])"),
+})
+    .superRefine((val, ctx) => {
+    if (val.datePreset && val.timeRange) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["timeRange"],
+            message: "Cannot specify both datePreset and timeRange",
+        });
+    }
+})
+    .describe("Parameters for submitting a Meta Ads async insights report");
+export const SubmitReportOutputSchema = z
+    .object({
+    reportRunId: z.string().describe("Report run ID for status polling and result download"),
+    timestamp: z.string().datetime(),
+})
+    .describe("Report submission result");
+export async function submitReportLogic(input, context, sdkContext) {
+    const { metaInsightsService } = resolveSessionServices(sdkContext);
+    const result = await metaInsightsService.submitInsightsReport(input.entityId, {
+        fields: input.fields,
+        datePreset: input.datePreset,
+        timeRange: input.timeRange,
+        timeIncrement: input.timeIncrement,
+        level: input.level,
+        breakdowns: input.breakdowns,
+    }, context);
+    return {
+        reportRunId: result.reportRunId,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function submitReportResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Report submitted: ${result.reportRunId}\n\nUse \`meta_check_report_status\` with this reportRunId to poll for completion.\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const submitReportTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: SubmitReportInputSchema,
+    outputSchema: SubmitReportOutputSchema,
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Submit last 30 days campaign performance report",
+            input: {
+                entityId: "act_123456789",
+                datePreset: "last_30d",
+                level: "campaign",
+            },
+        },
+        {
+            label: "Submit custom date range report with breakdowns",
+            input: {
+                entityId: "23456789012345",
+                fields: ["impressions", "clicks", "spend", "actions", "action_values"],
+                timeRange: { since: "2026-01-01", until: "2026-01-31" },
+                timeIncrement: "1",
+                breakdowns: ["age", "gender"],
+            },
+        },
+    ],
+    logic: submitReportLogic,
+    responseFormatter: submitReportResponseFormatter,
+};
+//# sourceMappingURL=submit-report.tool.js.map

package/dist/mcp-server/tools/definitions/submit-report.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-report.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/submit-report.tool.ts"],"names":[],"mappings":"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"}