@cesteral/linkedin-mcp 1.0.0

package/dist/mcp-server/tools/definitions/get-delivery-forecast.tool.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "linkedin_get_delivery_forecast";
+const TOOL_TITLE = "Get LinkedIn Ads Delivery Forecast";
+const TOOL_DESCRIPTION = `Get a delivery forecast for a targeting configuration on LinkedIn Ads.
+
+Returns estimated audience size, reach, and impressions for given targeting criteria.
+Use this to validate targeting before creating a campaign.
+
+**optimizationTargetType values:** NONE, WEBSITE_CONVERSIONS, LEAD_GENERATION, etc.`;
+export const GetDeliveryForecastInputSchema = z
+    .object({
+    adAccountUrn: z
+        .string()
+        .min(1)
+        .describe("The ad account URN (e.g., urn:li:sponsoredAccount:123)"),
+    targetingCriteria: z.record(z.any()).describe("LinkedIn targeting criteria object"),
+    optimizationTargetType: z
+        .string()
+        .optional()
+        .describe("Optimization target type for the forecast"),
+})
+    .describe("Parameters for getting a LinkedIn delivery forecast");
+export const GetDeliveryForecastOutputSchema = z
+    .object({
+    forecast: z.record(z.any()).describe("Forecast data from LinkedIn API"),
+    adAccountUrn: z.string(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Delivery forecast result");
+export async function getDeliveryForecastLogic(input, context, sdkContext) {
+    const { linkedInService } = resolveSessionServices(sdkContext);
+    const forecast = await linkedInService.getDeliveryForecast(input.adAccountUrn, input.targetingCriteria, input.optimizationTargetType, context);
+    return {
+        forecast: forecast,
+        adAccountUrn: input.adAccountUrn,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getDeliveryForecastResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Delivery forecast for ${result.adAccountUrn}\n\n${JSON.stringify(result.forecast, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const getDeliveryForecastTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetDeliveryForecastInputSchema,
+    outputSchema: GetDeliveryForecastOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Forecast for engineer audience in US",
+            input: {
+                adAccountUrn: "urn:li:sponsoredAccount:123456789",
+                targetingCriteria: {
+                    include: {
+                        and: [
+                            {
+                                or: {
+                                    "urn:li:adTargetingFacet:geos": ["urn:li:geo:103644278"],
+                                },
+                            },
+                            {
+                                or: {
+                                    "urn:li:adTargetingFacet:memberSeniorities": [
+                                        "urn:li:adSeniority:5",
+                                        "urn:li:adSeniority:6",
+                                    ],
+                                },
+                            },
+                        ],
+                    },
+                },
+            },
+        },
+    ],
+    logic: getDeliveryForecastLogic,
+    responseFormatter: getDeliveryForecastResponseFormatter,
+};
+//# sourceMappingURL=get-delivery-forecast.tool.js.map

package/dist/mcp-server/tools/definitions/get-delivery-forecast.tool.js.map

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

package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const GetEntityInputSchema: z.ZodObject<{
+    entityType: z.ZodEnum<[string, ...string[]]>;
+    entityUrn: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    entityUrn: string;
+}, {
+    entityType: string;
+    entityUrn: string;
+}>;
+export declare const GetEntityOutputSchema: z.ZodObject<{
+    entity: z.ZodRecord<z.ZodString, z.ZodAny>;
+    entityType: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entityType: string;
+    timestamp: string;
+    entity: Record<string, any>;
+}, {
+    entityType: string;
+    timestamp: string;
+    entity: Record<string, any>;
+}>;
+type GetEntityInput = z.infer<typeof GetEntityInputSchema>;
+type GetEntityOutput = z.infer<typeof GetEntityOutputSchema>;
+export declare function getEntityLogic(input: GetEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetEntityOutput>;
+export declare function getEntityResponseFormatter(result: GetEntityOutput): McpTextContent[];
+export declare const getEntityTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        entityType: z.ZodEnum<[string, ...string[]]>;
+        entityUrn: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        entityUrn: string;
+    }, {
+        entityType: string;
+        entityUrn: string;
+    }>;
+    outputSchema: z.ZodObject<{
+        entity: z.ZodRecord<z.ZodString, z.ZodAny>;
+        entityType: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityType: string;
+        timestamp: string;
+        entity: Record<string, any>;
+    }, {
+        entityType: string;
+        timestamp: string;
+        entity: Record<string, any>;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: {
+        label: string;
+        input: {
+            entityType: string;
+            entityUrn: string;
+        };
+    }[];
+    logic: typeof getEntityLogic;
+    responseFormatter: typeof getEntityResponseFormatter;
+};
+export {};
+//# sourceMappingURL=get-entity.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAUnD,eAAO,MAAM,oBAAoB;;;;;;;;;EAQ0B,CAAC;AAE5D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAMI,CAAC;AAEvC,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC3D,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7D,wBAAsB,cAAc,CAClC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,eAAe,CAAC,CAc1B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,EAAE,CAOpF;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BzB,CAAC"}

package/dist/mcp-server/tools/definitions/get-entity.tool.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+const TOOL_NAME = "linkedin_get_entity";
+const TOOL_TITLE = "Get LinkedIn Ads Entity";
+const TOOL_DESCRIPTION = `Get a single LinkedIn Ads entity by URN.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+**Important:** LinkedIn entity IDs are URNs like \`urn:li:sponsoredAccount:123\`.`;
+export const GetEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to retrieve"),
+    entityUrn: z
+        .string()
+        .min(1)
+        .describe("The entity URN to retrieve (e.g., urn:li:sponsoredAccount:123)"),
+})
+    .describe("Parameters for getting a LinkedIn Ads entity");
+export const GetEntityOutputSchema = z
+    .object({
+    entity: z.record(z.any()).describe("Retrieved entity data"),
+    entityType: z.string(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity retrieval result");
+export async function getEntityLogic(input, context, sdkContext) {
+    const { linkedInService } = resolveSessionServices(sdkContext);
+    const entity = await linkedInService.getEntity(input.entityType, input.entityUrn, context);
+    return {
+        entity: entity,
+        entityType: input.entityType,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getEntityResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `${result.entityType} retrieved\n${JSON.stringify(result.entity, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const getEntityTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetEntityInputSchema,
+    outputSchema: GetEntityOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Get a campaign by URN",
+            input: {
+                entityType: "campaign",
+                entityUrn: "urn:li:sponsoredCampaign:123456789",
+            },
+        },
+        {
+            label: "Get an ad account",
+            input: {
+                entityType: "adAccount",
+                entityUrn: "urn:li:sponsoredAccount:123456789",
+            },
+        },
+    ],
+    logic: getEntityLogic,
+    responseFormatter: getEntityResponseFormatter,
+};
+//# sourceMappingURL=get-entity.tool.js.map

package/dist/mcp-server/tools/definitions/get-entity.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAA2B,MAAM,4BAA4B,CAAC;AAIxF,MAAM,SAAS,GAAG,qBAAqB,CAAC;AACxC,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAC7C,MAAM,gBAAgB,GAAG;;8BAEK,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;;kFAEsB,CAAC;AAEnF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC9E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,gEAAgE,CAAC;CAC9E,CAAC;KACD,QAAQ,CAAC,8CAA8C,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC3D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAKvC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAqB,EACrB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,eAAe,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE/D,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,SAAS,CAC5C,KAAK,CAAC,UAAgC,EACtC,KAAK,CAAC,SAAS,EACf,OAAO,CACR,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,MAA4C;QACpD,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAuB;IAChE,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,GAAG,MAAM,CAAC,UAAU,eAAe,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACpH;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,qBAAqB;IACnC,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,uBAAuB;YAC9B,KAAK,EAAE;gBACL,UAAU,EAAE,UAAU;gBACtB,SAAS,EAAE,oCAAoC;aAChD;SACF;QACD;YACE,KAAK,EAAE,mBAAmB;YAC1B,KAAK,EAAE;gBACL,UAAU,EAAE,WAAW;gBACvB,SAAS,EAAE,mCAAmC;aAC/C;SACF;KACF;IACD,KAAK,EAAE,cAAc;IACrB,iBAAiB,EAAE,0BAA0B;CAC9C,CAAC"}

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

@@ -0,0 +1,81 @@
+import { z } from "zod";
+import type { RequestContext, McpTextContent } from "@cesteral/shared";
+import type { SdkContext } from "@cesteral/shared";
+export declare const GetTargetingOptionsInputSchema: z.ZodObject<{
+    adAccountUrn: z.ZodString;
+    facetType: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    adAccountUrn: string;
+    facetType?: string | undefined;
+}, {
+    adAccountUrn: string;
+    facetType?: string | undefined;
+}>;
+export declare const GetTargetingOptionsOutputSchema: z.ZodObject<{
+    options: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+    count: z.ZodNumber;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    options: Record<string, any>[];
+    count: number;
+    timestamp: string;
+}, {
+    options: Record<string, any>[];
+    count: number;
+    timestamp: string;
+}>;
+type GetTargetingOptionsInput = z.infer<typeof GetTargetingOptionsInputSchema>;
+type GetTargetingOptionsOutput = z.infer<typeof GetTargetingOptionsOutputSchema>;
+export declare function getTargetingOptionsLogic(input: GetTargetingOptionsInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetTargetingOptionsOutput>;
+export declare function getTargetingOptionsResponseFormatter(result: GetTargetingOptionsOutput): McpTextContent[];
+export declare const getTargetingOptionsTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        adAccountUrn: z.ZodString;
+        facetType: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        adAccountUrn: string;
+        facetType?: string | undefined;
+    }, {
+        adAccountUrn: string;
+        facetType?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        options: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
+        count: z.ZodNumber;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        options: Record<string, any>[];
+        count: number;
+        timestamp: string;
+    }, {
+        options: Record<string, any>[];
+        count: number;
+        timestamp: string;
+    }>;
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+        destructiveHint: boolean;
+    };
+    inputExamples: ({
+        label: string;
+        input: {
+            adAccountUrn: string;
+            facetType?: undefined;
+        };
+    } | {
+        label: string;
+        input: {
+            adAccountUrn: string;
+            facetType: string;
+        };
+    })[];
+    logic: typeof getTargetingOptionsLogic;
+    responseFormatter: typeof getTargetingOptionsResponseFormatter;
+};
+export {};
+//# sourceMappingURL=get-targeting-options.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-targeting-options.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-targeting-options.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;AASnD,eAAO,MAAM,8BAA8B;;;;;;;;;EAWqB,CAAC;AAEjE,eAAO,MAAM,+BAA+B;;;;;;;;;;;;EAML,CAAC;AAExC,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAC/E,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEjF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,yBAAyB,CAAC,CAgBpC;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,yBAAyB,GAChC,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BnC,CAAC"}

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

@@ -0,0 +1,76 @@
+import { z } from "zod";
+import { resolveSessionServices } from "../utils/resolve-session.js";
+const TOOL_NAME = "linkedin_get_targeting_options";
+const TOOL_TITLE = "Get LinkedIn Ads Targeting Options";
+const TOOL_DESCRIPTION = `Browse available targeting categories and facets for a LinkedIn Ads account.
+
+Returns targeting facet metadata available for the given ad account.
+Use linkedin_search_targeting to search within a specific facet.`;
+export const GetTargetingOptionsInputSchema = z
+    .object({
+    adAccountUrn: z
+        .string()
+        .min(1)
+        .describe("The ad account URN (e.g., urn:li:sponsoredAccount:123)"),
+    facetType: z
+        .string()
+        .optional()
+        .describe("Filter to a specific facet type (optional, returns all if omitted)"),
+})
+    .describe("Parameters for getting LinkedIn targeting options");
+export const GetTargetingOptionsOutputSchema = z
+    .object({
+    options: z.array(z.record(z.any())).describe("Available targeting options"),
+    count: z.number(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Targeting options result");
+export async function getTargetingOptionsLogic(input, context, sdkContext) {
+    const { linkedInService } = resolveSessionServices(sdkContext);
+    const result = (await linkedInService.getTargetingOptions(input.adAccountUrn, input.facetType, context));
+    const elements = result.elements ?? [];
+    return {
+        options: elements,
+        count: elements.length,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function getTargetingOptionsResponseFormatter(result) {
+    return [
+        {
+            type: "text",
+            text: `Found ${result.count} targeting options\n\n${JSON.stringify(result.options, null, 2)}\n\nTimestamp: ${result.timestamp}`,
+        },
+    ];
+}
+export const getTargetingOptionsTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: GetTargetingOptionsInputSchema,
+    outputSchema: GetTargetingOptionsOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+    inputExamples: [
+        {
+            label: "Get all targeting options for an account",
+            input: {
+                adAccountUrn: "urn:li:sponsoredAccount:123456789",
+            },
+        },
+        {
+            label: "Get interest targeting options",
+            input: {
+                adAccountUrn: "urn:li:sponsoredAccount:123456789",
+                facetType: "MEMBER_INTERESTS",
+            },
+        },
+    ],
+    logic: getTargetingOptionsLogic,
+    responseFormatter: getTargetingOptionsResponseFormatter,
+};
+//# sourceMappingURL=get-targeting-options.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-targeting-options.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-targeting-options.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,MAAM,SAAS,GAAG,gCAAgC,CAAC;AACnD,MAAM,UAAU,GAAG,oCAAoC,CAAC;AACxD,MAAM,gBAAgB,GAAG;;;iEAGwC,CAAC;AAElE,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC;KAC5C,MAAM,CAAC;IACN,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,wDAAwD,CAAC;IACrE,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oEAAoE,CAAC;CAClF,CAAC;KACD,QAAQ,CAAC,mDAAmD,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC;KAC7C,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,0BAA0B,CAAC,CAAC;AAKxC,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAA+B,EAC/B,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,eAAe,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE/D,MAAM,MAAM,GAAG,CAAC,MAAM,eAAe,CAAC,mBAAmB,CACvD,KAAK,CAAC,YAAY,EAClB,KAAK,CAAC,SAAS,EACf,OAAO,CACR,CAA4B,CAAC;IAE9B,MAAM,QAAQ,GAAI,MAAM,CAAC,QAAsB,IAAI,EAAE,CAAC;IAEtD,OAAO;QACL,OAAO,EAAE,QAAqC;QAC9C,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,MAAiC;IAEjC,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,SAAS,MAAM,CAAC,KAAK,yBAAyB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SAChI;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,8BAA8B;IAC3C,YAAY,EAAE,+BAA+B;IAC7C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,0CAA0C;YACjD,KAAK,EAAE;gBACL,YAAY,EAAE,mCAAmC;aAClD;SACF;QACD;YACE,KAAK,EAAE,gCAAgC;YACvC,KAAK,EAAE;gBACL,YAAY,EAAE,mCAAmC;gBACjD,SAAS,EAAE,kBAAkB;aAC9B;SACF;KACF;IACD,KAAK,EAAE,wBAAwB;IAC/B,iBAAiB,EAAE,oCAAoC;CACxD,CAAC"}

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -0,0 +1,23 @@
+export { listEntitiesTool } from "./list-entities.tool.js";
+export { getEntityTool } from "./get-entity.tool.js";
+export { createEntityTool } from "./create-entity.tool.js";
+export { updateEntityTool } from "./update-entity.tool.js";
+export { deleteEntityTool } from "./delete-entity.tool.js";
+export { listAdAccountsTool } from "./list-ad-accounts.tool.js";
+export { getAnalyticsTool } from "./get-analytics.tool.js";
+export { getAnalyticsBreakdownsTool } from "./get-analytics-breakdowns.tool.js";
+export { bulkUpdateStatusTool } from "./bulk-update-status.tool.js";
+export { bulkCreateEntitiesTool } from "./bulk-create-entities.tool.js";
+export { bulkUpdateEntitiesTool } from "./bulk-update-entities.tool.js";
+export { adjustBidsTool } from "./adjust-bids.tool.js";
+export { searchTargetingTool } from "./search-targeting.tool.js";
+export { getTargetingOptionsTool } from "./get-targeting-options.tool.js";
+export { duplicateEntityTool } from "./duplicate-entity.tool.js";
+export { getDeliveryForecastTool } from "./get-delivery-forecast.tool.js";
+export { getAdPreviewTool } from "./get-ad-preview.tool.js";
+export { validateEntityTool } from "./validate-entity.tool.js";
+export { uploadImageTool } from "./upload-image.tool.js";
+export { uploadVideoTool } from "./upload-video.tool.js";
+import { type ToolDefinitionForFactory } from "@cesteral/shared";
+export declare const allTools: ToolDefinitionForFactory[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAsBzD,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,kBAAkB,CAAC;AAsC1B,eAAO,MAAM,QAAQ,EAAE,wBAAwB,EAG9C,CAAC"}

package/dist/mcp-server/tools/definitions/index.js

@@ -0,0 +1,69 @@
+export { listEntitiesTool } from "./list-entities.tool.js";
+export { getEntityTool } from "./get-entity.tool.js";
+export { createEntityTool } from "./create-entity.tool.js";
+export { updateEntityTool } from "./update-entity.tool.js";
+export { deleteEntityTool } from "./delete-entity.tool.js";
+export { listAdAccountsTool } from "./list-ad-accounts.tool.js";
+export { getAnalyticsTool } from "./get-analytics.tool.js";
+export { getAnalyticsBreakdownsTool } from "./get-analytics-breakdowns.tool.js";
+export { bulkUpdateStatusTool } from "./bulk-update-status.tool.js";
+export { bulkCreateEntitiesTool } from "./bulk-create-entities.tool.js";
+export { bulkUpdateEntitiesTool } from "./bulk-update-entities.tool.js";
+export { adjustBidsTool } from "./adjust-bids.tool.js";
+export { searchTargetingTool } from "./search-targeting.tool.js";
+export { getTargetingOptionsTool } from "./get-targeting-options.tool.js";
+export { duplicateEntityTool } from "./duplicate-entity.tool.js";
+export { getDeliveryForecastTool } from "./get-delivery-forecast.tool.js";
+export { getAdPreviewTool } from "./get-ad-preview.tool.js";
+export { validateEntityTool } from "./validate-entity.tool.js";
+export { uploadImageTool } from "./upload-image.tool.js";
+export { uploadVideoTool } from "./upload-video.tool.js";
+import { listEntitiesTool } from "./list-entities.tool.js";
+import { getEntityTool } from "./get-entity.tool.js";
+import { createEntityTool } from "./create-entity.tool.js";
+import { updateEntityTool } from "./update-entity.tool.js";
+import { deleteEntityTool } from "./delete-entity.tool.js";
+import { listAdAccountsTool } from "./list-ad-accounts.tool.js";
+import { getAnalyticsTool } from "./get-analytics.tool.js";
+import { getAnalyticsBreakdownsTool } from "./get-analytics-breakdowns.tool.js";
+import { bulkUpdateStatusTool } from "./bulk-update-status.tool.js";
+import { bulkCreateEntitiesTool } from "./bulk-create-entities.tool.js";
+import { bulkUpdateEntitiesTool } from "./bulk-update-entities.tool.js";
+import { adjustBidsTool } from "./adjust-bids.tool.js";
+import { searchTargetingTool } from "./search-targeting.tool.js";
+import { getTargetingOptionsTool } from "./get-targeting-options.tool.js";
+import { duplicateEntityTool } from "./duplicate-entity.tool.js";
+import { getDeliveryForecastTool } from "./get-delivery-forecast.tool.js";
+import { getAdPreviewTool } from "./get-ad-preview.tool.js";
+import { validateEntityTool } from "./validate-entity.tool.js";
+import { uploadImageTool } from "./upload-image.tool.js";
+import { uploadVideoTool } from "./upload-video.tool.js";
+import { conformanceTools, createToolSearchTool, } from "@cesteral/shared";
+const productionTools = [
+    listEntitiesTool,
+    getEntityTool,
+    createEntityTool,
+    updateEntityTool,
+    deleteEntityTool,
+    listAdAccountsTool,
+    getAnalyticsTool,
+    getAnalyticsBreakdownsTool,
+    bulkUpdateStatusTool,
+    bulkCreateEntitiesTool,
+    bulkUpdateEntitiesTool,
+    adjustBidsTool,
+    searchTargetingTool,
+    getTargetingOptionsTool,
+    duplicateEntityTool,
+    getDeliveryForecastTool,
+    getAdPreviewTool,
+    uploadImageTool,
+    uploadVideoTool,
+    validateEntityTool,
+    createToolSearchTool({ platform: "linkedin", getTools: () => allTools }),
+];
+export const allTools = [
+    ...productionTools,
+    ...(process.env.MCP_INCLUDE_CONFORMANCE_TOOLS === "true" ? conformanceTools : []),
+];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/definitions/index.js.map

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