@cesteral/pinterest-mcp 1.0.0

package/dist/mcp-server/resources/definitions/entity-schemas.resource.js

@@ -0,0 +1,125 @@
+import { getSupportedEntityTypes, } from "../../tools/utils/entity-mapping.js";
+const ENTITY_SCHEMA_CONTENT = {
+    campaign: `# Pinterest Campaign Schema (v5)
+
+\`\`\`json
+{
+  "type": "object",
+  "required": ["name", "objective_type"],
+  "properties": {
+    "name": { "type": "string", "description": "Campaign name" },
+    "objective_type": {
+      "type": "string",
+      "enum": ["AWARENESS", "CONSIDERATION", "VIDEO_VIEW", "CATALOG_SALES", "CONVERSIONS", "APP_INSTALL", "SHOPPING"],
+      "description": "Campaign objective"
+    },
+    "status": { "type": "string", "enum": ["ACTIVE", "PAUSED", "ARCHIVED"], "default": "ACTIVE" },
+    "daily_spend_cap": { "type": "integer", "description": "Daily budget cap in micro-currency (1 USD = 1000000)" },
+    "lifetime_spend_cap": { "type": "integer", "description": "Total lifetime budget in micro-currency" }
+  }
+}
+\`\`\`
+
+## Notes
+- Budgets use **micro-currency**: $50/day → \`daily_spend_cap: 50000000\`
+- Status values: ACTIVE, PAUSED, ARCHIVED (not ENABLE/DISABLE)
+- Read-only fields: \`id\`, \`created_time\`, \`updated_time\`, \`ad_account_id\`
+`,
+    adGroup: `# Pinterest Ad Group Schema (v5)
+
+\`\`\`json
+{
+  "type": "object",
+  "required": ["name", "campaign_id", "budget_in_micro_currency"],
+  "properties": {
+    "name": { "type": "string" },
+    "campaign_id": { "type": "string" },
+    "status": { "type": "string", "enum": ["ACTIVE", "PAUSED", "ARCHIVED"] },
+    "budget_in_micro_currency": { "type": "integer", "description": "Budget in micro-currency (1 USD = 1000000)" },
+    "pacing_delivery_type": { "type": "string", "enum": ["STANDARD", "ACCELERATED"] },
+    "bid_strategy_type": { "type": "string", "enum": ["AUTOMATIC_BID", "MAX_BID", "TARGET_AVG_BID"] },
+    "targeting_spec": { "type": "object", "description": "Audience targeting configuration" },
+    "start_time": { "type": "string", "format": "date-time", "description": "ISO 8601 start datetime (e.g. 2026-04-01T00:00:00)" },
+    "end_time": { "type": "string", "format": "date-time", "description": "ISO 8601 end datetime" }
+  }
+}
+\`\`\`
+
+## targeting_spec fields
+| Field | Type | Description |
+|-------|------|-------------|
+| age_bucket | array | Age ranges: "18-24", "25-34", "35-44", "45-49", "50-54", "55-64", "65+" |
+| gender | array | "female", "male", "unknown" |
+| geo | array | Array of objects with \`country\` (ISO 2-letter code) |
+| interest | array | Interest keywords (e.g., "food", "fashion", "travel") |
+
+## Notes
+- Budget is per-ad-group in micro-currency
+- Read-only fields: \`id\`, \`created_time\`, \`updated_time\`
+`,
+    ad: `# Pinterest Ad Schema (v5)
+
+\`\`\`json
+{
+  "type": "object",
+  "required": ["name", "ad_group_id", "creative_type"],
+  "properties": {
+    "name": { "type": "string" },
+    "ad_group_id": { "type": "string" },
+    "status": { "type": "string", "enum": ["ACTIVE", "PAUSED", "ARCHIVED"] },
+    "creative_type": { "type": "string", "enum": ["REGULAR", "VIDEO", "SHOPPING", "CAROUSEL"] },
+    "pin_id": { "type": "string", "description": "ID of the Pinterest Pin to promote" }
+  }
+}
+\`\`\`
+
+## Notes
+- \`pin_id\` is required — create/upload the Pinterest Pin before creating the Ad
+- Creative types: REGULAR (static image), VIDEO, SHOPPING (product pin), CAROUSEL
+- Read-only fields: \`id\`, \`created_time\`, \`updated_time\`
+`,
+    creative: `# Pinterest Creative (Pin) Schema (v5)
+
+\`\`\`json
+{
+  "type": "object",
+  "required": ["title", "description"],
+  "properties": {
+    "title": { "type": "string" },
+    "description": { "type": "string" },
+    "link": { "type": "string", "description": "Destination URL" },
+    "media": { "type": "object", "description": "Media asset configuration" }
+  }
+}
+\`\`\`
+
+## Notes
+- A creative represents a Pinterest Pin that can be promoted as an ad
+- \`media\` object contains image or video asset references
+- Read-only fields: \`id\`, \`created_time\`, \`ad_account_id\`
+`,
+};
+function buildEntitySchemaMarkdown(entityType) {
+    return (ENTITY_SCHEMA_CONTENT[entityType] ??
+        `# Pinterest ${entityType}\n\nNo schema information available.\n`);
+}
+function buildAllSchemasMarkdown() {
+    return getSupportedEntityTypes()
+        .map((t) => ENTITY_SCHEMA_CONTENT[t])
+        .join("\n\n---\n\n");
+}
+export const entitySchemaResources = getSupportedEntityTypes().map((entityType) => ({
+    uri: `entity-schema://pinterest/${entityType}`,
+    name: `Pinterest ${entityType} Schema`,
+    description: `Field reference for Pinterest ${entityType} entity including required fields, optional fields, and read-only fields`,
+    mimeType: "text/markdown",
+    getContent: () => buildEntitySchemaMarkdown(entityType),
+}));
+export const entitySchemaAllResource = {
+    uri: "entity-schema://pinterest/all",
+    name: "Pinterest All Entity Schemas",
+    description: "Combined field reference for all Pinterest Ads entity types",
+    mimeType: "text/markdown",
+    getContent: buildAllSchemasMarkdown,
+};
+//# sourceMappingURL=entity-schemas.resource.js.map

