@cesteral/msads-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 (255) hide show
  1. package/LICENSE.md +201 -0
  2. package/README.md +179 -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/msads-auth-adapter.d.ts +27 -0
  8. package/dist/auth/msads-auth-adapter.d.ts.map +1 -0
  9. package/dist/auth/msads-auth-adapter.js +79 -0
  10. package/dist/auth/msads-auth-adapter.js.map +1 -0
  11. package/dist/auth/msads-auth-strategy.d.ts +8 -0
  12. package/dist/auth/msads-auth-strategy.d.ts.map +1 -0
  13. package/dist/auth/msads-auth-strategy.js +36 -0
  14. package/dist/auth/msads-auth-strategy.js.map +1 -0
  15. package/dist/config/index.d.ts +112 -0
  16. package/dist/config/index.d.ts.map +1 -0
  17. package/dist/config/index.js +56 -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 +47 -0
  22. package/dist/index.js.map +1 -0
  23. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
  24. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
  25. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +54 -0
  26. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
  27. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
  28. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
  29. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +147 -0
  30. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
  31. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +4 -0
  32. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -0
  33. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +73 -0
  34. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js.map +1 -0
  35. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +4 -0
  36. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -0
  37. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js +55 -0
  38. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js.map +1 -0
  39. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
  40. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
  41. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +47 -0
  42. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
  43. package/dist/mcp-server/prompts/index.d.ts +9 -0
  44. package/dist/mcp-server/prompts/index.d.ts.map +1 -0
  45. package/dist/mcp-server/prompts/index.js +49 -0
  46. package/dist/mcp-server/prompts/index.js.map +1 -0
  47. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
  48. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
  49. package/dist/mcp-server/resources/definitions/entity-examples.resource.js +84 -0
  50. package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
  51. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
  52. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
  53. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +54 -0
  54. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
  55. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
  56. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
  57. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +54 -0
  58. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
  59. package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts +3 -0
  60. package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts.map +1 -0
  61. package/dist/mcp-server/resources/definitions/field-rules.resource.js +28 -0
  62. package/dist/mcp-server/resources/definitions/field-rules.resource.js.map +1 -0
  63. package/dist/mcp-server/resources/definitions/index.d.ts +7 -0
  64. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  65. package/dist/mcp-server/resources/definitions/index.js +79 -0
  66. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  67. package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts +3 -0
  68. package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts.map +1 -0
  69. package/dist/mcp-server/resources/definitions/reporting-reference.resource.js +64 -0
  70. package/dist/mcp-server/resources/definitions/reporting-reference.resource.js.map +1 -0
  71. package/dist/mcp-server/resources/index.d.ts +3 -0
  72. package/dist/mcp-server/resources/index.d.ts.map +1 -0
  73. package/dist/mcp-server/resources/index.js +2 -0
  74. package/dist/mcp-server/resources/index.js.map +1 -0
  75. package/dist/mcp-server/resources/types.d.ts +8 -0
  76. package/dist/mcp-server/resources/types.d.ts.map +1 -0
  77. package/dist/mcp-server/resources/types.js +2 -0
  78. package/dist/mcp-server/resources/types.js.map +1 -0
  79. package/dist/mcp-server/resources/utils/field-rules.d.ts +9 -0
  80. package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -0
  81. package/dist/mcp-server/resources/utils/field-rules.js +106 -0
  82. package/dist/mcp-server/resources/utils/field-rules.js.map +1 -0
  83. package/dist/mcp-server/server.d.ts +5 -0
  84. package/dist/mcp-server/server.d.ts.map +1 -0
  85. package/dist/mcp-server/server.js +142 -0
  86. package/dist/mcp-server/server.js.map +1 -0
  87. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +175 -0
  88. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
  89. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +124 -0
  90. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
  91. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +83 -0
  92. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
  93. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +68 -0
  94. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
  95. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +95 -0
  96. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
  97. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +102 -0
  98. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
  99. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +151 -0
  100. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
  101. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +112 -0
  102. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
  103. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +111 -0
  104. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
  105. package/dist/mcp-server/tools/definitions/check-report-status.tool.js +73 -0
  106. package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
  107. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +81 -0
  108. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
  109. package/dist/mcp-server/tools/definitions/create-entity.tool.js +74 -0
  110. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
  111. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +160 -0
  112. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -0
  113. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +108 -0
  114. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -0
  115. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +98 -0
  116. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
  117. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +94 -0
  118. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
  119. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +79 -0
  120. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -0
  121. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +88 -0
  122. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -0
  123. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +287 -0
  124. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
  125. package/dist/mcp-server/tools/definitions/download-report.tool.js +85 -0
  126. package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
  127. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +68 -0
  128. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -0
  129. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +85 -0
  130. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -0
  131. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +68 -0
  132. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
  133. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +90 -0
  134. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
  135. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +285 -0
  136. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
  137. package/dist/mcp-server/tools/definitions/get-entity.tool.js +120 -0
  138. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
  139. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +280 -0
  140. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -0
  141. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +138 -0
  142. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -0
  143. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +260 -0
  144. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -0
  145. package/dist/mcp-server/tools/definitions/get-report.tool.js +118 -0
  146. package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -0
  147. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +79 -0
  148. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -0
  149. package/dist/mcp-server/tools/definitions/import-from-google.tool.js +88 -0
  150. package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -0
  151. package/dist/mcp-server/tools/definitions/index.d.ts +3 -0
  152. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  153. package/dist/mcp-server/tools/definitions/index.js +53 -0
  154. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  155. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +135 -0
  156. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -0
  157. package/dist/mcp-server/tools/definitions/list-accounts.tool.js +88 -0
  158. package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -0
  159. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +120 -0
  160. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
  161. package/dist/mcp-server/tools/definitions/list-entities.tool.js +100 -0
  162. package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
  163. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +47 -0
  164. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -0
  165. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +57 -0
  166. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -0
  167. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +81 -0
  168. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -0
  169. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +81 -0
  170. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -0
  171. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +90 -0
  172. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -0
  173. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +92 -0
  174. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -0
  175. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +79 -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 +105 -0
  178. package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
  179. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +132 -0
  180. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
  181. package/dist/mcp-server/tools/definitions/submit-report.tool.js +94 -0
  182. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
  183. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +79 -0
  184. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
  185. package/dist/mcp-server/tools/definitions/update-entity.tool.js +64 -0
  186. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
  187. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +174 -0
  188. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
  189. package/dist/mcp-server/tools/definitions/validate-entity.tool.js +142 -0
  190. package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
  191. package/dist/mcp-server/tools/index.d.ts +2 -0
  192. package/dist/mcp-server/tools/index.d.ts.map +1 -0
  193. package/dist/mcp-server/tools/index.js +2 -0
  194. package/dist/mcp-server/tools/index.js.map +1 -0
  195. package/dist/mcp-server/tools/utils/entity-mapping.d.ts +20 -0
  196. package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
  197. package/dist/mcp-server/tools/utils/entity-mapping.js +118 -0
  198. package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
  199. package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
  200. package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
  201. package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
  202. package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
  203. package/dist/mcp-server/transports/streamable-http-transport.d.ts +55 -0
  204. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
  205. package/dist/mcp-server/transports/streamable-http-transport.js +86 -0
  206. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
  207. package/dist/services/msads/msads-http-client.d.ts +16 -0
  208. package/dist/services/msads/msads-http-client.d.ts.map +1 -0
  209. package/dist/services/msads/msads-http-client.js +89 -0
  210. package/dist/services/msads/msads-http-client.js.map +1 -0
  211. package/dist/services/msads/msads-reporting-service.d.ts +58 -0
  212. package/dist/services/msads/msads-reporting-service.d.ts.map +1 -0
  213. package/dist/services/msads/msads-reporting-service.js +153 -0
  214. package/dist/services/msads/msads-reporting-service.js.map +1 -0
  215. package/dist/services/msads/msads-service.d.ts +54 -0
  216. package/dist/services/msads/msads-service.d.ts.map +1 -0
  217. package/dist/services/msads/msads-service.js +179 -0
  218. package/dist/services/msads/msads-service.js.map +1 -0
  219. package/dist/services/msads/rate-limit-keys.d.ts +3 -0
  220. package/dist/services/msads/rate-limit-keys.d.ts.map +1 -0
  221. package/dist/services/msads/rate-limit-keys.js +3 -0
  222. package/dist/services/msads/rate-limit-keys.js.map +1 -0
  223. package/dist/services/msads/types.d.ts +196 -0
  224. package/dist/services/msads/types.d.ts.map +1 -0
  225. package/dist/services/msads/types.js +47 -0
  226. package/dist/services/msads/types.js.map +1 -0
  227. package/dist/services/session-services.d.ts +22 -0
  228. package/dist/services/session-services.d.ts.map +1 -0
  229. package/dist/services/session-services.js +22 -0
  230. package/dist/services/session-services.js.map +1 -0
  231. package/dist/types-global/mcp.d.ts +2 -0
  232. package/dist/types-global/mcp.d.ts.map +1 -0
  233. package/dist/types-global/mcp.js +2 -0
  234. package/dist/types-global/mcp.js.map +1 -0
  235. package/dist/utils/errors/index.d.ts +2 -0
  236. package/dist/utils/errors/index.d.ts.map +1 -0
  237. package/dist/utils/errors/index.js +2 -0
  238. package/dist/utils/errors/index.js.map +1 -0
  239. package/dist/utils/platform.d.ts +3 -0
  240. package/dist/utils/platform.d.ts.map +1 -0
  241. package/dist/utils/platform.js +5 -0
  242. package/dist/utils/platform.js.map +1 -0
  243. package/dist/utils/security/rate-limiter.d.ts +3 -0
  244. package/dist/utils/security/rate-limiter.d.ts.map +1 -0
  245. package/dist/utils/security/rate-limiter.js +5 -0
  246. package/dist/utils/security/rate-limiter.js.map +1 -0
  247. package/dist/utils/telemetry/index.d.ts +2 -0
  248. package/dist/utils/telemetry/index.d.ts.map +1 -0
  249. package/dist/utils/telemetry/index.js +2 -0
  250. package/dist/utils/telemetry/index.js.map +1 -0
  251. package/dist/utils/telemetry/tracing.d.ts +3 -0
  252. package/dist/utils/telemetry/tracing.d.ts.map +1 -0
  253. package/dist/utils/telemetry/tracing.js +4 -0
  254. package/dist/utils/telemetry/tracing.js.map +1 -0
  255. package/package.json +56 -0
