@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,47 @@
1
+ export const msadsTroubleshootEntityPrompt = {
2
+ name: "msads_troubleshoot_entity",
3
+ description: "Troubleshoot issues with Microsoft Advertising entities",
4
+ arguments: [
5
+ {
6
+ name: "entityType",
7
+ description: "Entity type (campaign, adGroup, ad, keyword)",
8
+ required: true,
9
+ },
10
+ { name: "entityId", description: "Entity ID to troubleshoot", required: true },
11
+ ],
12
+ };
13
+ export function getMsAdsTroubleshootEntityMessage(args) {
14
+ const entityType = args?.entityType || "{entityType}";
15
+ const entityId = args?.entityId || "{entityId}";
16
+ return `# Troubleshoot Microsoft Ads Entity
17
+
18
+ ## Step 1: Fetch Entity Details
19
+ \`\`\`json
20
+ msads_get_entity({ "entityType": "${entityType}", "entityIds": ["${entityId}"] })
21
+ \`\`\`
22
+
23
+ ## Step 2: Check Status
24
+ Look for: Status (Active/Paused/Deleted), editorial status, delivery issues.
25
+
26
+ ## Step 3: Check Parent Entity
27
+ If this is an ad group, ad, or keyword, verify the parent entity is active.
28
+
29
+ ## Step 4: Review Performance
30
+ \`\`\`json
31
+ msads_get_report({
32
+ "reportType": "${entityType === "campaign" ? "CampaignPerformanceReportRequest" : entityType === "adGroup" ? "AdGroupPerformanceReportRequest" : entityType === "keyword" ? "KeywordPerformanceReportRequest" : "AdPerformanceReportRequest"}",
33
+ "accountId": "{accountId}",
34
+ "columns": ["Impressions", "Clicks", "Spend", "Conversions", "QualityScore"],
35
+ "startDate": "2026-01-01",
36
+ "endDate": "2026-01-31"
37
+ })
38
+ \`\`\`
39
+
40
+ ## Common Issues
41
+ - **Not serving**: Check budget, status, targeting, and payment method
42
+ - **Low quality score**: Improve ad relevance, expected CTR, or landing page
43
+ - **High CPC**: Review competition and consider bid adjustments
44
+ - **Disapproved ads**: Check editorial policies and ad content
45
+ `;
46
+ }
47
+ //# sourceMappingURL=troubleshoot-entity.prompt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"troubleshoot-entity.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/troubleshoot-entity.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,6BAA6B,GAAW;IACnD,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,yDAAyD;IACtE,SAAS,EAAE;QACT;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,8CAA8C;YAC3D,QAAQ,EAAE,IAAI;SACf;QACD,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,2BAA2B,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC/E;CACF,CAAC;AAEF,MAAM,UAAU,iCAAiC,CAAC,IAA6B;IAC7E,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,cAAc,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,YAAY,CAAC;IAEhD,OAAO;;;;oCAI2B,UAAU,qBAAqB,QAAQ;;;;;;;;;;;;mBAYxD,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,4BAA4B;;;;;;;;;;;;;CAa7O,CAAC;AACF,CAAC"}
@@ -0,0 +1,9 @@
1
+ import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
2
+ export interface PromptDefinition {
3
+ prompt: Prompt;
4
+ generateMessage: (args?: Record<string, string>) => string;
5
+ }
6
+ export declare const promptRegistry: Map<string, PromptDefinition>;
7
+ export declare function getAllPrompts(): Prompt[];
8
+ export declare function getPromptDefinition(name: string): PromptDefinition | undefined;
9
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/prompts/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAsBjE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC;CAC5D;AAED,eAAO,MAAM,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAoCvD,CAAC;AAEH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE9E"}
@@ -0,0 +1,49 @@
1
+ import { campaignSetupWorkflowPrompt, getCampaignSetupWorkflowMessage, } from "./definitions/campaign-setup-workflow.prompt.js";
2
+ import { msadsReportingWorkflowPrompt, getMsAdsReportingWorkflowMessage, } from "./definitions/reporting-workflow.prompt.js";
3
+ import { googleImportWorkflowPrompt, getGoogleImportWorkflowMessage, } from "./definitions/google-import-workflow.prompt.js";
4
+ import { msadsBulkOperationsWorkflowPrompt, getMsAdsBulkOperationsWorkflowMessage, } from "./definitions/bulk-operations-workflow.prompt.js";
5
+ import { msadsTroubleshootEntityPrompt, getMsAdsTroubleshootEntityMessage, } from "./definitions/troubleshoot-entity.prompt.js";
6
+ export const promptRegistry = new Map([
7
+ [
8
+ campaignSetupWorkflowPrompt.name,
9
+ {
10
+ prompt: campaignSetupWorkflowPrompt,
11
+ generateMessage: getCampaignSetupWorkflowMessage,
12
+ },
13
+ ],
14
+ [
15
+ msadsReportingWorkflowPrompt.name,
16
+ {
17
+ prompt: msadsReportingWorkflowPrompt,
18
+ generateMessage: getMsAdsReportingWorkflowMessage,
19
+ },
20
+ ],
21
+ [
22
+ googleImportWorkflowPrompt.name,
23
+ {
24
+ prompt: googleImportWorkflowPrompt,
25
+ generateMessage: getGoogleImportWorkflowMessage,
26
+ },
27
+ ],
28
+ [
29
+ msadsBulkOperationsWorkflowPrompt.name,
30
+ {
31
+ prompt: msadsBulkOperationsWorkflowPrompt,
32
+ generateMessage: getMsAdsBulkOperationsWorkflowMessage,
33
+ },
34
+ ],
35
+ [
36
+ msadsTroubleshootEntityPrompt.name,
37
+ {
38
+ prompt: msadsTroubleshootEntityPrompt,
39
+ generateMessage: getMsAdsTroubleshootEntityMessage,
40
+ },
41
+ ],
42
+ ]);
43
+ export function getAllPrompts() {
44
+ return Array.from(promptRegistry.values()).map((def) => def.prompt);
45
+ }
46
+ export function getPromptDefinition(name) {
47
+ return promptRegistry.get(name);
48
+ }
49
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/prompts/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,iCAAiC,EACjC,qCAAqC,GACtC,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,6CAA6C,CAAC;AAOrD,MAAM,CAAC,MAAM,cAAc,GAAkC,IAAI,GAAG,CAAC;IACnE;QACE,2BAA2B,CAAC,IAAI;QAChC;YACE,MAAM,EAAE,2BAA2B;YACnC,eAAe,EAAE,+BAA+B;SACjD;KACF;IACD;QACE,4BAA4B,CAAC,IAAI;QACjC;YACE,MAAM,EAAE,4BAA4B;YACpC,eAAe,EAAE,gCAAgC;SAClD;KACF;IACD;QACE,0BAA0B,CAAC,IAAI;QAC/B;YACE,MAAM,EAAE,0BAA0B;YAClC,eAAe,EAAE,8BAA8B;SAChD;KACF;IACD;QACE,iCAAiC,CAAC,IAAI;QACtC;YACE,MAAM,EAAE,iCAAiC;YACzC,eAAe,EAAE,qCAAqC;SACvD;KACF;IACD;QACE,6BAA6B,CAAC,IAAI;QAClC;YACE,MAAM,EAAE,6BAA6B;YACrC,eAAe,EAAE,iCAAiC;SACnD;KACF;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Resource } from "../types.js";
2
+ export declare const entityExampleAllResource: Resource;
3
+ export declare const entityExampleResources: Resource[];
4
+ //# sourceMappingURL=entity-examples.resource.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entity-examples.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-examples.resource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,wBAAwB,EAAE,QAiFtC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,QAAQ,EAAO,CAAC"}
@@ -0,0 +1,84 @@
1
+ export const entityExampleAllResource = {
2
+ uri: "msads://entity-examples",
3
+ name: "Microsoft Ads Entity Examples (All)",
4
+ description: "Example payloads for all Microsoft Ads entity types",
5
+ mimeType: "text/markdown",
6
+ getContent: () => `# Microsoft Ads Entity Examples
7
+
8
+ ## Campaign
9
+ \`\`\`json
10
+ {
11
+ "Campaigns": [{
12
+ "Name": "Summer Sale 2026",
13
+ "BudgetType": "DailyBudgetStandard",
14
+ "DailyBudget": 50.00,
15
+ "TimeZone": "EasternTimeUSCanada",
16
+ "CampaignType": "Search",
17
+ "Languages": ["English"],
18
+ "Status": "Paused"
19
+ }]
20
+ }
21
+ \`\`\`
22
+
23
+ ## Ad Group
24
+ \`\`\`json
25
+ {
26
+ "AdGroups": [{
27
+ "Name": "Brand Keywords",
28
+ "CampaignId": 123456789,
29
+ "CpcBid": { "Amount": 1.50 },
30
+ "Language": "English",
31
+ "Status": "Active"
32
+ }]
33
+ }
34
+ \`\`\`
35
+
36
+ ## Keyword
37
+ \`\`\`json
38
+ {
39
+ "Keywords": [{
40
+ "AdGroupId": 987654321,
41
+ "Text": "buy shoes online",
42
+ "MatchType": "Phrase",
43
+ "Bid": { "Amount": 2.00 },
44
+ "Status": "Active"
45
+ }]
46
+ }
47
+ \`\`\`
48
+
49
+ ## Responsive Search Ad
50
+ \`\`\`json
51
+ {
52
+ "Ads": [{
53
+ "AdGroupId": 987654321,
54
+ "Type": "ResponsiveSearchAd",
55
+ "Headlines": [
56
+ { "Text": "Buy Shoes Online", "PinnedField": "Headline1" },
57
+ { "Text": "Free Shipping Available" },
58
+ { "Text": "Summer Sale - 30% Off" }
59
+ ],
60
+ "Descriptions": [
61
+ { "Text": "Shop our wide selection of shoes. Free returns on all orders." },
62
+ { "Text": "Top brands at great prices. Order today!" }
63
+ ],
64
+ "FinalUrls": ["https://example.com/shoes"],
65
+ "Path1": "shoes",
66
+ "Path2": "sale"
67
+ }]
68
+ }
69
+ \`\`\`
70
+
71
+ ## Budget
72
+ \`\`\`json
73
+ {
74
+ "Budgets": [{
75
+ "Name": "Shared Monthly Budget",
76
+ "Amount": 1000.00,
77
+ "BudgetType": "MonthlyBudgetSpendUntilDepleted"
78
+ }]
79
+ }
80
+ \`\`\`
81
+ `,
82
+ };
83
+ export const entityExampleResources = [];
84
+ //# sourceMappingURL=entity-examples.resource.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entity-examples.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-examples.resource.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,wBAAwB,GAAa;IAChD,GAAG,EAAE,yBAAyB;IAC9B,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE,qDAAqD;IAClE,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2EnB;CACA,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAe,EAAE,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { Resource } from "../types.js";
2
+ export declare const entityHierarchyResource: Resource;
3
+ //# sourceMappingURL=entity-hierarchy.resource.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entity-hierarchy.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-hierarchy.resource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,uBAAuB,EAAE,QAqDrC,CAAC"}
@@ -0,0 +1,54 @@
1
+ export const entityHierarchyResource = {
2
+ uri: "msads://entity-hierarchy",
3
+ name: "Microsoft Ads Entity Hierarchy",
4
+ description: "Entity relationships and API operation patterns for Microsoft Advertising API v13 JSON endpoints",
5
+ mimeType: "text/markdown",
6
+ getContent: () => `# Microsoft Advertising Entity Hierarchy
7
+
8
+ ## Entity Relationships
9
+
10
+ \`\`\`
11
+ Account
12
+ ├── Campaign (Search, Shopping, Audience, Performance Max)
13
+ │ ├── AdGroup
14
+ │ │ ├── Ad (ExpandedText, Responsive, DynamicSearch, etc.)
15
+ │ │ └── Keyword (with match types: Broad, Phrase, Exact)
16
+ │ └── CampaignCriterion (Location, Device, Schedule, Age, Gender)
17
+ ├── Budget (shared across campaigns)
18
+ ├── AdExtension (Sitelink, Callout, Call, StructuredSnippet, etc.)
19
+ ├── Audience (Remarketing, Custom, InMarket, Similar)
20
+ └── Label (organizational tagging)
21
+ \`\`\`
22
+
23
+ ## API Pattern: JSON Collection And Query Endpoints
24
+
25
+ Microsoft Ads JSON API v13 uses POST for all operations:
26
+
27
+ | Operation | Pattern | Example |
28
+ |-----------|---------|---------|
29
+ | Create | \`/{Entity}\` | \`/Campaigns\` |
30
+ | Read (by account) | \`/{Entity}/QueryByAccountId\` | \`/Campaigns/QueryByAccountId\` |
31
+ | Read (by parent) | \`/{Entity}/QueryBy{Parent}Id\` | \`/AdGroups/QueryByCampaignId\` |
32
+ | Read (by IDs) | \`/{Entity}/QueryByIds\` | \`/Campaigns/QueryByIds\` |
33
+ | Update | \`/{Entity}\` | \`/Campaigns\` |
34
+ | Delete | \`/{Entity}\` | \`/Campaigns\` |
35
+
36
+ ## Auth Headers (all requests)
37
+
38
+ | Header | Description |
39
+ |--------|-------------|
40
+ | \`Authorization\` | OAuth2 access token prefixed with \`Bearer \` |
41
+ | \`DeveloperToken\` | Per-app developer token |
42
+ | \`CustomerId\` | Manager account ID |
43
+ | \`CustomerAccountId\` | Ad account ID |
44
+
45
+ ## Campaign Types
46
+
47
+ - **Search**: Text ads on Bing search results
48
+ - **Shopping**: Product ads from merchant center
49
+ - **Audience**: Display/native ads on Microsoft Audience Network
50
+ - **Performance Max**: AI-optimized across all Microsoft surfaces
51
+ - **Dynamic Search Ads**: Auto-generated from website content
52
+ `,
53
+ };
54
+ //# sourceMappingURL=entity-hierarchy.resource.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entity-hierarchy.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-hierarchy.resource.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,GAAG,EAAE,0BAA0B;IAC/B,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,kGAAkG;IACpG,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CnB;CACA,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Resource } from "../types.js";
2
+ export declare const entitySchemaAllResource: Resource;
3
+ export declare const entitySchemaResources: Resource[];
4
+ //# sourceMappingURL=entity-schemas.resource.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entity-schemas.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-schemas.resource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,eAAO,MAAM,uBAAuB,EAAE,QAarC,CAAC;AAwCF,eAAO,MAAM,qBAAqB,EAAE,QAAQ,EAE3C,CAAC"}
@@ -0,0 +1,54 @@
1
+ import { getSupportedEntityTypes, getEntityConfig } from "../../tools/utils/entity-mapping.js";
2
+ export const entitySchemaAllResource = {
3
+ uri: "msads://entity-schemas",
4
+ name: "Microsoft Ads Entity Schemas (All)",
5
+ description: "Schema overview for all Microsoft Ads entity types",
6
+ mimeType: "text/markdown",
7
+ getContent: () => {
8
+ const types = getSupportedEntityTypes();
9
+ const lines = types.map((t) => {
10
+ const config = getEntityConfig(t);
11
+ return `- **${t}** (${config.displayName}): ID field \`${config.idField}\`, plural \`${config.pluralName}\`, batch limit ${config.batchLimit}`;
12
+ });
13
+ return `# Microsoft Ads Entity Schemas\n\n${lines.join("\n")}\n\nSee individual entity-schema resources for detailed field information.`;
14
+ },
15
+ };
16
+ function createEntitySchemaResource(entityType) {
17
+ const config = getEntityConfig(entityType);
18
+ return {
19
+ uri: `msads://entity-schema/${entityType}`,
20
+ name: `Microsoft Ads ${config.displayName} Schema`,
21
+ description: `Field schema for ${config.displayName} entities`,
22
+ mimeType: "text/markdown",
23
+ getContent: () => `# ${config.displayName} Schema
24
+
25
+ ## API Operations
26
+ - **Add**: \`${config.addOperation}\`
27
+ - **GetByIds**: \`${config.getByIdsOperation}\`
28
+ - **Update**: \`${config.updateOperation}\`
29
+ - **Delete**: \`${config.deleteOperation}\`
30
+ ${config.getByAccountOperation ? `- **GetByAccount**: \`${config.getByAccountOperation}\`` : ""}
31
+ ${config.getByParentOperation ? `- **GetByParent**: \`${config.getByParentOperation}\` (parent field: \`${config.parentIdField}\`)` : ""}
32
+
33
+ ## Key Fields
34
+ - **Id** (long): Entity identifier (read-only after creation)
35
+ - **Status** (string): Active, Paused, or Deleted
36
+ ${config.parentIdField ? `- **${config.parentIdField}** (long): Parent entity ID` : ""}
37
+
38
+ ## Batch Limits
39
+ - Maximum ${config.batchLimit} entities per Add/Update call
40
+
41
+ ## Request Format
42
+ Wrap entities in \`${config.pluralName}\` array:
43
+ \`\`\`json
44
+ {
45
+ "${config.pluralName}": [
46
+ { "Id": 123, "Status": "Active" }
47
+ ]
48
+ }
49
+ \`\`\`
50
+ `,
51
+ };
52
+ }
53
+ export const entitySchemaResources = getSupportedEntityTypes().map(createEntitySchemaResource);
54
+ //# sourceMappingURL=entity-schemas.resource.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entity-schemas.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-schemas.resource.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE/F,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,GAAG,EAAE,wBAAwB;IAC7B,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EAAE,oDAAoD;IACjE,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE;QACf,MAAM,KAAK,GAAG,uBAAuB,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;YAClC,OAAO,OAAO,CAAC,OAAO,MAAM,CAAC,WAAW,iBAAiB,MAAM,CAAC,OAAO,gBAAgB,MAAM,CAAC,UAAU,mBAAmB,MAAM,CAAC,UAAU,EAAE,CAAC;QACjJ,CAAC,CAAC,CAAC;QACH,OAAO,qCAAqC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,4EAA4E,CAAC;IAC3I,CAAC;CACF,CAAC;AAEF,SAAS,0BAA0B,CAAC,UAAkB;IACpD,MAAM,MAAM,GAAG,eAAe,CAAC,UAAiB,CAAC,CAAC;IAClD,OAAO;QACL,GAAG,EAAE,yBAAyB,UAAU,EAAE;QAC1C,IAAI,EAAE,iBAAiB,MAAM,CAAC,WAAW,SAAS;QAClD,WAAW,EAAE,oBAAoB,MAAM,CAAC,WAAW,WAAW;QAC9D,QAAQ,EAAE,eAAe;QACzB,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,WAAW;;;eAG9B,MAAM,CAAC,YAAY;oBACd,MAAM,CAAC,iBAAiB;kBAC1B,MAAM,CAAC,eAAe;kBACtB,MAAM,CAAC,eAAe;EACtC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,yBAAyB,MAAM,CAAC,qBAAqB,IAAI,CAAC,CAAC,CAAC,EAAE;EAC7F,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,wBAAwB,MAAM,CAAC,oBAAoB,uBAAuB,MAAM,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,EAAE;;;;;EAKtI,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,aAAa,6BAA6B,CAAC,CAAC,CAAC,EAAE;;;YAG1E,MAAM,CAAC,UAAU;;;qBAGR,MAAM,CAAC,UAAU;;;KAGjC,MAAM,CAAC,UAAU;;;;;CAKrB;KACE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAe,uBAAuB,EAAE,CAAC,GAAG,CAC5E,0BAA0B,CAC3B,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { TemplatedResourceDefinition } from "@cesteral/shared";
2
+ export declare const fieldRulesResource: TemplatedResourceDefinition;
3
+ //# sourceMappingURL=field-rules.resource.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"field-rules.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/field-rules.resource.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAQpE,eAAO,MAAM,kBAAkB,EAAE,2BA4BhC,CAAC"}
@@ -0,0 +1,28 @@
1
+ import { getEntityTypeEnum, getSupportedEntityTypes, } from "../../tools/utils/entity-mapping.js";
2
+ import { getFieldRulesForEntity } from "../utils/field-rules.js";
3
+ export const fieldRulesResource = {
4
+ uriTemplate: "msads-field-rules://{entityType}",
5
+ name: "Microsoft Ads Field Rules",
6
+ description: "Enum field rules per Microsoft Ads entity type. " +
7
+ `Valid {entityType}: ${getEntityTypeEnum().join(", ")}.`,
8
+ mimeType: "application/json",
9
+ resolveContent: (_uri, variables) => {
10
+ const raw = variables.entityType;
11
+ const entityType = (Array.isArray(raw) ? raw[0] : raw);
12
+ if (!entityType) {
13
+ throw new Error("msads-field-rules: missing {entityType} in URI");
14
+ }
15
+ if (!getSupportedEntityTypes().includes(entityType)) {
16
+ throw new Error(`msads-field-rules: unknown entityType "${entityType}". ` +
17
+ `Supported: ${getSupportedEntityTypes().join(", ")}.`);
18
+ }
19
+ return JSON.stringify(getFieldRulesForEntity(entityType), null, 2);
20
+ },
21
+ list: async () => getSupportedEntityTypes().map((t) => ({
22
+ uri: `msads-field-rules://${t}`,
23
+ name: `Microsoft Ads field rules — ${t}`,
24
+ description: `Enum field rules for Microsoft Ads ${t}`,
25
+ mimeType: "application/json",
26
+ })),
27
+ };
28
+ //# sourceMappingURL=field-rules.resource.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"field-rules.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/field-rules.resource.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,WAAW,EAAE,kCAAkC;IAC/C,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,kDAAkD;QAClD,uBAAuB,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;IAC1D,QAAQ,EAAE,kBAAkB;IAC5B,cAAc,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;QAClC,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC;QACjC,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAgC,CAAC;QACtF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,uBAAuB,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,0CAA0C,UAAU,KAAK;gBACvD,cAAc,uBAAuB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACxD,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,EAAE,KAAK,IAAI,EAAE,CACf,uBAAuB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,EAAE,uBAAuB,CAAC,EAAE;QAC/B,IAAI,EAAE,+BAA+B,CAAC,EAAE;QACxC,WAAW,EAAE,sCAAsC,CAAC,EAAE;QACtD,QAAQ,EAAE,kBAAkB;KAC7B,CAAC,CAAC;CACN,CAAC"}
@@ -0,0 +1,7 @@
1
+ export { entityHierarchyResource } from "./entity-hierarchy.resource.js";
2
+ export { entitySchemaResources, entitySchemaAllResource } from "./entity-schemas.resource.js";
3
+ export { entityExampleResources, entityExampleAllResource } from "./entity-examples.resource.js";
4
+ export { reportingReferenceResource } from "./reporting-reference.resource.js";
5
+ import type { Resource } from "../types.js";
6
+ export declare const allResources: Resource[];
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAQ/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA6D5C,eAAO,MAAM,YAAY,EAAE,QAAQ,EASlC,CAAC"}
@@ -0,0 +1,79 @@
1
+ export { entityHierarchyResource } from "./entity-hierarchy.resource.js";
2
+ export { entitySchemaResources, entitySchemaAllResource } from "./entity-schemas.resource.js";
3
+ export { entityExampleResources, entityExampleAllResource } from "./entity-examples.resource.js";
4
+ export { reportingReferenceResource } from "./reporting-reference.resource.js";
5
+ import { entityHierarchyResource } from "./entity-hierarchy.resource.js";
6
+ import { entitySchemaResources, entitySchemaAllResource } from "./entity-schemas.resource.js";
7
+ import { entityExampleResources, entityExampleAllResource } from "./entity-examples.resource.js";
8
+ import { reportingReferenceResource } from "./reporting-reference.resource.js";
9
+ import { productionTools as allTools } from "../../tools/definitions/index.js";
10
+ import { createToolExamplesResource, createServerCapabilitiesResource } from "@cesteral/shared";
11
+ const toolExamplesResource = createToolExamplesResource(allTools, "msads-mcp");
12
+ const serverCapabilitiesResource = createServerCapabilitiesResource({
13
+ serverName: "msads-mcp",
14
+ allTools,
15
+ toolGroups: {
16
+ account: ["msads_list_accounts"],
17
+ crud: [
18
+ "msads_list_entities",
19
+ "msads_get_entity",
20
+ "msads_create_entity",
21
+ "msads_update_entity",
22
+ "msads_delete_entity",
23
+ ],
24
+ reporting: [
25
+ "msads_get_report",
26
+ "msads_get_report_breakdowns",
27
+ "msads_submit_report",
28
+ "msads_check_report_status",
29
+ "msads_download_report",
30
+ ],
31
+ reportSchedules: [
32
+ "msads_create_report_schedule",
33
+ "msads_list_report_schedules",
34
+ "msads_delete_report_schedule",
35
+ ],
36
+ bulk: [
37
+ "msads_bulk_create_entities",
38
+ "msads_bulk_update_entities",
39
+ "msads_bulk_update_status",
40
+ "msads_adjust_bids",
41
+ ],
42
+ targeting: ["msads_manage_criterions", "msads_manage_ad_extensions", "msads_search_targeting"],
43
+ specialized: ["msads_get_ad_details", "msads_import_from_google"],
44
+ validation: ["msads_validate_entity"],
45
+ discovery: ["msads_search_tools"],
46
+ },
47
+ commonWorkflows: [
48
+ "campaign_setup",
49
+ "async_reporting",
50
+ "report_schedule_management",
51
+ "google_import",
52
+ ],
53
+ discoveryFlow: [
54
+ "Read server-capabilities://msads-mcp/overview to choose a capability group.",
55
+ "Call msads_list_accounts to discover accessible CustomerId/AccountId pairs.",
56
+ "Read entity-hierarchy://all and entity-schema://{entityType} before entity writes.",
57
+ "Read reporting-reference://all before report tools or schedule management.",
58
+ "Use tool-examples://msads-mcp/all only when concrete payload examples are needed.",
59
+ ],
60
+ relatedResources: [
61
+ "entity-hierarchy://all",
62
+ "entity-schema://all",
63
+ "entity-examples://all",
64
+ "reporting-reference://all",
65
+ "tool-examples://msads-mcp/all",
66
+ ],
67
+ startHere: "msads_list_accounts",
68
+ });
69
+ export const allResources = [
70
+ entityHierarchyResource,
71
+ entitySchemaAllResource,
72
+ ...entitySchemaResources,
73
+ entityExampleAllResource,
74
+ ...entityExampleResources,
75
+ reportingReferenceResource,
76
+ ...(toolExamplesResource ? [toolExamplesResource] : []),
77
+ serverCapabilitiesResource,
78
+ ];
79
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAE/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,eAAe,IAAI,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAGhG,MAAM,oBAAoB,GAAG,0BAA0B,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC/E,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;IAClE,UAAU,EAAE,WAAW;IACvB,QAAQ;IACR,UAAU,EAAE;QACV,OAAO,EAAE,CAAC,qBAAqB,CAAC;QAChC,IAAI,EAAE;YACJ,qBAAqB;YACrB,kBAAkB;YAClB,qBAAqB;YACrB,qBAAqB;YACrB,qBAAqB;SACtB;QACD,SAAS,EAAE;YACT,kBAAkB;YAClB,6BAA6B;YAC7B,qBAAqB;YACrB,2BAA2B;YAC3B,uBAAuB;SACxB;QACD,eAAe,EAAE;YACf,8BAA8B;YAC9B,6BAA6B;YAC7B,8BAA8B;SAC/B;QACD,IAAI,EAAE;YACJ,4BAA4B;YAC5B,4BAA4B;YAC5B,0BAA0B;YAC1B,mBAAmB;SACpB;QACD,SAAS,EAAE,CAAC,yBAAyB,EAAE,4BAA4B,EAAE,wBAAwB,CAAC;QAC9F,WAAW,EAAE,CAAC,sBAAsB,EAAE,0BAA0B,CAAC;QACjE,UAAU,EAAE,CAAC,uBAAuB,CAAC;QACrC,SAAS,EAAE,CAAC,oBAAoB,CAAC;KAClC;IACD,eAAe,EAAE;QACf,gBAAgB;QAChB,iBAAiB;QACjB,4BAA4B;QAC5B,eAAe;KAChB;IACD,aAAa,EAAE;QACb,6EAA6E;QAC7E,6EAA6E;QAC7E,oFAAoF;QACpF,4EAA4E;QAC5E,mFAAmF;KACpF;IACD,gBAAgB,EAAE;QAChB,wBAAwB;QACxB,qBAAqB;QACrB,uBAAuB;QACvB,2BAA2B;QAC3B,+BAA+B;KAChC;IACD,SAAS,EAAE,qBAAqB;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,uBAAuB;IACvB,uBAAuB;IACvB,GAAG,qBAAqB;IACxB,wBAAwB;IACxB,GAAG,sBAAsB;IACzB,0BAA0B;IAC1B,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,oBAA2C,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,0BAAiD;CAClD,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { Resource } from "../types.js";
2
+ export declare const reportingReferenceResource: Resource;
3
+ //# sourceMappingURL=reporting-reference.resource.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reporting-reference.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/reporting-reference.resource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,0BAA0B,EAAE,QA8DxC,CAAC"}
@@ -0,0 +1,64 @@
1
+ export const reportingReferenceResource = {
2
+ uri: "msads://reporting-reference",
3
+ name: "Microsoft Ads Reporting Reference",
4
+ description: "Report types, columns, and async reporting flow for Microsoft Advertising",
5
+ mimeType: "text/markdown",
6
+ getContent: () => `# Microsoft Ads Reporting Reference
7
+
8
+ ## Async Reporting Flow
9
+
10
+ 1. **Submit**: POST \`/GenerateReport/Submit\` → returns \`ReportRequestId\`
11
+ 2. **Poll**: POST \`/GenerateReport/Poll\` → returns \`Status\` + \`ReportDownloadUrl\`
12
+ 3. **Download**: GET download URL → CSV/TSV data
13
+
14
+ Statuses: \`Pending\` → \`InProgress\` → \`Success\` | \`Error\`
15
+
16
+ ## Report Types
17
+
18
+ | Report Type | Description |
19
+ |-------------|-------------|
20
+ | CampaignPerformanceReportRequest | Campaign-level metrics |
21
+ | AdGroupPerformanceReportRequest | Ad group-level metrics |
22
+ | AdPerformanceReportRequest | Ad-level metrics |
23
+ | KeywordPerformanceReportRequest | Keyword-level metrics |
24
+ | SearchQueryPerformanceReportRequest | Search term report |
25
+ | AudiencePerformanceReportRequest | Audience targeting metrics |
26
+ | GeographicPerformanceReportRequest | Geographic performance |
27
+ | ShareOfVoiceReportRequest | Impression share metrics |
28
+ | ProductDimensionPerformanceReportRequest | Shopping product data |
29
+ | DSAAutoTargetPerformanceReportRequest | Dynamic search ads targets |
30
+
31
+ ## Common Columns
32
+
33
+ ### Attributes
34
+ \`CampaignName\`, \`CampaignId\`, \`AdGroupName\`, \`AdGroupId\`, \`AdId\`, \`Keyword\`, \`TimePeriod\`
35
+
36
+ ### Performance Metrics
37
+ \`Impressions\`, \`Clicks\`, \`Spend\`, \`Conversions\`, \`Revenue\`, \`CostPerConversion\`
38
+
39
+ ### Rate Metrics
40
+ \`Ctr\`, \`AverageCpc\`, \`AverageCpm\`, \`ConversionRate\`
41
+
42
+ ### Competitive Metrics
43
+ \`ImpressionSharePercent\`, \`ClickSharePercent\`, \`AbsoluteTopImpressionSharePercent\`
44
+
45
+ ### Quality
46
+ \`QualityScore\`, \`ExpectedCtr\`, \`AdRelevance\`, \`LandingPageExperience\`
47
+
48
+ ## Aggregation Options
49
+ \`Daily\`, \`Weekly\`, \`Monthly\`, \`Hourly\`, \`DayOfWeek\`, \`HourOfDay\`, \`Summary\`
50
+
51
+ ## Example Tool Call
52
+ \`\`\`json
53
+ {
54
+ "reportType": "CampaignPerformanceReportRequest",
55
+ "accountId": "123456789",
56
+ "columns": ["CampaignName", "Impressions", "Clicks", "Spend", "Conversions"],
57
+ "startDate": "2026-01-01",
58
+ "endDate": "2026-01-31",
59
+ "aggregation": "Daily"
60
+ }
61
+ \`\`\`
62
+ `,
63
+ };
64
+ //# sourceMappingURL=reporting-reference.resource.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reporting-reference.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/reporting-reference.resource.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,0BAA0B,GAAa;IAClD,GAAG,EAAE,6BAA6B;IAClC,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE,2EAA2E;IACxF,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDnB;CACA,CAAC"}
@@ -0,0 +1,3 @@
1
+ export type { Resource } from "./types.js";
2
+ export { allResources } from "./definitions/index.js";
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/resources/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { allResources } from "./definitions/index.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/resources/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}
@@ -0,0 +1,8 @@
1
+ export interface Resource {
2
+ uri: string;
3
+ name: string;
4
+ description: string;
5
+ mimeType: string;
6
+ getContent: () => string;
7
+ }
8
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/resources/types.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,MAAM,CAAC;CAC1B"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mcp-server/resources/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,9 @@
1
+ import type { FieldRule } from "@cesteral/shared";
2
+ import type { MsAdsEntityType } from "../../tools/utils/entity-mapping.js";
3
+ export declare const MSADS_ENUMS_BY_ENTITY: Partial<Record<MsAdsEntityType, FieldRule[]>>;
4
+ export interface MsAdsEntityFieldRules {
5
+ entityType: MsAdsEntityType;
6
+ enumRules: FieldRule[];
7
+ }
8
+ export declare function getFieldRulesForEntity(entityType: MsAdsEntityType): MsAdsEntityFieldRules;
9
+ //# sourceMappingURL=field-rules.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"field-rules.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/utils/field-rules.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,EAAE,CAAC,CAkG/E,CAAC;AAMF,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,eAAe,CAAC;IAC5B,SAAS,EAAE,SAAS,EAAE,CAAC;CACxB;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,eAAe,GAAG,qBAAqB,CAKzF"}