package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-schemas.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-schemas.resource.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,uBAAuB,GAExB,MAAM,qCAAqC,CAAC;AAE7C,MAAM,qBAAqB,GAAwC;IACjE,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;CAwBX;IAEC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BV;IAEC,EAAE,EAAE;;;;;;;;;;;;;;;;;;;;CAoBL;IAEC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;CAmBX;CACA,CAAC;AAEF,SAAS,yBAAyB,CAAC,UAA+B;IAChE,OAAO,CACL,qBAAqB,CAAC,UAAU,CAAC;QACjC,eAAe,UAAU,wCAAwC,CAClE,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB;IAC9B,OAAO,uBAAuB,EAAE;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;SACpC,IAAI,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAe,uBAAuB,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC9F,GAAG,EAAE,6BAA6B,UAAU,EAAE;IAC9C,IAAI,EAAE,aAAa,UAAU,SAAS;IACtC,WAAW,EAAE,iCAAiC,UAAU,0EAA0E;IAClI,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CAAC,yBAAyB,CAAC,UAAU,CAAC;CACxD,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,GAAG,EAAE,+BAA+B;IACpC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,6DAA6D;IAC1E,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,uBAAuB;CACpC,CAAC"}

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

@@ -0,0 +1,7 @@
+export { entityHierarchyResource } from "./entity-hierarchy.resource.js";
+export { entitySchemaResources, entitySchemaAllResource } from "./entity-schemas.resource.js";
+export { entityExampleResources, entityExampleAllResource } from "./entity-examples.resource.js";
+export { reportingReferenceResource } from "./reporting-reference.resource.js";
+import type { Resource } from "../types.js";
+export declare const allResources: Resource[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAQ/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA2C5C,eAAO,MAAM,YAAY,EAAE,QAAQ,EASlC,CAAC"}

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

@@ -0,0 +1,58 @@
+export { entityHierarchyResource } from "./entity-hierarchy.resource.js";
+export { entitySchemaResources, entitySchemaAllResource } from "./entity-schemas.resource.js";
+export { entityExampleResources, entityExampleAllResource } from "./entity-examples.resource.js";
+export { reportingReferenceResource } from "./reporting-reference.resource.js";
+import { entityHierarchyResource } from "./entity-hierarchy.resource.js";
+import { entitySchemaResources, entitySchemaAllResource } from "./entity-schemas.resource.js";
+import { entityExampleResources, entityExampleAllResource } from "./entity-examples.resource.js";
+import { reportingReferenceResource } from "./reporting-reference.resource.js";
+import { allTools } from "../../tools/definitions/index.js";
+import { createToolExamplesResource, createServerCapabilitiesResource } from "@cesteral/shared";
+const toolExamplesResource = createToolExamplesResource(allTools, "pinterest-mcp");
+const serverCapabilitiesResource = createServerCapabilitiesResource({
+    serverName: "pinterest-mcp",
+    toolGroups: {
+        crud: [
+            "pinterest_list_entities",
+            "pinterest_get_entity",
+            "pinterest_create_entity",
+            "pinterest_update_entity",
+            "pinterest_delete_entity",
+        ],
+        account: ["pinterest_list_ad_accounts"],
+        reporting: [
+            "pinterest_get_report",
+            "pinterest_get_report_breakdowns",
+            "pinterest_submit_report",
+            "pinterest_check_report_status",
+            "pinterest_download_report",
+        ],
+        bulk: [
+            "pinterest_bulk_update_status",
+            "pinterest_bulk_create_entities",
+            "pinterest_bulk_update_entities",
+            "pinterest_adjust_bids",
+        ],
+        targeting: ["pinterest_search_targeting", "pinterest_get_targeting_options"],
+        specialized: [
+            "pinterest_duplicate_entity",
+            "pinterest_get_audience_estimate",
+            "pinterest_get_ad_preview",
+        ],
+        validation: ["pinterest_validate_entity"],
+        discovery: ["pinterest_search_tools"],
+    },
+    commonWorkflows: ["campaign_setup", "async_reporting", "audience_targeting"],
+    startHere: "pinterest_list_ad_accounts",
+});
+export const allResources = [
+    entityHierarchyResource,
+    entitySchemaAllResource,
+    ...entitySchemaResources,
+    entityExampleAllResource,
+    ...entityExampleResources,
+    reportingReferenceResource,
+    ...(toolExamplesResource ? [toolExamplesResource] : []),
+    serverCapabilitiesResource,
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAE/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAGhG,MAAM,oBAAoB,GAAG,0BAA0B,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;AACnF,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;IAClE,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,yBAAyB;YACzB,sBAAsB;YACtB,yBAAyB;YACzB,yBAAyB;YACzB,yBAAyB;SAC1B;QACD,OAAO,EAAE,CAAC,4BAA4B,CAAC;QACvC,SAAS,EAAE;YACT,sBAAsB;YACtB,iCAAiC;YACjC,yBAAyB;YACzB,+BAA+B;YAC/B,2BAA2B;SAC5B;QACD,IAAI,EAAE;YACJ,8BAA8B;YAC9B,gCAAgC;YAChC,gCAAgC;YAChC,uBAAuB;SACxB;QACD,SAAS,EAAE,CAAC,4BAA4B,EAAE,iCAAiC,CAAC;QAC5E,WAAW,EAAE;YACX,4BAA4B;YAC5B,iCAAiC;YACjC,0BAA0B;SAC3B;QACD,UAAU,EAAE,CAAC,2BAA2B,CAAC;QACzC,SAAS,EAAE,CAAC,wBAAwB,CAAC;KACtC;IACD,eAAe,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,CAAC;IAC5E,SAAS,EAAE,4BAA4B;CACxC,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,uBAAuB;IACvB,uBAAuB;IACvB,GAAG,qBAAqB;IACxB,wBAAwB;IACxB,GAAG,sBAAsB;IACzB,0BAA0B;IAC1B,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,oBAA2C,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,0BAAiD;CAClD,CAAC"}

package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts

@@ -0,0 +1,3 @@
+import type { Resource } from "../types.js";
+export declare const reportingReferenceResource: Resource;
+//# sourceMappingURL=reporting-reference.resource.d.ts.map

package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting-reference.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/reporting-reference.resource.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA6I5C,eAAO,MAAM,0BAA0B,EAAE,QAUxC,CAAC"}

package/dist/mcp-server/resources/definitions/reporting-reference.resource.js

@@ -0,0 +1,148 @@
+let cachedContent;
+function formatReportingReferenceMarkdown() {
+    return `# Pinterest Ads Reporting Reference
+
+## Report Types
+
+| Report Type | Description |
+|-------------|-------------|
+| BASIC | Standard delivery and performance metrics |
+| AUDIENCE | Audience breakdown metrics (requires audience dimensions) |
+| PLAYABLE_MATERIAL | Playable ad performance metrics |
+
+## Async Reporting Flow
+
+1. **Submit**: POST \`/v5/ad_accounts/{ad_account_id}/reports\` → get \`token\`
+2. **Poll**: GET \`/v5/ad_accounts/{ad_account_id}/reports/{token}\` → check \`status\`
+3. **Download**: GET the \`download_url\` when status = "FINISHED"
+
+Status values: FINISHED | FAILED
+
+Use \`pinterest_get_report\` or \`pinterest_get_report_breakdowns\` — these tools handle the full flow automatically.
+
+## Common Dimensions
+
+### Time Dimensions
+| Dimension | Description |
+|-----------|-------------|
+| stat_time_day | Daily breakdown (YYYY-MM-DD) |
+| stat_time_hour | Hourly breakdown |
+
+### Entity Dimensions
+| Dimension | Description |
+|-----------|-------------|
+| ad_account_id | Advertiser ID |
+| campaign_id | Campaign ID |
+| adgroup_id | Ad group ID |
+| ad_id | Ad ID |
+
+### Audience Dimensions (AUDIENCE report type)
+| Dimension | Description |
+|-----------|-------------|
+| gender | User gender breakdown |
+| age | User age group breakdown |
+| country_code | Country (ISO 2-letter code) |
+| province_id | Province/region ID |
+| platform | Operating system platform |
+| device_brand_id | Device brand |
+| interest_category | Interest category |
+| placement | Ad placement |
+| language | User language |
+
+## Common Metrics
+
+### Delivery Metrics
+| Metric | Description |
+|--------|-------------|
+| impressions | Total impressions |
+| reach | Unique users reached |
+| frequency | Average impressions per user |
+| clicks | Total clicks |
+| ctr | Click-through rate (%) |
+| cpm | Cost per mille (per 1000 impressions) |
+| cpc | Cost per click |
+| spend | Total amount spent |
+
+### Video Metrics
+| Metric | Description |
+|--------|-------------|
+| video_play_actions | Total video plays |
+| video_watched_2s | 2-second video views |
+| video_watched_6s | 6-second video views |
+| video_views_p25 | 25% video completion |
+| video_views_p50 | 50% video completion |
+| video_views_p75 | 75% video completion |
+| video_views_p100 | 100% completion (full views) |
+| average_video_play | Average play duration (seconds) |
+
+### Conversion Metrics
+| Metric | Description |
+|--------|-------------|
+| conversions | Total conversion events |
+| conversion_rate | Conversions / clicks (%) |
+| cost_per_conversion | Spend / conversions |
+| real_time_conversions | Real-time tracked conversions |
+| total_purchase_value | Total purchase value |
+| total_sales | Total sales count |
+| cost_per_1000_reached | CPM by unique reach |
+
+### Engagement Metrics
+| Metric | Description |
+|--------|-------------|
+| profile_visits | Profile page visits |
+| follows | New followers gained |
+| likes | Likes on ads |
+| comments | Comments on ads |
+| shares | Shares of ads |
+| engaged_view | Engaged views (6s+ or interaction) |
+
+## Example Report Configurations
+
+### Campaign Daily Delivery Report
+\`\`\`json
+{
+  "adAccountId": "1234567890",
+  "reportType": "BASIC",
+  "dimensions": ["campaign_id", "stat_time_day"],
+  "metrics": ["impressions", "clicks", "spend", "ctr", "cpc"],
+  "startDate": "2026-03-01",
+  "endDate": "2026-03-07"
+}
+\`\`\`
+
+### Ad Performance with Video Metrics
+\`\`\`json
+{
+  "adAccountId": "1234567890",
+  "reportType": "BASIC",
+  "dimensions": ["ad_id"],
+  "metrics": ["impressions", "spend", "video_play_actions", "video_views_p100", "average_video_play"],
+  "startDate": "2026-03-01",
+  "endDate": "2026-03-07"
+}
+\`\`\`
+
+### Country Breakdown Report
+\`\`\`json
+{
+  "adAccountId": "1234567890",
+  "dimensions": ["campaign_id", "stat_time_day"],
+  "breakdowns": ["country_code"],
+  "metrics": ["impressions", "clicks", "spend", "conversions"],
+  "startDate": "2026-03-01",
+  "endDate": "2026-03-07"
+}
+\`\`\`
+`;
+}
+export const reportingReferenceResource = {
+    uri: "reporting-reference://pinterest",
+    name: "Pinterest Reporting Reference",
+    description: "Available dimensions, metrics, report types, and example configurations for Pinterest Ads reporting",
+    mimeType: "text/markdown",
+    getContent: () => {
+        cachedContent ??= formatReportingReferenceMarkdown();
+        return cachedContent;
+    },
+};
+//# sourceMappingURL=reporting-reference.resource.js.map

package/dist/mcp-server/resources/definitions/reporting-reference.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting-reference.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/reporting-reference.resource.ts"],"names":[],"mappings":"AAQA,IAAI,aAAiC,CAAC;AAEtC,SAAS,gCAAgC;IACvC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqIR,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAa;IAClD,GAAG,EAAE,iCAAiC;IACtC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,qGAAqG;IACvG,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE;QACf,aAAa,KAAK,gCAAgC,EAAE,CAAC;QACrD,OAAO,aAAa,CAAC;IACvB,CAAC;CACF,CAAC"}

package/dist/mcp-server/resources/index.d.ts

@@ -0,0 +1,3 @@
+export type { Resource } from "./types.js";
+export { allResources } from "./definitions/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/resources/index.ts"],"names":[],"mappings":"AAOA,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/mcp-server/resources/index.js

@@ -0,0 +1,2 @@
+export { allResources } from "./definitions/index.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/resources/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/mcp-server/resources/types.d.ts

@@ -0,0 +1,8 @@
+export interface Resource {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    getContent: () => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp-server/resources/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/resources/types.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,QAAQ;IAEvB,GAAG,EAAE,MAAM,CAAC;IAEZ,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,EAAE,MAAM,CAAC;IAEpB,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,MAAM,CAAC;CAC1B"}

package/dist/mcp-server/resources/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp-server/resources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mcp-server/resources/types.ts"],"names":[],"mappings":""}

package/dist/mcp-server/server.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Logger } from "pino";
+export declare function createMcpServer(logger: Logger, sessionId?: string, gcsBucket?: string): Promise<McpServer>;
+export declare function runStdioServer(server: McpServer, logger: Logger): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp-server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAmBtF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAmCnC,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,CAAC,CAiIpB;AAKD,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrF"}

package/dist/mcp-server/server.js

@@ -0,0 +1,133 @@
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { allTools } from "./tools/index.js";
+import { allResources } from "./resources/index.js";
+import { promptRegistry } from "./prompts/index.js";
+import { createOperationContext } from "@cesteral/shared";
+import { reportCsvStore, sessionServiceStore } from "../services/session-services.js";
+import { extractZodShape, registerReportCsvResource, registerToolsFromDefinitions, registerPromptsFromDefinitions, registerStaticResourcesFromDefinitions, InteractionLogger, isConformanceFixturesEnabled, } from "@cesteral/shared";
+import packageJson from "../../package.json" with { type: "json" };
+const PINTEREST_PACKAGE_NAME = "pinterest-mcp";
+const PINTEREST_PLATFORM = "pinterest";
+const pinterestWorkflowIdByToolName = {
+    pinterest_list_entities: "mcp.execute.pinterest_entity_read",
+    pinterest_get_entity: "mcp.execute.pinterest_entity_read",
+    pinterest_list_ad_accounts: "mcp.execute.pinterest_entity_read",
+    pinterest_create_entity: "mcp.execute.pinterest_entity_update",
+    pinterest_update_entity: "mcp.execute.pinterest_entity_update",
+    pinterest_delete_entity: "mcp.execute.pinterest_entity_update",
+    pinterest_get_report: "mcp.execute.pinterest_reporting",
+    pinterest_get_report_breakdowns: "mcp.execute.pinterest_reporting",
+    pinterest_bulk_update_status: "mcp.execute.pinterest_bulk_operations",
+    pinterest_bulk_create_entities: "mcp.execute.pinterest_bulk_operations",
+    pinterest_bulk_update_entities: "mcp.execute.pinterest_bulk_operations",
+    pinterest_search_targeting: "mcp.execute.pinterest_entity_read",
+    pinterest_get_targeting_options: "mcp.execute.pinterest_entity_read",
+    pinterest_duplicate_entity: "mcp.execute.pinterest_entity_update",
+    pinterest_get_delivery_estimate: "mcp.execute.pinterest_entity_read",
+    pinterest_get_ad_preview: "mcp.execute.pinterest_entity_read",
+    pinterest_validate_entity: "mcp.execute.pinterest_entity_read",
+};
+export async function createMcpServer(logger, sessionId, gcsBucket) {
+    const server = new McpServer({
+        name: "pinterest-mcp",
+        version: packageJson.version,
+        description: "Pinterest Ads campaign management and reporting via Pinterest Marketing API v5. Supports campaign, ad group, ad, creative, and audience workflows with reporting, targeting, delivery estimates, and previews.",
+    }, {
+        capabilities: {
+            logging: {},
+        },
+        instructions: "Pinterest Ads campaign management and reporting server. Supports campaign, ad group, ad, creative, and audience workflows with async reporting, targeting, delivery estimates, and bulk operations via Pinterest Marketing API v5. " +
+            "Use pinterest_list_ad_accounts to discover accounts, pinterest_list_entities to browse entities. " +
+            "See MCP Resources for entity schemas and MCP Prompts for workflow guidance.",
+    });
+    const interactionLogger = new InteractionLogger({
+        serverName: PINTEREST_PACKAGE_NAME,
+        logger,
+        gcsBucket,
+    });
+    registerToolsFromDefinitions({
+        server,
+        tools: allTools,
+        logger,
+        sessionId,
+        transformSchema: (schema) => extractZodShape(schema),
+        createRequestContext: (params) => createOperationContext({
+            operation: params.operation,
+            additionalContext: params.additionalContext,
+        }),
+        defaultTextFormat: "compact",
+        packageName: PINTEREST_PACKAGE_NAME,
+        platform: PINTEREST_PLATFORM,
+        workflowIdByToolName: pinterestWorkflowIdByToolName,
+        interactionLogger,
+        authContextResolver: sessionId
+            ? () => sessionServiceStore.getAuthContext(sessionId)
+            : undefined,
+    });
+    registerStaticResourcesFromDefinitions({
+        server,
+        resources: allResources,
+        logger,
+    });
+    registerReportCsvResource({
+        server,
+        ResourceTemplate,
+        store: reportCsvStore,
+        platform: "Pinterest",
+        downloadToolName: "pinterest_download_report",
+        logger,
+    });
+    if (isConformanceFixturesEnabled()) {
+        const { conformanceResources, conformanceResourceTemplate, conformancePrompts } = await import("@cesteral/shared");
+        const { ResourceTemplate: McpResourceTemplate } = await import("@modelcontextprotocol/sdk/server/mcp.js");
+        registerStaticResourcesFromDefinitions({
+            server,
+            resources: conformanceResources,
+            logger,
+        });
+        const template = new McpResourceTemplate(conformanceResourceTemplate.uriTemplate, {
+            list: undefined,
+        });
+        server.registerResource("conformance_template", template, {
+            description: conformanceResourceTemplate.description,
+            mimeType: conformanceResourceTemplate.mimeType,
+        }, async (uri, variables) => {
+            const id = variables.id || "unknown";
+            const content = conformanceResourceTemplate.getContent(id);
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: conformanceResourceTemplate.mimeType,
+                        text: content,
+                    },
+                ],
+            };
+        });
+        registerPromptsFromDefinitions({
+            server: server,
+            prompts: conformancePrompts,
+            logger,
+        });
+    }
+    const allPrompts = Array.from(promptRegistry.values()).map((def) => ({
+        name: def.prompt.name,
+        description: def.prompt.description ?? "",
+        arguments: def.prompt.arguments,
+        generateMessage: def.generateMessage,
+    }));
+    registerPromptsFromDefinitions({
+        server: server,
+        prompts: allPrompts,
+        logger,
+    });
+    return server;
+}
+export async function runStdioServer(server, logger) {
+    logger.info("Starting MCP server with stdio transport");
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info("MCP server connected via stdio");
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp-server/server.js.map

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