@@ -0,0 +1,112 @@
1
+ import { z } from "zod";
2
+ declare const ConfigSchema: z.ZodObject<{
3
+ host: z.ZodDefault<z.ZodString>;
4
+ nodeEnv: z.ZodDefault<z.ZodEnum<["development", "production", "test"]>>;
5
+ mcpStatefulSessionTimeoutMs: z.ZodDefault<z.ZodNumber>;
6
+ mcpAuthSecretKey: z.ZodOptional<z.ZodString>;
7
+ mcpAllowedOrigins: z.ZodOptional<z.ZodString>;
8
+ logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
9
+ mcpLogLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
10
+ otelEnabled: z.ZodDefault<z.ZodBoolean>;
11
+ otelExporterOtlpTracesEndpoint: z.ZodOptional<z.ZodString>;
12
+ otelExporterOtlpMetricsEndpoint: z.ZodOptional<z.ZodString>;
13
+ gcsBucketName: z.ZodOptional<z.ZodString>;
14
+ } & {
15
+ serviceName: z.ZodDefault<z.ZodString>;
16
+ port: z.ZodDefault<z.ZodNumber>;
17
+ otelServiceName: z.ZodDefault<z.ZodString>;
18
+ mcpAuthMode: z.ZodDefault<z.ZodEnum<["msads-bearer", "jwt", "none"]>>;
19
+ msadsCampaignApiBaseUrl: z.ZodDefault<z.ZodString>;
20
+ msadsReportingApiBaseUrl: z.ZodDefault<z.ZodString>;
21
+ msadsCustomerApiBaseUrl: z.ZodDefault<z.ZodString>;
22
+ msadsRateLimitPerMinute: z.ZodDefault<z.ZodNumber>;
23
+ msadsAccessToken: z.ZodOptional<z.ZodString>;
24
+ msadsDeveloperToken: z.ZodOptional<z.ZodString>;
25
+ msadsCustomerId: z.ZodOptional<z.ZodString>;
26
+ msadsAccountId: z.ZodOptional<z.ZodString>;
27
+ msadsReportPollIntervalMs: z.ZodDefault<z.ZodNumber>;
28
+ msadsReportMaxPollAttempts: z.ZodDefault<z.ZodNumber>;
29
+ }, "strip", z.ZodTypeAny, {
30
+ serviceName: string;
31
+ port: number;
32
+ otelServiceName: string;
33
+ mcpAuthMode: "msads-bearer" | "jwt" | "none";
34
+ msadsCampaignApiBaseUrl: string;
35
+ msadsReportingApiBaseUrl: string;
36
+ msadsCustomerApiBaseUrl: string;
37
+ msadsRateLimitPerMinute: number;
38
+ msadsReportPollIntervalMs: number;
39
+ msadsReportMaxPollAttempts: number;
40
+ host: string;
41
+ nodeEnv: "development" | "production" | "test";
42
+ mcpStatefulSessionTimeoutMs: number;
43
+ logLevel: "debug" | "info" | "notice" | "warning" | "error";
44
+ mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
45
+ otelEnabled: boolean;
46
+ msadsAccessToken?: string | undefined;
47
+ msadsDeveloperToken?: string | undefined;
48
+ msadsCustomerId?: string | undefined;
49
+ msadsAccountId?: string | undefined;
50
+ mcpAuthSecretKey?: string | undefined;
51
+ mcpAllowedOrigins?: string | undefined;
52
+ otelExporterOtlpTracesEndpoint?: string | undefined;
53
+ otelExporterOtlpMetricsEndpoint?: string | undefined;
54
+ gcsBucketName?: string | undefined;
55
+ }, {
56
+ serviceName?: string | undefined;
57
+ port?: number | undefined;
58
+ otelServiceName?: string | undefined;
59
+ mcpAuthMode?: "msads-bearer" | "jwt" | "none" | undefined;
60
+ msadsCampaignApiBaseUrl?: string | undefined;
61
+ msadsReportingApiBaseUrl?: string | undefined;
62
+ msadsCustomerApiBaseUrl?: string | undefined;
63
+ msadsRateLimitPerMinute?: number | undefined;
64
+ msadsAccessToken?: string | undefined;
65
+ msadsDeveloperToken?: string | undefined;
66
+ msadsCustomerId?: string | undefined;
67
+ msadsAccountId?: string | undefined;
68
+ msadsReportPollIntervalMs?: number | undefined;
69
+ msadsReportMaxPollAttempts?: number | undefined;
70
+ host?: string | undefined;
71
+ nodeEnv?: "development" | "production" | "test" | undefined;
72
+ mcpStatefulSessionTimeoutMs?: number | undefined;
73
+ mcpAuthSecretKey?: string | undefined;
74
+ mcpAllowedOrigins?: string | undefined;
75
+ logLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
76
+ mcpLogLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
77
+ otelEnabled?: boolean | undefined;
78
+ otelExporterOtlpTracesEndpoint?: string | undefined;
79
+ otelExporterOtlpMetricsEndpoint?: string | undefined;
80
+ gcsBucketName?: string | undefined;
81
+ }>;
82
+ export type AppConfig = z.infer<typeof ConfigSchema>;
83
+ export declare function parseConfig(): AppConfig;
84
+ export declare const mcpConfig: {
85
+ serviceName: string;
86
+ port: number;
87
+ otelServiceName: string;
88
+ mcpAuthMode: "msads-bearer" | "jwt" | "none";
89
+ msadsCampaignApiBaseUrl: string;
90
+ msadsReportingApiBaseUrl: string;
91
+ msadsCustomerApiBaseUrl: string;
92
+ msadsRateLimitPerMinute: number;
93
+ msadsReportPollIntervalMs: number;
94
+ msadsReportMaxPollAttempts: number;
95
+ host: string;
96
+ nodeEnv: "development" | "production" | "test";
97
+ mcpStatefulSessionTimeoutMs: number;
98
+ logLevel: "debug" | "info" | "notice" | "warning" | "error";
99
+ mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
100
+ otelEnabled: boolean;
101
+ msadsAccessToken?: string | undefined;
102
+ msadsDeveloperToken?: string | undefined;
103
+ msadsCustomerId?: string | undefined;
104
+ msadsAccountId?: string | undefined;
105
+ mcpAuthSecretKey?: string | undefined;
106
+ mcpAllowedOrigins?: string | undefined;
107
+ otelExporterOtlpTracesEndpoint?: string | undefined;
108
+ otelExporterOtlpMetricsEndpoint?: string | undefined;
109
+ gcsBucketName?: string | undefined;
110
+ };
111
+ export {};
112
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmChB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAErD,wBAAgB,WAAW,IAAI,SAAS,CAkCvC;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;CAAgB,CAAC"}
@@ -0,0 +1,56 @@
1
+ import { z } from "zod";
2
+ import { loadDotEnv, BaseConfigSchema, getBaseEnvConfig, parseConfigWithSchema, getDefaultHost, } from "@cesteral/shared";
3
+ loadDotEnv();
4
+ const ConfigSchema = BaseConfigSchema.extend({
5
+ serviceName: z.string().default("msads-mcp"),
6
+ port: z.number().int().min(1).max(65535).default(3013),
7
+ otelServiceName: z.string().default("msads-mcp"),
8
+ mcpAuthMode: z.enum(["msads-bearer", "jwt", "none"]).default("msads-bearer"),
9
+ msadsCampaignApiBaseUrl: z
10
+ .string()
11
+ .url()
12
+ .default("https://campaign.api.bingads.microsoft.com/CampaignManagement/v13"),
13
+ msadsReportingApiBaseUrl: z
14
+ .string()
15
+ .url()
16
+ .default("https://reporting.api.bingads.microsoft.com/Reporting/v13"),
17
+ msadsCustomerApiBaseUrl: z
18
+ .string()
19
+ .url()
20
+ .default("https://clientcenter.api.bingads.microsoft.com/CustomerManagement/v13"),
21
+ msadsRateLimitPerMinute: z.number().default(10),
22
+ msadsAccessToken: z.string().optional(),
23
+ msadsDeveloperToken: z.string().optional(),
24
+ msadsCustomerId: z.string().optional(),
25
+ msadsAccountId: z.string().optional(),
26
+ msadsReportPollIntervalMs: z.number().default(3_000),
27
+ msadsReportMaxPollAttempts: z.number().default(30),
28
+ });
29
+ export function parseConfig() {
30
+ const defaultHost = getDefaultHost();
31
+ const rawConfig = {
32
+ ...getBaseEnvConfig(defaultHost),
33
+ serviceName: process.env.SERVICE_NAME,
34
+ ...(process.env.MSADS_MCP_PORT ? { port: Number(process.env.MSADS_MCP_PORT) } : {}),
35
+ host: process.env.MSADS_MCP_HOST || defaultHost,
36
+ msadsCampaignApiBaseUrl: process.env.MSADS_CAMPAIGN_API_BASE_URL,
37
+ msadsReportingApiBaseUrl: process.env.MSADS_REPORTING_API_BASE_URL,
38
+ msadsCustomerApiBaseUrl: process.env.MSADS_CUSTOMER_API_BASE_URL,
39
+ msadsRateLimitPerMinute: process.env.MSADS_RATE_LIMIT_PER_MINUTE
40
+ ? Number(process.env.MSADS_RATE_LIMIT_PER_MINUTE)
41
+ : undefined,
42
+ msadsAccessToken: process.env.MSADS_ACCESS_TOKEN,
43
+ msadsDeveloperToken: process.env.MSADS_DEVELOPER_TOKEN,
44
+ msadsCustomerId: process.env.MSADS_CUSTOMER_ID,
45
+ msadsAccountId: process.env.MSADS_ACCOUNT_ID,
46
+ msadsReportPollIntervalMs: process.env.MSADS_REPORT_POLL_INTERVAL_MS
47
+ ? Number(process.env.MSADS_REPORT_POLL_INTERVAL_MS)
48
+ : undefined,
49
+ msadsReportMaxPollAttempts: process.env.MSADS_REPORT_MAX_POLL_ATTEMPTS
50
+ ? Number(process.env.MSADS_REPORT_MAX_POLL_ATTEMPTS)
51
+ : undefined,
52
+ };
53
+ return parseConfigWithSchema(ConfigSchema, rawConfig);
54
+ }
55
+ export const mcpConfig = parseConfig();
56
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export {};
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
package/dist/index.js ADDED
@@ -0,0 +1,47 @@
1
+ #!/usr/bin/env node
2
+ import { mcpConfig } from "./config/index.js";
3
+ import { createMcpServer, runStdioServer } from "./mcp-server/server.js";
4
+ import { startHttpServer } from "./mcp-server/transports/streamable-http-transport.js";
5
+ import { initializeOpenTelemetry, otelLogMixin } from "@cesteral/shared";
6
+ import { MsAdsAccessTokenAdapter } from "./auth/msads-auth-adapter.js";
7
+ import { detectTransportMode, createServerLogger, bootstrapMcpServer } from "@cesteral/shared";
8
+ import { createSessionServices, sessionServiceStore } from "./services/session-services.js";
9
+ import { rateLimiter } from "./utils/platform.js";
10
+ const transportMode = detectTransportMode();
11
+ const logger = createServerLogger("msads-mcp", transportMode, otelLogMixin());
12
+ async function setupStdioCredentials(sessionId) {
13
+ const { msadsAccessToken, msadsDeveloperToken, msadsCustomerId, msadsAccountId } = mcpConfig;
14
+ if (!msadsAccessToken || !msadsDeveloperToken || !msadsCustomerId || !msadsAccountId) {
15
+ logger.warn("No Microsoft Ads credentials found in env vars. " +
16
+ "Set MSADS_ACCESS_TOKEN, MSADS_DEVELOPER_TOKEN, MSADS_CUSTOMER_ID, and MSADS_ACCOUNT_ID for stdio mode.");
17
+ return false;
18
+ }
19
+ const authAdapter = new MsAdsAccessTokenAdapter(msadsAccessToken, msadsDeveloperToken, msadsCustomerId, msadsAccountId, mcpConfig.msadsCustomerApiBaseUrl);
20
+ await authAdapter.validate();
21
+ const services = createSessionServices(authAdapter, {
22
+ campaignApiBaseUrl: mcpConfig.msadsCampaignApiBaseUrl,
23
+ reportingApiBaseUrl: mcpConfig.msadsReportingApiBaseUrl,
24
+ customerApiBaseUrl: mcpConfig.msadsCustomerApiBaseUrl,
25
+ reportPollIntervalMs: mcpConfig.msadsReportPollIntervalMs,
26
+ reportMaxPollAttempts: mcpConfig.msadsReportMaxPollAttempts,
27
+ }, logger, rateLimiter);
28
+ sessionServiceStore.set(sessionId, services);
29
+ logger.info("Stdio session services created successfully");
30
+ return true;
31
+ }
32
+ bootstrapMcpServer({
33
+ serviceName: "msads-mcp",
34
+ config: mcpConfig,
35
+ logger,
36
+ transportMode,
37
+ initOtel: initializeOpenTelemetry,
38
+ setupStdioSession: setupStdioCredentials,
39
+ createMcpServer,
40
+ runStdio: runStdioServer,
41
+ startHttp: startHttpServer,
42
+ onShutdown: () => rateLimiter.destroy(),
43
+ }).catch((err) => {
44
+ logger.fatal({ err }, "Failed to start msads-mcp");
45
+ process.exit(1);
46
+ });
47
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;AAC5C,MAAM,MAAM,GAAG,kBAAkB,CAAC,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;AAK9E,KAAK,UAAU,qBAAqB,CAAC,SAAiB;IACpD,MAAM,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC;IAE7F,IAAI,CAAC,gBAAgB,IAAI,CAAC,mBAAmB,IAAI,CAAC,eAAe,IAAI,CAAC,cAAc,EAAE,CAAC;QACrF,MAAM,CAAC,IAAI,CACT,kDAAkD;YAChD,wGAAwG,CAC3G,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,uBAAuB,CAC7C,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,SAAS,CAAC,uBAAuB,CAClC,CAAC;IAEF,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;IAE7B,MAAM,QAAQ,GAAG,qBAAqB,CACpC,WAAW,EACX;QACE,kBAAkB,EAAE,SAAS,CAAC,uBAAuB;QACrD,mBAAmB,EAAE,SAAS,CAAC,wBAAwB;QACvD,kBAAkB,EAAE,SAAS,CAAC,uBAAuB;QACrD,oBAAoB,EAAE,SAAS,CAAC,yBAAyB;QACzD,qBAAqB,EAAE,SAAS,CAAC,0BAA0B;KAC5D,EACD,MAAM,EACN,WAAW,CACZ,CAAC;IAEF,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kBAAkB,CAAC;IACjB,WAAW,EAAE,WAAW;IACxB,MAAM,EAAE,SAAS;IACjB,MAAM;IACN,aAAa;IACb,QAAQ,EAAE,uBAAuB;IACjC,iBAAiB,EAAE,qBAAqB;IACxC,eAAe;IACf,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE;CACxC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACf,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,2BAA2B,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
2
+ export declare const msadsBulkOperationsWorkflowPrompt: Prompt;
3
+ export declare function getMsAdsBulkOperationsWorkflowMessage(): string;
4
+ //# sourceMappingURL=bulk-operations-workflow.prompt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bulk-operations-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,iCAAiC,EAAE,MAI/C,CAAC;AAEF,wBAAgB,qCAAqC,IAAI,MAAM,CA+C9D"}
@@ -0,0 +1,54 @@
1
+ export const msadsBulkOperationsWorkflowPrompt = {
2
+ name: "msads_bulk_operations_workflow",
3
+ description: "Guide for performing bulk operations in Microsoft Advertising",
4
+ arguments: [],
5
+ };
6
+ export function getMsAdsBulkOperationsWorkflowMessage() {
7
+ return `# Microsoft Ads Bulk Operations Workflow
8
+
9
+ ## Bulk Create Entities
10
+ \`\`\`json
11
+ msads_bulk_create_entities({
12
+ "entityType": "keyword",
13
+ "items": [
14
+ { "AdGroupId": 123, "Text": "keyword 1", "MatchType": "Phrase", "Bid": { "Amount": 1.50 } },
15
+ { "AdGroupId": 123, "Text": "keyword 2", "MatchType": "Exact", "Bid": { "Amount": 2.00 } }
16
+ ]
17
+ })
18
+ \`\`\`
19
+
20
+ ## Bulk Update Status (Pause/Activate)
21
+ \`\`\`json
22
+ msads_bulk_update_status({
23
+ "entityType": "campaign",
24
+ "entityIds": ["111", "222", "333"],
25
+ "status": "Paused"
26
+ })
27
+ \`\`\`
28
+
29
+ ## Bulk Bid Adjustments
30
+ \`\`\`json
31
+ msads_adjust_bids({
32
+ "entityType": "keyword",
33
+ "adjustments": [
34
+ { "entityId": "111", "bidField": "Bid", "newBid": 1.75 },
35
+ { "entityId": "222", "bidField": "Bid", "newBid": 2.25 }
36
+ ]
37
+ })
38
+ \`\`\`
39
+ The adjust-bids tool uses a safe read-modify-write pattern.
40
+
41
+ ## Batch Limits
42
+ | Entity | Batch Limit |
43
+ |--------|-------------|
44
+ | Campaign | 100 |
45
+ | Ad Group | 1,000 |
46
+ | Ad | 50 |
47
+ | Keyword | 1,000 |
48
+ | Budget | 100 |
49
+ | Ad Extension | 100 |
50
+ | Audience | 100 |
51
+ | Label | 100 |
52
+ `;
53
+ }
54
+ //# sourceMappingURL=bulk-operations-workflow.prompt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bulk-operations-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,iCAAiC,GAAW;IACvD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,+DAA+D;IAC5E,SAAS,EAAE,EAAE;CACd,CAAC;AAEF,MAAM,UAAU,qCAAqC;IACnD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CR,CAAC;AACF,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
2
+ export declare const campaignSetupWorkflowPrompt: Prompt;
3
+ export declare function getCampaignSetupWorkflowMessage(args?: Record<string, string>): string;
4
+ //# sourceMappingURL=campaign-setup-workflow.prompt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"campaign-setup-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,2BAA2B,EAAE,MAWzC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAsIrF"}
@@ -0,0 +1,147 @@
1
+ export const campaignSetupWorkflowPrompt = {
2
+ name: "msads_campaign_setup_workflow",
3
+ description: "Step-by-step guide for creating a complete Microsoft Advertising campaign",
4
+ arguments: [
5
+ { name: "accountId", description: "Microsoft Ads Account ID", required: true },
6
+ {
7
+ name: "campaignType",
8
+ description: "Campaign type (Search, Shopping, Audience)",
9
+ required: false,
10
+ },
11
+ ],
12
+ };
13
+ export function getCampaignSetupWorkflowMessage(args) {
14
+ const campaignType = args?.campaignType || "Search";
15
+ return `# Microsoft Ads Campaign Setup Workflow (Account: ${args?.accountId || "{accountId}"})
16
+
17
+ ## Step 1: Create Budget (optional — for shared budgets)
18
+ \`\`\`json
19
+ msads_create_entity({
20
+ "entityType": "budget",
21
+ "data": {
22
+ "Budgets": [{
23
+ "Name": "Q1 2026 Budget",
24
+ "Amount": 3000.00,
25
+ "BudgetType": "MonthlyBudgetSpendUntilDepleted"
26
+ }]
27
+ }
28
+ })
29
+ \`\`\`
30
+
31
+ ## Step 2: Create Campaign
32
+ \`\`\`json
33
+ msads_create_entity({
34
+ "entityType": "campaign",
35
+ "data": {
36
+ "Campaigns": [{
37
+ "Name": "My ${campaignType} Campaign",
38
+ "BudgetType": "DailyBudgetStandard",
39
+ "DailyBudget": 50.00,
40
+ "TimeZone": "EasternTimeUSCanada",
41
+ "CampaignType": "${campaignType}",
42
+ "Languages": ["English"],
43
+ "Status": "Paused"
44
+ }]
45
+ }
46
+ })
47
+ \`\`\`
48
+
49
+ ## Step 3: Add Campaign Targeting
50
+ \`\`\`json
51
+ msads_manage_criterions({
52
+ "operation": "add",
53
+ "entityLevel": "campaign",
54
+ "data": {
55
+ "CampaignCriterions": [
56
+ { "CampaignId": {campaignId}, "Type": "LocationCriterion", "LocationId": 190 }
57
+ ]
58
+ }
59
+ })
60
+ \`\`\`
61
+
62
+ ## Step 4: Create Ad Group
63
+ \`\`\`json
64
+ msads_create_entity({
65
+ "entityType": "adGroup",
66
+ "data": {
67
+ "AdGroups": [{
68
+ "Name": "Brand Keywords",
69
+ "CampaignId": {campaignId},
70
+ "CpcBid": { "Amount": 1.50 },
71
+ "Status": "Active"
72
+ }]
73
+ }
74
+ })
75
+ \`\`\`
76
+
77
+ ## Step 5: Add Keywords
78
+ \`\`\`json
79
+ msads_create_entity({
80
+ "entityType": "keyword",
81
+ "data": {
82
+ "Keywords": [
83
+ { "AdGroupId": {adGroupId}, "Text": "buy shoes", "MatchType": "Phrase", "Bid": { "Amount": 2.00 } },
84
+ { "AdGroupId": {adGroupId}, "Text": "shoes online", "MatchType": "Broad", "Bid": { "Amount": 1.50 } }
85
+ ]
86
+ }
87
+ })
88
+ \`\`\`
89
+
90
+ ## Step 6: Create Responsive Search Ad
91
+ \`\`\`json
92
+ msads_create_entity({
93
+ "entityType": "ad",
94
+ "data": {
95
+ "Ads": [{
96
+ "AdGroupId": {adGroupId},
97
+ "Type": "ResponsiveSearchAd",
98
+ "Headlines": [
99
+ { "Text": "Buy Shoes Online" },
100
+ { "Text": "Free Shipping Today" },
101
+ { "Text": "Great Deals on Shoes" }
102
+ ],
103
+ "Descriptions": [
104
+ { "Text": "Wide selection of shoes at great prices. Shop now!" },
105
+ { "Text": "Free returns on all orders. Order today!" }
106
+ ],
107
+ "FinalUrls": ["https://example.com/shoes"],
108
+ "Path1": "shoes",
109
+ "Path2": "sale"
110
+ }]
111
+ }
112
+ })
113
+ \`\`\`
114
+
115
+ ## Step 7: Add Ad Extensions
116
+ \`\`\`json
117
+ msads_manage_ad_extensions({
118
+ "operation": "associate",
119
+ "data": {
120
+ "AdExtensionIdToEntityIdAssociations": [
121
+ { "AdExtensionId": {extensionId}, "EntityId": {campaignId} }
122
+ ],
123
+ "AssociationType": "Campaign"
124
+ }
125
+ })
126
+ \`\`\`
127
+
128
+ ## Step 8: Activate Campaign
129
+ \`\`\`json
130
+ msads_update_entity({
131
+ "entityType": "campaign",
132
+ "data": { "Campaigns": [{ "Id": {campaignId}, "Status": "Active" }] }
133
+ })
134
+ \`\`\`
135
+
136
+ ## Success Checklist
137
+ - [ ] Budget created (if shared)
138
+ - [ ] Campaign created with correct type and settings
139
+ - [ ] Location and other targeting applied
140
+ - [ ] Ad group(s) created with appropriate bids
141
+ - [ ] Keywords added with match types
142
+ - [ ] Responsive search ad created
143
+ - [ ] Ad extensions associated
144
+ - [ ] Campaign activated
145
+ `;
146
+ }
147
+ //# 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,2BAA2B,GAAW;IACjD,IAAI,EAAE,+BAA+B;IACrC,WAAW,EAAE,2EAA2E;IACxF,SAAS,EAAE;QACT,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,0BAA0B,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC9E;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,4CAA4C;YACzD,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,+BAA+B,CAAC,IAA6B;IAC3E,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,QAAQ,CAAC;IAEpD,OAAO,qDAAqD,IAAI,EAAE,SAAS,IAAI,aAAa;;;;;;;;;;;;;;;;;;;;;;oBAsB1E,YAAY;;;;yBAIP,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwGpC,CAAC;AACF,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
2
+ export declare const googleImportWorkflowPrompt: Prompt;
3
+ export declare function getGoogleImportWorkflowMessage(args?: Record<string, string>): string;
4
+ //# sourceMappingURL=google-import-workflow.prompt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"google-import-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/google-import-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,0BAA0B,EAAE,MAUxC,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA6DpF"}
@@ -0,0 +1,73 @@
1
+ export const googleImportWorkflowPrompt = {
2
+ name: "msads_google_import_workflow",
3
+ description: "Guide for importing campaigns from Google Ads into Microsoft Advertising",
4
+ arguments: [
5
+ {
6
+ name: "googleAccountId",
7
+ description: "Google Ads customer ID (format: 123-456-7890)",
8
+ required: true,
9
+ },
10
+ ],
11
+ };
12
+ export function getGoogleImportWorkflowMessage(args) {
13
+ const googleAccountId = args?.googleAccountId || "{googleAccountId}";
14
+ return `# Google Ads Import Workflow
15
+
16
+ Import campaigns from Google Ads into Microsoft Advertising using the ImportJobs API.
17
+
18
+ ## Step 1: Create Import Job
19
+ \`\`\`json
20
+ msads_import_from_google({
21
+ "operation": "create",
22
+ "data": {
23
+ "ImportJobs": [{
24
+ "Type": "GoogleImportJob",
25
+ "GoogleAccountId": "${googleAccountId}",
26
+ "CampaignAdGroupIds": null,
27
+ "NewAccountNegativeKeywords": true,
28
+ "AutoDeviceBidOptimization": true
29
+ }]
30
+ }
31
+ })
32
+ \`\`\`
33
+
34
+ ## Step 2: Check Import Status
35
+ \`\`\`json
36
+ msads_import_from_google({
37
+ "operation": "getStatus",
38
+ "data": { "ImportJobIds": ["{importJobId}"] }
39
+ })
40
+ \`\`\`
41
+
42
+ ## Step 3: Review Results
43
+ \`\`\`json
44
+ msads_import_from_google({
45
+ "operation": "getResults",
46
+ "data": { "ImportJobId": "{importJobId}" }
47
+ })
48
+ \`\`\`
49
+
50
+ ## What Gets Imported
51
+ - Campaigns (Search, Shopping, DSA)
52
+ - Ad groups and keywords
53
+ - Text ads and responsive search ads
54
+ - Ad extensions (sitelinks, callouts, etc.)
55
+ - Audiences and remarketing lists
56
+ - Negative keywords
57
+
58
+ ## What Does NOT Import
59
+ - Performance Max campaigns
60
+ - Smart campaigns
61
+ - App campaigns
62
+ - Google-specific features (e.g., Gmail ads)
63
+
64
+ ## Post-Import Checklist
65
+ - [ ] Review imported campaigns for accuracy
66
+ - [ ] Adjust bids (Microsoft Ads auction differs from Google)
67
+ - [ ] Update tracking templates/URLs
68
+ - [ ] Add Microsoft Audience Network targeting
69
+ - [ ] Set appropriate budgets
70
+ - [ ] Activate campaigns when ready
71
+ `;
72
+ }
73
+ //# sourceMappingURL=google-import-workflow.prompt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"google-import-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/google-import-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,0BAA0B,GAAW;IAChD,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,0EAA0E;IACvF,SAAS,EAAE;QACT;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,+CAA+C;YAC5D,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,8BAA8B,CAAC,IAA6B;IAC1E,MAAM,eAAe,GAAG,IAAI,EAAE,eAAe,IAAI,mBAAmB,CAAC;IAErE,OAAO;;;;;;;;;;;4BAWmB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8C1C,CAAC;AACF,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
2
+ export declare const msadsReportingWorkflowPrompt: Prompt;
3
+ export declare function getMsAdsReportingWorkflowMessage(args?: Record<string, string>): string;
4
+ //# sourceMappingURL=reporting-workflow.prompt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reporting-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/reporting-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,4BAA4B,EAAE,MAI1C,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAiDtF"}
@@ -0,0 +1,55 @@
1
+ export const msadsReportingWorkflowPrompt = {
2
+ name: "msads_reporting_workflow",
3
+ description: "Guide for running Microsoft Advertising reports (blocking and non-blocking)",
4
+ arguments: [{ name: "accountId", description: "Microsoft Ads Account ID", required: true }],
5
+ };
6
+ export function getMsAdsReportingWorkflowMessage(args) {
7
+ const accountId = args?.accountId || "{accountId}";
8
+ return `# Microsoft Ads Reporting Workflow
9
+
10
+ ## Option A: Blocking (recommended for simple reports)
11
+ \`\`\`json
12
+ msads_get_report({
13
+ "reportType": "CampaignPerformanceReportRequest",
14
+ "accountId": "${accountId}",
15
+ "columns": ["CampaignName", "Impressions", "Clicks", "Spend", "Conversions"],
16
+ "startDate": "2026-01-01",
17
+ "endDate": "2026-01-31",
18
+ "aggregation": "Daily"
19
+ })
20
+ \`\`\`
21
+ This submits, polls, and downloads in one call.
22
+
23
+ ## Option B: Non-Blocking (for long-running reports)
24
+
25
+ ### Step 1: Submit
26
+ \`\`\`json
27
+ msads_submit_report({
28
+ "reportType": "KeywordPerformanceReportRequest",
29
+ "accountId": "${accountId}",
30
+ "columns": ["Keyword", "Impressions", "Clicks", "AverageCpc", "QualityScore"],
31
+ "startDate": "2026-01-01",
32
+ "endDate": "2026-03-31"
33
+ })
34
+ \`\`\`
35
+
36
+ ### Step 2: Check Status
37
+ \`\`\`json
38
+ msads_check_report_status({ "reportRequestId": "{id}" })
39
+ \`\`\`
40
+
41
+ ### Step 3: Download
42
+ \`\`\`json
43
+ msads_download_report({ "downloadUrl": "{url}" })
44
+ \`\`\`
45
+
46
+ ## Common Report Types
47
+ - **CampaignPerformanceReportRequest**: Campaign metrics
48
+ - **AdGroupPerformanceReportRequest**: Ad group metrics
49
+ - **KeywordPerformanceReportRequest**: Keyword metrics + quality scores
50
+ - **SearchQueryPerformanceReportRequest**: Search terms triggering ads
51
+ - **AudiencePerformanceReportRequest**: Audience targeting metrics
52
+ - **GeographicPerformanceReportRequest**: Location-based metrics
53
+ `;
54
+ }
55
+ //# sourceMappingURL=reporting-workflow.prompt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reporting-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/reporting-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,4BAA4B,GAAW;IAClD,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,6EAA6E;IAC1F,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,0BAA0B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;CAC5F,CAAC;AAEF,MAAM,UAAU,gCAAgC,CAAC,IAA6B;IAC5E,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,aAAa,CAAC;IAEnD,OAAO;;;;;;kBAMS,SAAS;;;;;;;;;;;;;;;kBAeT,SAAS;;;;;;;;;;;;;;;;;;;;;;;;CAwB1B,CAAC;AACF,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
2
+ export declare const msadsTroubleshootEntityPrompt: Prompt;
3
+ export declare function getMsAdsTroubleshootEntityMessage(args?: Record<string, string>): string;
4
+ //# sourceMappingURL=troubleshoot-entity.prompt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"troubleshoot-entity.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/troubleshoot-entity.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,6BAA6B,EAAE,MAW3C,CAAC;AAEF,wBAAgB,iCAAiC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAkCvF"}