@cesteral/linkedin-mcp 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (259) hide show
  1. package/LICENSE.md +201 -0
  2. package/README.md +304 -0
  3. package/dist/auth/index.d.ts +3 -0
  4. package/dist/auth/index.d.ts.map +1 -0
  5. package/dist/auth/index.js +3 -0
  6. package/dist/auth/index.js.map +1 -0
  7. package/dist/auth/linkedin-auth-adapter.d.ts +38 -0
  8. package/dist/auth/linkedin-auth-adapter.d.ts.map +1 -0
  9. package/dist/auth/linkedin-auth-adapter.js +110 -0
  10. package/dist/auth/linkedin-auth-adapter.js.map +1 -0
  11. package/dist/auth/linkedin-auth-strategy.d.ts +14 -0
  12. package/dist/auth/linkedin-auth-strategy.d.ts.map +1 -0
  13. package/dist/auth/linkedin-auth-strategy.js +50 -0
  14. package/dist/auth/linkedin-auth-strategy.js.map +1 -0
  15. package/dist/config/index.d.ts +100 -0
  16. package/dist/config/index.d.ts.map +1 -0
  17. package/dist/config/index.js +37 -0
  18. package/dist/config/index.js.map +1 -0
  19. package/dist/index.d.ts +3 -0
  20. package/dist/index.d.ts.map +1 -0
  21. package/dist/index.js +40 -0
  22. package/dist/index.js.map +1 -0
  23. package/dist/mcp-server/prompts/definitions/analytics-reporting-workflow.prompt.d.ts +4 -0
  24. package/dist/mcp-server/prompts/definitions/analytics-reporting-workflow.prompt.d.ts.map +1 -0
  25. package/dist/mcp-server/prompts/definitions/analytics-reporting-workflow.prompt.js +108 -0
  26. package/dist/mcp-server/prompts/definitions/analytics-reporting-workflow.prompt.js.map +1 -0
  27. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
  28. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
  29. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +177 -0
  30. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
  31. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
  32. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
  33. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +171 -0
  34. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
  35. package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts +4 -0
  36. package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts.map +1 -0
  37. package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js +109 -0
  38. package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js.map +1 -0
  39. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts +4 -0
  40. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts.map +1 -0
  41. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js +299 -0
  42. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js.map +1 -0
  43. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts +4 -0
  44. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts.map +1 -0
  45. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js +170 -0
  46. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js.map +1 -0
  47. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts +4 -0
  48. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts.map +1 -0
  49. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js +213 -0
  50. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js.map +1 -0
  51. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts +4 -0
  52. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts.map +1 -0
  53. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js +151 -0
  54. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js.map +1 -0
  55. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts +4 -0
  56. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts.map +1 -0
  57. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js +217 -0
  58. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js.map +1 -0
  59. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts +4 -0
  60. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts.map +1 -0
  61. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js +98 -0
  62. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js.map +1 -0
  63. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
  64. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
  65. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +91 -0
  66. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
  67. package/dist/mcp-server/prompts/index.d.ts +9 -0
  68. package/dist/mcp-server/prompts/index.d.ts.map +1 -0
  69. package/dist/mcp-server/prompts/index.js +97 -0
  70. package/dist/mcp-server/prompts/index.js.map +1 -0
  71. package/dist/mcp-server/resources/definitions/analytics-reference.resource.d.ts +3 -0
  72. package/dist/mcp-server/resources/definitions/analytics-reference.resource.d.ts.map +1 -0
  73. package/dist/mcp-server/resources/definitions/analytics-reference.resource.js +162 -0
  74. package/dist/mcp-server/resources/definitions/analytics-reference.resource.js.map +1 -0
  75. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
  76. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
  77. package/dist/mcp-server/resources/definitions/entity-examples.resource.js +164 -0
  78. package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
  79. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
  80. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
  81. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +144 -0
  82. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
  83. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
  84. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
  85. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +127 -0
  86. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
  87. package/dist/mcp-server/resources/definitions/index.d.ts +8 -0
  88. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  89. package/dist/mcp-server/resources/definitions/index.js +54 -0
  90. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  91. package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts +3 -0
  92. package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts.map +1 -0
  93. package/dist/mcp-server/resources/definitions/targeting-reference.resource.js +122 -0
  94. package/dist/mcp-server/resources/definitions/targeting-reference.resource.js.map +1 -0
  95. package/dist/mcp-server/resources/index.d.ts +3 -0
  96. package/dist/mcp-server/resources/index.d.ts.map +1 -0
  97. package/dist/mcp-server/resources/index.js +2 -0
  98. package/dist/mcp-server/resources/index.js.map +1 -0
  99. package/dist/mcp-server/resources/types.d.ts +8 -0
  100. package/dist/mcp-server/resources/types.d.ts.map +1 -0
  101. package/dist/mcp-server/resources/types.js +2 -0
  102. package/dist/mcp-server/resources/types.js.map +1 -0
  103. package/dist/mcp-server/server.d.ts +5 -0
  104. package/dist/mcp-server/server.d.ts.map +1 -0
  105. package/dist/mcp-server/server.js +128 -0
  106. package/dist/mcp-server/server.js.map +1 -0
  107. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +213 -0
  108. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
  109. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +174 -0
  110. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
  111. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +128 -0
  112. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
  113. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +95 -0
  114. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
  115. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +183 -0
  116. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
  117. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +122 -0
  118. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
  119. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +140 -0
  120. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
  121. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +109 -0
  122. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
  123. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +117 -0
  124. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
  125. package/dist/mcp-server/tools/definitions/create-entity.tool.js +98 -0
  126. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
  127. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +93 -0
  128. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
  129. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +100 -0
  130. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
  131. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +95 -0
  132. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
  133. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +89 -0
  134. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
  135. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +75 -0
  136. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
  137. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +68 -0
  138. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
  139. package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts +75 -0
  140. package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts.map +1 -0
  141. package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js +71 -0
  142. package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js.map +1 -0
  143. package/dist/mcp-server/tools/definitions/get-analytics-breakdowns.tool.d.ts +223 -0
  144. package/dist/mcp-server/tools/definitions/get-analytics-breakdowns.tool.d.ts.map +1 -0
  145. package/dist/mcp-server/tools/definitions/get-analytics-breakdowns.tool.js +152 -0
  146. package/dist/mcp-server/tools/definitions/get-analytics-breakdowns.tool.js.map +1 -0
  147. package/dist/mcp-server/tools/definitions/get-analytics.tool.d.ts +325 -0
  148. package/dist/mcp-server/tools/definitions/get-analytics.tool.d.ts.map +1 -0
  149. package/dist/mcp-server/tools/definitions/get-analytics.tool.js +154 -0
  150. package/dist/mcp-server/tools/definitions/get-analytics.tool.js.map +1 -0
  151. package/dist/mcp-server/tools/definitions/get-delivery-forecast.tool.d.ts +95 -0
  152. package/dist/mcp-server/tools/definitions/get-delivery-forecast.tool.d.ts.map +1 -0
  153. package/dist/mcp-server/tools/definitions/get-delivery-forecast.tool.js +90 -0
  154. package/dist/mcp-server/tools/definitions/get-delivery-forecast.tool.js.map +1 -0
  155. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +75 -0
  156. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
  157. package/dist/mcp-server/tools/definitions/get-entity.tool.js +75 -0
  158. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
  159. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +81 -0
  160. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
  161. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +76 -0
  162. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
  163. package/dist/mcp-server/tools/definitions/index.d.ts +23 -0
  164. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  165. package/dist/mcp-server/tools/definitions/index.js +69 -0
  166. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  167. package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts +141 -0
  168. package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts.map +1 -0
  169. package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js +84 -0
  170. package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js.map +1 -0
  171. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +165 -0
  172. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
  173. package/dist/mcp-server/tools/definitions/list-entities.tool.js +112 -0
  174. package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
  175. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +102 -0
  176. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -0
  177. package/dist/mcp-server/tools/definitions/search-targeting.tool.js +98 -0
  178. package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
  179. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +104 -0
  180. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
  181. package/dist/mcp-server/tools/definitions/update-entity.tool.js +88 -0
  182. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
  183. package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts +75 -0
  184. package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts.map +1 -0
  185. package/dist/mcp-server/tools/definitions/upload-image.tool.js +99 -0
  186. package/dist/mcp-server/tools/definitions/upload-image.tool.js.map +1 -0
  187. package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts +69 -0
  188. package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts.map +1 -0
  189. package/dist/mcp-server/tools/definitions/upload-video.tool.js +98 -0
  190. package/dist/mcp-server/tools/definitions/upload-video.tool.js.map +1 -0
  191. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +168 -0
  192. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
  193. package/dist/mcp-server/tools/definitions/validate-entity.tool.js +200 -0
  194. package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
  195. package/dist/mcp-server/tools/index.d.ts +2 -0
  196. package/dist/mcp-server/tools/index.d.ts.map +1 -0
  197. package/dist/mcp-server/tools/index.js +2 -0
  198. package/dist/mcp-server/tools/index.js.map +1 -0
  199. package/dist/mcp-server/tools/utils/entity-mapping.d.ts +13 -0
  200. package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
  201. package/dist/mcp-server/tools/utils/entity-mapping.js +68 -0
  202. package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
  203. package/dist/mcp-server/tools/utils/media-types.d.ts +12 -0
  204. package/dist/mcp-server/tools/utils/media-types.d.ts.map +1 -0
  205. package/dist/mcp-server/tools/utils/media-types.js +2 -0
  206. package/dist/mcp-server/tools/utils/media-types.js.map +1 -0
  207. package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
  208. package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
  209. package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
  210. package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
  211. package/dist/mcp-server/transports/streamable-http-transport.d.ts +49 -0
  212. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
  213. package/dist/mcp-server/transports/streamable-http-transport.js +91 -0
  214. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
  215. package/dist/services/linkedin/linkedin-http-client.d.ts +20 -0
  216. package/dist/services/linkedin/linkedin-http-client.d.ts.map +1 -0
  217. package/dist/services/linkedin/linkedin-http-client.js +147 -0
  218. package/dist/services/linkedin/linkedin-http-client.js.map +1 -0
  219. package/dist/services/linkedin/linkedin-reporting-service.d.ts +26 -0
  220. package/dist/services/linkedin/linkedin-reporting-service.d.ts.map +1 -0
  221. package/dist/services/linkedin/linkedin-reporting-service.js +69 -0
  222. package/dist/services/linkedin/linkedin-reporting-service.js.map +1 -0
  223. package/dist/services/linkedin/linkedin-service.d.ts +84 -0
  224. package/dist/services/linkedin/linkedin-service.d.ts.map +1 -0
  225. package/dist/services/linkedin/linkedin-service.js +195 -0
  226. package/dist/services/linkedin/linkedin-service.js.map +1 -0
  227. package/dist/services/linkedin/types.d.ts +166 -0
  228. package/dist/services/linkedin/types.d.ts.map +1 -0
  229. package/dist/services/linkedin/types.js +31 -0
  230. package/dist/services/linkedin/types.js.map +1 -0
  231. package/dist/services/session-services.d.ts +18 -0
  232. package/dist/services/session-services.d.ts.map +1 -0
  233. package/dist/services/session-services.js +16 -0
  234. package/dist/services/session-services.js.map +1 -0
  235. package/dist/types-global/mcp.d.ts +2 -0
  236. package/dist/types-global/mcp.d.ts.map +1 -0
  237. package/dist/types-global/mcp.js +2 -0
  238. package/dist/types-global/mcp.js.map +1 -0
  239. package/dist/utils/errors/index.d.ts +2 -0
  240. package/dist/utils/errors/index.d.ts.map +1 -0
  241. package/dist/utils/errors/index.js +2 -0
  242. package/dist/utils/errors/index.js.map +1 -0
  243. package/dist/utils/platform.d.ts +3 -0
  244. package/dist/utils/platform.d.ts.map +1 -0
  245. package/dist/utils/platform.js +5 -0
  246. package/dist/utils/platform.js.map +1 -0
  247. package/dist/utils/security/rate-limiter.d.ts +3 -0
  248. package/dist/utils/security/rate-limiter.d.ts.map +1 -0
  249. package/dist/utils/security/rate-limiter.js +5 -0
  250. package/dist/utils/security/rate-limiter.js.map +1 -0
  251. package/dist/utils/telemetry/index.d.ts +2 -0
  252. package/dist/utils/telemetry/index.d.ts.map +1 -0
  253. package/dist/utils/telemetry/index.js +2 -0
  254. package/dist/utils/telemetry/index.js.map +1 -0
  255. package/dist/utils/telemetry/tracing.d.ts +3 -0
  256. package/dist/utils/telemetry/tracing.d.ts.map +1 -0
  257. package/dist/utils/telemetry/tracing.js +4 -0
  258. package/dist/utils/telemetry/tracing.js.map +1 -0
  259. package/package.json +55 -0
@@ -0,0 +1,171 @@
1
+ export const linkedInCampaignSetupWorkflowPrompt = {
2
+ name: "linkedin_campaign_setup_workflow",
3
+ description: "Step-by-step guide for creating a complete LinkedIn Ads campaign structure (Campaign Group > Campaign > Creative)",
4
+ arguments: [
5
+ {
6
+ name: "adAccountUrn",
7
+ description: "LinkedIn Ad Account URN (e.g., urn:li:sponsoredAccount:123456789)",
8
+ required: true,
9
+ },
10
+ {
11
+ name: "includeTargeting",
12
+ description: "Whether to include targeting setup steps (true/false)",
13
+ required: false,
14
+ },
15
+ ],
16
+ };
17
+ export function getLinkedInCampaignSetupWorkflowMessage(args) {
18
+ const adAccountUrn = args?.adAccountUrn || "{adAccountUrn}";
19
+ const includeTargeting = args?.includeTargeting !== "false";
20
+ return `# LinkedIn Campaign Setup Workflow
21
+
22
+ ## Prerequisites
23
+ - Ad Account URN: \`${adAccountUrn}\`
24
+ - Verify account access: \`linkedin_list_ad_accounts\`
25
+ - Check entity hierarchy: fetch resource \`entity-hierarchy://linkedin/all\`
26
+
27
+ ## Step 1: Create Campaign Group
28
+
29
+ Campaign groups organize related campaigns and can share a budget cap.
30
+
31
+ \`\`\`json
32
+ linkedin_create_entity({
33
+ "entityType": "campaignGroup",
34
+ "data": {
35
+ "name": "Q2 2026 Brand Campaign",
36
+ "account": "${adAccountUrn}",
37
+ "status": "DRAFT",
38
+ "totalBudget": { "amount": "10000.00", "currencyCode": "USD" },
39
+ "runSchedule": {
40
+ "start": 1746057600000,
41
+ "end": 1753833600000
42
+ }
43
+ }
44
+ })
45
+ \`\`\`
46
+
47
+ **Save the returned campaign group URN:** \`urn:li:sponsoredCampaignGroup:XXXXXXXXX\`
48
+
49
+ ## Step 2: Create Campaign
50
+
51
+ \`\`\`json
52
+ linkedin_create_entity({
53
+ "entityType": "campaign",
54
+ "data": {
55
+ "name": "Brand Awareness - Tech Leaders",
56
+ "campaignGroup": "urn:li:sponsoredCampaignGroup:XXXXXXXXX",
57
+ "account": "${adAccountUrn}",
58
+ "type": "SPONSORED_UPDATES",
59
+ "objectiveType": "BRAND_AWARENESS",
60
+ "status": "DRAFT",
61
+ "dailyBudget": { "amount": "100.00", "currencyCode": "USD" },
62
+ "bidType": "CPM",
63
+ "unitCost": { "amount": "12.00", "currencyCode": "USD" },
64
+ "locale": { "country": "US", "language": "en" }
65
+ }
66
+ })
67
+ \`\`\`
68
+
69
+ **Campaign Types:** SPONSORED_UPDATES, TEXT_AD, DYNAMIC, VIDEO, CAROUSEL
70
+
71
+ **Objective Types:** BRAND_AWARENESS, WEBSITE_TRAFFIC, WEBSITE_CONVERSIONS,
72
+ LEAD_GENERATION, ENGAGEMENT, VIDEO_VIEWS
73
+ ${includeTargeting
74
+ ? `
75
+ ## Step 3: Add Targeting
76
+
77
+ Add targeting criteria to the campaign via update:
78
+
79
+ \`\`\`json
80
+ linkedin_update_entity({
81
+ "entityType": "campaign",
82
+ "entityUrn": "urn:li:sponsoredCampaign:XXXXXXXXX",
83
+ "data": {
84
+ "targetingCriteria": {
85
+ "include": {
86
+ "and": [
87
+ {
88
+ "or": {
89
+ "urn:li:adTargetingFacet:geos": ["urn:li:geo:103644278"]
90
+ }
91
+ },
92
+ {
93
+ "or": {
94
+ "urn:li:adTargetingFacet:memberSeniorities": [
95
+ "urn:li:adSeniority:5",
96
+ "urn:li:adSeniority:6"
97
+ ]
98
+ }
99
+ }
100
+ ]
101
+ }
102
+ }
103
+ }
104
+ })
105
+ \`\`\`
106
+
107
+ To find targeting URNs, use: \`linkedin_search_targeting({ facetType: "MEMBER_SENIORITY" })\`
108
+
109
+ **Get audience size forecast:**
110
+ \`\`\`json
111
+ linkedin_get_delivery_forecast({
112
+ "adAccountUrn": "${adAccountUrn}",
113
+ "targetingCriteria": { ... }
114
+ })
115
+ \`\`\`
116
+ `
117
+ : ""}
118
+ ## Step 4: Create Creative
119
+
120
+ Creative links your content (UGC post, share, etc.) to the campaign.
121
+
122
+ \`\`\`json
123
+ linkedin_create_entity({
124
+ "entityType": "creative",
125
+ "data": {
126
+ "campaign": "urn:li:sponsoredCampaign:XXXXXXXXX",
127
+ "status": "DRAFT",
128
+ "reference": "urn:li:ugcPost:YOUR_UGC_POST_ID"
129
+ }
130
+ })
131
+ \`\`\`
132
+
133
+ **Reference formats:**
134
+ - Organic post: \`urn:li:ugcPost:{postId}\`
135
+ - Share: \`urn:li:share:{shareId}\`
136
+
137
+ ## Step 5: Verify & Activate
138
+
139
+ 1. Validate payloads: \`linkedin_validate_entity\`
140
+ 2. Preview creative: \`linkedin_get_ad_preview({ creativeUrn: "..." })\`
141
+ 3. Review all entities:
142
+ - Campaign group: \`linkedin_get_entity({ entityType: "campaignGroup", entityUrn: "..." })\`
143
+ - Campaign: \`linkedin_get_entity({ entityType: "campaign", entityUrn: "..." })\`
144
+ - Creative: \`linkedin_get_entity({ entityType: "creative", entityUrn: "..." })\`
145
+ 4. Activate: \`linkedin_bulk_update_status\` to set ACTIVE
146
+
147
+ ## Common Gotchas
148
+
149
+ | Issue | Solution |
150
+ |-------|----------|
151
+ | Budget in wrong format | Use CurrencyAmount: \`{ "amount": "100.00", "currencyCode": "USD" }\` |
152
+ | Invalid URN format | All IDs must start with \`urn:li:\` |
153
+ | Campaign not serving | Check campaign status is ACTIVE, not DRAFT |
154
+ | Creative review pending | Allow 24-48h for LinkedIn creative review |
155
+ | Missing targeting | Campaigns without targeting may have limited delivery |
156
+
157
+ ## Analytics After Launch
158
+
159
+ \`\`\`json
160
+ linkedin_get_analytics({
161
+ "adAccountUrn": "${adAccountUrn}",
162
+ "startDate": "2026-03-01",
163
+ "endDate": "2026-03-31",
164
+ "metrics": ["impressions", "clicks", "costInUsd", "conversions"],
165
+ "pivot": "CAMPAIGN",
166
+ "timeGranularity": "DAILY"
167
+ })
168
+ \`\`\`
169
+ `;
170
+ }
171
+ //# sourceMappingURL=campaign-setup-workflow.prompt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"campaign-setup-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,mCAAmC,GAAW;IACzD,IAAI,EAAE,kCAAkC;IACxC,WAAW,EACT,mHAAmH;IACrH,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,mEAAmE;YAChF,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,uDAAuD;YACpE,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,uCAAuC,CAAC,IAA6B;IACnF,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAC5D,MAAM,gBAAgB,GAAG,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC;IAE5D,OAAO;;;sBAGa,YAAY;;;;;;;;;;;;;kBAahB,YAAY;;;;;;;;;;;;;;;;;;;;;kBAqBZ,YAAY;;;;;;;;;;;;;;;;EAiB5B,gBAAgB;QACd,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsCe,YAAY;;;;CAIhC;QACG,CAAC,CAAC,EACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA4CqB,YAAY;;;;;;;;CAQhC,CAAC;AACF,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
2
+ export declare const linkedInCreativeUploadWorkflowPrompt: Prompt;
3
+ export declare function getLinkedInCreativeUploadWorkflowMessage(args?: Record<string, string>): string;
4
+ //# sourceMappingURL=creative-upload-workflow.prompt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creative-upload-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/creative-upload-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,oCAAoC,EAAE,MAWlD,CAAC;AAEF,wBAAgB,wCAAwC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAiG9F"}
@@ -0,0 +1,109 @@
1
+ export const linkedInCreativeUploadWorkflowPrompt = {
2
+ name: "creative_upload_workflow",
3
+ description: "Step-by-step guide for uploading images and creating LinkedIn Sponsored Content creatives",
4
+ arguments: [
5
+ {
6
+ name: "adAccountUrn",
7
+ description: "LinkedIn Ad Account URN (e.g., urn:li:sponsoredAccount:123456)",
8
+ required: true,
9
+ },
10
+ ],
11
+ };
12
+ export function getLinkedInCreativeUploadWorkflowMessage(args) {
13
+ const adAccountUrn = args?.adAccountUrn || "{adAccountUrn}";
14
+ return `# LinkedIn Ads Creative Upload Workflow
15
+
16
+ ## Prerequisites
17
+ - Ad Account URN: \`${adAccountUrn}\`
18
+ - Organization URN for your company page (e.g., urn:li:organization:123456)
19
+
20
+ ## Overview
21
+ LinkedIn creative workflow: Upload image → Create Creative → Link to Campaign
22
+
23
+ ---
24
+
25
+ ## Step 1: Upload Image
26
+
27
+ \`\`\`json
28
+ linkedin_upload_image({
29
+ "adAccountUrn": "${adAccountUrn}",
30
+ "mediaUrl": "https://example.com/your-banner.jpg"
31
+ })
32
+ \`\`\`
33
+
34
+ **Returns:** \`assetUrn\` (format: urn:li:digitalmediaAsset:...)
35
+
36
+ ⚠️ **GOTCHA**: LinkedIn processes assets asynchronously. The assetUrn is returned immediately but may take 1-5 minutes to be fully available for creative creation. If creative creation fails with "ASSET_NOT_READY", wait and retry.
37
+
38
+ **Image requirements:**
39
+ - Formats: JPEG, PNG, GIF
40
+ - Min 400x400px; recommended 1200x627px (1.91:1 ratio)
41
+ - Max 5MB
42
+ - Aspect ratios accepted: 1.91:1 (horizontal), 1:1 (square), 2:3 (vertical)
43
+
44
+ ## Step 2: Create Creative
45
+
46
+ \`\`\`json
47
+ linkedin_create_entity({
48
+ "entityType": "creative",
49
+ "data": {
50
+ "account": "${adAccountUrn}",
51
+ "campaign": "{your_campaign_urn}",
52
+ "content": {
53
+ "contentType": "SPONSORED_IMAGE",
54
+ "media": {
55
+ "id": "{assetUrn_from_step_1}",
56
+ "headline": "Your Headline Here",
57
+ "description": "Your ad description",
58
+ "callToAction": "LEARN_MORE",
59
+ "landingPage": "https://yoursite.com"
60
+ }
61
+ },
62
+ "status": "DRAFT",
63
+ "type": "SPONSORED"
64
+ }
65
+ })
66
+ \`\`\`
67
+
68
+ ⚠️ **GOTCHA**: Creative must be created in DRAFT status. Move to ACTIVE only after review.
69
+
70
+ ## Step 3: Preview Creative
71
+
72
+ \`\`\`json
73
+ linkedin_get_ad_preview({
74
+ "creativeUrn": "{creativeUrn_from_step_2}",
75
+ "adFormat": "SPONSORED_IMAGE"
76
+ })
77
+ \`\`\`
78
+
79
+ ## Step 4: Activate Creative
80
+
81
+ \`\`\`json
82
+ linkedin_update_entity({
83
+ "entityType": "creative",
84
+ "entityUrn": "{creativeUrn}",
85
+ "data": { "status": "ACTIVE" }
86
+ })
87
+ \`\`\`
88
+
89
+ ## Common Errors
90
+
91
+ | Error | Cause | Fix |
92
+ |-------|-------|-----|
93
+ | "ASSET_NOT_READY" | Asset still processing | Wait 1-5 min, retry |
94
+ | "INVALID_ASPECT_RATIO" | Wrong image ratio | Use 1.91:1, 1:1, or 2:3 |
95
+ | "MISSING_ORGANIZATION" | No org page linked | Link organization to ad account |
96
+ | "CAMPAIGN_NOT_FOUND" | Wrong campaign URN | Verify using linkedin_list_entities |
97
+
98
+ ## Common Call-to-Action Values
99
+ LEARN_MORE, SIGN_UP, REGISTER, JOIN_NOW, REQUEST_DEMO, TRY_FREE, CONTACT_US, GET_QUOTE, APPLY_NOW, DOWNLOAD
100
+
101
+ ## Success Criteria
102
+ - [ ] Image uploaded (assetUrn obtained)
103
+ - [ ] Creative created in DRAFT status
104
+ - [ ] Preview reviewed
105
+ - [ ] Creative activated when ready
106
+
107
+ `;
108
+ }
109
+ //# sourceMappingURL=creative-upload-workflow.prompt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creative-upload-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/creative-upload-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,oCAAoC,GAAW;IAC1D,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACT,2FAA2F;IAC7F,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,gEAAgE;YAC7E,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,wCAAwC,CAAC,IAA6B;IACpF,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAE5D,OAAO;;;sBAGa,YAAY;;;;;;;;;;;;qBAYb,YAAY;;;;;;;;;;;;;;;;;;;;;kBAqBf,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyD7B,CAAC;AACF,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
2
+ export declare const crossPlatformCampaignSetupPrompt: Prompt;
3
+ export declare function getCrossPlatformCampaignSetupMessage(args?: Record<string, string>): string;
4
+ //# sourceMappingURL=cross-platform-campaign-setup.prompt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cross-platform-campaign-setup.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE,eAAO,MAAM,gCAAgC,EAAE,MAiB9C,CAAC;AAEF,wBAAgB,oCAAoC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA0R1F"}
@@ -0,0 +1,299 @@
1
+ export const crossPlatformCampaignSetupPrompt = {
2
+ name: "cross_platform_campaign_setup",
3
+ description: "Guide for setting up a coordinated multi-platform campaign across DV360 (dv360-mcp), The Trade Desk (ttd-mcp), Google Ads (gads-mcp), Meta Ads (meta-mcp), LinkedIn (linkedin-mcp), TikTok (tiktok-mcp), Pinterest (pinterest-mcp), Snapchat (snapchat-mcp), and Amazon DSP (amazon-dsp-mcp). Covers platform selection, budget allocation, naming conventions, and phased launch.",
4
+ arguments: [
5
+ {
6
+ name: "totalBudget",
7
+ description: "Total campaign budget across all platforms (e.g., '50000' for $50,000)",
8
+ required: false,
9
+ },
10
+ {
11
+ name: "objective",
12
+ description: "Campaign objective: 'awareness', 'consideration', or 'conversion' (default: conversion)",
13
+ required: false,
14
+ },
15
+ ],
16
+ };
17
+ export function getCrossPlatformCampaignSetupMessage(args) {
18
+ const totalBudget = args?.totalBudget || "{totalBudget}";
19
+ const objective = args?.objective || "conversion";
20
+ return `# Cross-Platform Coordinated Campaign Setup
21
+
22
+ Total Budget: \$${totalBudget}
23
+ Objective: \`${objective}\`
24
+
25
+ This workflow guides you through setting up campaigns across multiple ad platforms in a coordinated manner. You must be connected to the relevant MCP servers.
26
+
27
+ ---
28
+
29
+ ## Step 1: Platform Selection
30
+
31
+ Choose platforms based on your objective and audience:
32
+
33
+ | Objective | Recommended Platforms | Rationale |
34
+ |-----------|----------------------|-----------|
35
+ | **Awareness** | DV360 + Meta + TikTok + Pinterest | DV360 for programmatic display/video reach, Meta/TikTok for social reach, Pinterest for visual discovery |
36
+ | **Consideration** | DV360 + TTD + Meta + LinkedIn | Broad programmatic reach with social engagement and B2B professional targeting |
37
+ | **Conversion** | Google Ads + Meta + TTD + Amazon DSP | Search intent (Google) + social retargeting (Meta) + programmatic (TTD) + retail intent (Amazon) |
38
+ | **B2B** | LinkedIn + Google Ads + Meta | Professional audience targeting on LinkedIn, search intent, social retargeting |
39
+ | **Gen Z / Video** | TikTok + Snapchat + Meta | Short-form video engagement across Gen Z/Millennial audiences |
40
+ | **Shopping / E-commerce** | Pinterest + Meta + Google Ads + Amazon DSP | Visual discovery + social + search + retail intent |
41
+ | **Full-Funnel** | All 9 platforms | Maximum reach across all touchpoints |
42
+
43
+ ---
44
+
45
+ ## Step 2: Budget Allocation
46
+
47
+ Split the total budget across platforms. Common allocation strategies:
48
+
49
+ ### Performance-Based (Recommended for existing campaigns)
50
+ Allocate based on historical CPA/ROAS data. Use the \`cross_platform_performance_comparison\` prompt to gather data first.
51
+
52
+ ### Equal Split (New campaigns with no history)
53
+
54
+ | Platform | Allocation | Budget |
55
+ |----------|-----------|--------|
56
+ | DV360 | 15% | \$${totalBudget} × 0.15 |
57
+ | TTD | 15% | \$${totalBudget} × 0.15 |
58
+ | Google Ads | 15% | \$${totalBudget} × 0.15 |
59
+ | Meta | 15% | \$${totalBudget} × 0.15 |
60
+ | LinkedIn | 10% | \$${totalBudget} × 0.10 |
61
+ | TikTok | 10% | \$${totalBudget} × 0.10 |
62
+ | Pinterest | 10% | \$${totalBudget} × 0.10 |
63
+ | Snapchat | 5% | \$${totalBudget} × 0.05 |
64
+ | Amazon DSP | 5% | \$${totalBudget} × 0.05 |
65
+
66
+ ### Objective-Weighted
67
+
68
+ | Platform | Awareness | Consideration | Conversion | B2B | Shopping |
69
+ |----------|-----------|---------------|------------|-----|----------|
70
+ | DV360 | 25% | 20% | 10% | 5% | 5% |
71
+ | TTD | 15% | 15% | 15% | 5% | 10% |
72
+ | Google Ads | 5% | 15% | 30% | 20% | 20% |
73
+ | Meta | 20% | 20% | 15% | 15% | 20% |
74
+ | LinkedIn | 5% | 10% | 5% | 35% | 2% |
75
+ | TikTok | 15% | 10% | 10% | 5% | 8% |
76
+ | Pinterest | 10% | 5% | 5% | 0% | 20% |
77
+ | Snapchat | 5% | 5% | 5% | 0% | 5% |
78
+ | Amazon DSP | 0% | 0% | 5% | 15% | 10% |
79
+
80
+ ---
81
+
82
+ ## Step 3: Naming Convention
83
+
84
+ Use consistent naming across all platforms for easy cross-platform tracking:
85
+
86
+ **Pattern:** \`{Brand}_{Objective}_{Platform}_{Geo}_{Audience}_{YYYYMM}\`
87
+
88
+ **Examples:**
89
+ - \`Acme_Conv_DV360_US_Retargeting_202603\`
90
+ - \`Acme_Conv_TTD_US_Retargeting_202603\`
91
+ - \`Acme_Conv_GADS_US_Search_202603\`
92
+ - \`Acme_Conv_META_US_Lookalike_202603\`
93
+ - \`Acme_B2B_LI_US_Professionals_202603\`
94
+ - \`Acme_Aware_TT_US_GenZ_202603\`
95
+ - \`Acme_Shop_PIN_US_ShoppingIntent_202603\`
96
+ - \`Acme_Aware_SNAP_US_GenZ_202603\`
97
+ - \`Acme_Conv_AMZN_US_Retargeting_202603\`
98
+
99
+ ---
100
+
101
+ ## Step 4: Create Campaigns on Each Platform
102
+
103
+ ### DV360 (via dv360-mcp)
104
+
105
+ Use the \`full_campaign_setup_workflow\` prompt for detailed guidance.
106
+
107
+ Key steps:
108
+ 1. Create Campaign (PAUSED status)
109
+ 2. Create Insertion Order (DRAFT status)
110
+ 3. Create Line Items (DRAFT status)
111
+ 4. Assign targeting
112
+ 5. Activate via \`entity_activation_workflow\`
113
+
114
+ ⚠️ **DV360 budget values are in micros** (1,000,000 = $1.00)
115
+
116
+ ### The Trade Desk (via ttd-mcp)
117
+
118
+ Use the \`ttd_campaign_setup_workflow\` prompt for detailed guidance.
119
+
120
+ Key steps:
121
+ 1. Create Campaign
122
+ 2. Create Ad Groups with RTBAttributes
123
+ 3. Create Ads and link Creatives
124
+ 4. Set availability to "Available"
125
+
126
+ ⚠️ **TTD budget values are in dollars** ($100.00 = 100.00)
127
+
128
+ ### Google Ads (via gads-mcp)
129
+
130
+ Use the \`gads_campaign_setup_workflow\` prompt for detailed guidance.
131
+
132
+ Key steps:
133
+ 1. Create Campaign Budget
134
+ 2. Create Campaign (PAUSED)
135
+ 3. Create Ad Groups
136
+ 4. Create Keywords (for Search)
137
+ 5. Create Responsive Search Ads
138
+ 6. Enable campaign
139
+
140
+ ⚠️ **Google Ads budget values are in micros** (1,000,000 = $1.00)
141
+
142
+ ### Meta Ads (via meta-mcp)
143
+
144
+ Use the \`meta_campaign_setup_workflow\` prompt for detailed guidance.
145
+
146
+ Key steps:
147
+ 1. Create Campaign (PAUSED)
148
+ 2. Create Ad Creative
149
+ 3. Create Ad Sets with targeting
150
+ 4. Create Ads
151
+ 5. Activate
152
+
153
+ ⚠️ **Meta budget values are in cents** (5000 = $50.00)
154
+
155
+ ### LinkedIn Ads (via linkedin-mcp)
156
+
157
+ Use the \`linkedin_campaign_setup_workflow\` prompt for detailed guidance.
158
+
159
+ Key steps:
160
+ 1. Create Campaign Group (ACTIVE or PAUSED)
161
+ 2. Create Campaign with targeting criteria and CPM bid
162
+ 3. Create Creative linked to the campaign
163
+ 4. Activate via \`linkedin_bulk_update_status\`
164
+
165
+ ⚠️ **LinkedIn budget values are in dollars** ($100.00 = 100.00)
166
+
167
+ Best for: B2B, professional audiences, job title/company/skill targeting
168
+
169
+ ### TikTok Ads (via tiktok-mcp)
170
+
171
+ Use the \`tiktok_campaign_setup_workflow\` prompt for detailed guidance.
172
+
173
+ Key steps:
174
+ 1. Create Campaign with objective and budget
175
+ 2. Create Ad Group with targeting and schedule
176
+ 3. Upload creatives via \`tiktok_upload_video\` or \`tiktok_upload_image\`
177
+ 4. Create Ads referencing the creative
178
+ 5. Enable via \`tiktok_bulk_update_status\`
179
+
180
+ ⚠️ **TikTok budget values are in dollars** ($100.00 = 100.00)
181
+
182
+ Best for: Short-form video, Gen Z/Millennial audiences, entertainment and lifestyle brands
183
+
184
+ ### Pinterest (via pinterest-mcp)
185
+
186
+ Use the \`pinterest_campaign_setup_workflow\` prompt for detailed guidance.
187
+
188
+ Key steps:
189
+ 1. Create Campaign (ACTIVE or PAUSED)
190
+ 2. Create Ad Groups with targeting_spec
191
+ 3. Upload/identify Pinterest Pin to promote
192
+ 4. Create Ads referencing the Pin by pin_id
193
+ 5. Activate via \`pinterest_bulk_update_status\`
194
+
195
+ ⚠️ **Pinterest budget values are in micro-currency** (50000000 = $50.00)
196
+
197
+ Best for: E-commerce, lifestyle, food/beauty brands — high visual discovery and shopping intent
198
+
199
+ ### Snapchat (via snapchat-mcp)
200
+
201
+ Use the \`snapchat_campaign_setup_workflow\` prompt for detailed guidance.
202
+
203
+ Key steps:
204
+ 1. Create Campaign with objective and budget
205
+ 2. Create Ad Squad (Ad Group) with targeting and placement
206
+ 3. Upload creative via \`snapchat_upload_media\`
207
+ 4. Create Ads referencing the creative
208
+ 5. Activate via \`snapchat_bulk_update_status\`
209
+
210
+ ⚠️ **Snapchat budget values are in micro-currency** (1 = $0.000001, so $100.00 = 100000000)
211
+
212
+ Best for: Gen Z audiences, AR lenses, video/story formats
213
+
214
+ ### Amazon DSP (via amazon-dsp-mcp)
215
+
216
+ Use the \`amazon_dsp_campaign_setup_workflow\` prompt for detailed guidance.
217
+
218
+ Key steps:
219
+ 1. Create Order (equivalent to Campaign) with flight dates and budget
220
+ 2. Create Line Item with targeting and bid
221
+ 3. Create Creative and attach to Line Item
222
+ 4. Activate Order
223
+
224
+ ⚠️ **Amazon DSP budget values are in dollars** ($100.00 = 100.00)
225
+
226
+ Best for: Retail/commerce intent, first-party Amazon audience data, programmatic display
227
+
228
+ ---
229
+
230
+ ## Step 5: Budget Value Reference
231
+
232
+ Critical — each platform uses different units:
233
+
234
+ | Platform | Unit | $100.00 Budget | $5.00 Bid | Best For |
235
+ |----------|------|---------------|-----------|----------|
236
+ | **DV360** | Micros | 100000000 | 5000000 | Programmatic display/video |
237
+ | **TTD** | Dollars | 100.00 | 5.00 | Programmatic DSP |
238
+ | **Google Ads** | Micros | 100000000 | 5000000 | Search intent |
239
+ | **Meta** | Cents | 10000 | 500 | Social retargeting |
240
+ | **LinkedIn** | Dollars | 100.00 | 5.00 | B2B professional audiences |
241
+ | **TikTok** | Dollars | 100.00 | 5.00 | Short-form video, Gen Z |
242
+ | **Pinterest** | Micro-currency | 100000000 | 5000000 | Visual discovery, shopping |
243
+ | **Snapchat** | Micro-currency | 100000000 | 5000000 | Gen Z, AR/video |
244
+ | **Amazon DSP** | Dollars | 100.00 | 5.00 | Retail/commerce intent |
245
+
246
+ ---
247
+
248
+ ## Step 6: Phased Launch
249
+
250
+ Don't activate all platforms simultaneously. Launch in phases to monitor:
251
+
252
+ ### Phase 1: Pilot (Week 1)
253
+ - Launch on **one platform** (e.g., Google Ads for conversion, Meta for awareness)
254
+ - Allocate 25% of total budget
255
+ - Establish baseline CPA/ROAS
256
+
257
+ ### Phase 2: Expand (Week 2)
258
+ - Add **second platform** (e.g., Meta or TTD)
259
+ - Compare performance with Phase 1 baseline
260
+ - Adjust bids based on early results
261
+
262
+ ### Phase 3: Full Launch (Week 3+)
263
+ - Activate remaining platforms
264
+ - Use \`cross_platform_performance_comparison\` prompt to monitor
265
+ - Reallocate budget based on performance data
266
+
267
+ ---
268
+
269
+ ## Step 7: Cross-Platform Tracking
270
+
271
+ Set up consistent conversion tracking across platforms:
272
+
273
+ 1. **UTM parameters**: Use consistent UTM source/medium/campaign across all platforms
274
+ 2. **Conversion pixels**: Ensure all platforms track the same conversion events
275
+ 3. **Attribution window**: Note that each platform uses different attribution models — cross-platform CPA comparisons are directional
276
+
277
+ ---
278
+
279
+ ## Post-Launch Monitoring
280
+
281
+ After all platforms are live:
282
+
283
+ 1. **Daily**: Check pacing on each platform
284
+ 2. **Weekly**: Run \`cross_platform_performance_comparison\` to compare metrics
285
+ 3. **Bi-weekly**: Reallocate budget from underperformers to top performers
286
+ 4. **Monthly**: Review overall campaign ROAS and adjust strategy
287
+
288
+ ---
289
+
290
+ ## Gotchas
291
+
292
+ - **Create campaigns PAUSED/DRAFT on all platforms first**, then activate in a controlled sequence
293
+ - **Budget units differ per platform** — double-check the conversion table above
294
+ - **Targeting alignment**: Try to match audiences across platforms as closely as possible for valid comparisons
295
+ - **Creative formats differ**: Each platform has different ad format requirements — plan creative assets accordingly
296
+ - **Time zones**: Campaigns on different platforms may use different timezone settings — align flight dates carefully
297
+ `;
298
+ }
299
+ //# sourceMappingURL=cross-platform-campaign-setup.prompt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cross-platform-campaign-setup.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,gCAAgC,GAAW;IACtD,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,oXAAoX;IACtX,SAAS,EAAE;QACT;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,wEAAwE;YACrF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,yFAAyF;YAC3F,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,oCAAoC,CAAC,IAA6B;IAChF,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,eAAe,CAAC;IACzD,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,YAAY,CAAC;IAElD,OAAO;;kBAES,WAAW;eACd,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAiCJ,WAAW;kBACb,WAAW;yBACJ,WAAW;mBACjB,WAAW;uBACP,WAAW;qBACb,WAAW;wBACR,WAAW;sBACb,WAAW;wBACT,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyOlC,CAAC;AACF,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
2
+ export declare const crossPlatformPerformancePrompt: Prompt;
3
+ export declare function getCrossPlatformPerformanceMessage(args?: Record<string, string>): string;
4
+ //# sourceMappingURL=cross-platform-performance.prompt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cross-platform-performance.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/cross-platform-performance.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE,eAAO,MAAM,8BAA8B,EAAE,MAY5C,CAAC;AAEF,wBAAgB,kCAAkC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA8JxF"}