@cesteral/msads-mcp 1.2.0 → 2.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 (223) hide show
  1. package/README.md +44 -30
  2. package/dist/auth/msads-auth-adapter.d.ts.map +1 -1
  3. package/dist/auth/msads-auth-adapter.js +1 -1
  4. package/dist/auth/msads-auth-adapter.js.map +1 -1
  5. package/dist/cesteral-manifest.json +140 -4
  6. package/dist/config/index.d.ts +36 -67
  7. package/dist/config/index.d.ts.map +1 -1
  8. package/dist/index.js +13 -23
  9. package/dist/index.js.map +1 -1
  10. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +1 -1
  11. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -1
  12. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +9 -3
  13. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -1
  14. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +1 -1
  15. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -1
  16. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +5 -3
  17. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -1
  18. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +1 -1
  19. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -1
  20. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +9 -6
  21. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js.map +1 -1
  22. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +1 -1
  23. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -1
  24. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +1 -1
  25. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -1
  26. package/dist/mcp-server/prompts/index.d.ts +1 -1
  27. package/dist/mcp-server/prompts/index.d.ts.map +1 -1
  28. package/dist/mcp-server/prompts/index.js +15 -0
  29. package/dist/mcp-server/prompts/index.js.map +1 -1
  30. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -1
  31. package/dist/mcp-server/resources/definitions/entity-examples.resource.js +16 -7
  32. package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -1
  33. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
  34. package/dist/mcp-server/resources/definitions/index.js +10 -9
  35. package/dist/mcp-server/resources/definitions/index.js.map +1 -1
  36. package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -1
  37. package/dist/mcp-server/resources/utils/field-rules.js +11 -11
  38. package/dist/mcp-server/resources/utils/field-rules.js.map +1 -1
  39. package/dist/mcp-server/server.d.ts +2 -1
  40. package/dist/mcp-server/server.d.ts.map +1 -1
  41. package/dist/mcp-server/server.js +29 -99
  42. package/dist/mcp-server/server.js.map +1 -1
  43. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +46 -111
  44. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -1
  45. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +158 -15
  46. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -1
  47. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +51 -44
  48. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -1
  49. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +125 -9
  50. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -1
  51. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +51 -51
  52. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -1
  53. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +132 -7
  54. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -1
  55. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +65 -97
  56. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -1
  57. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +128 -7
  58. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -1
  59. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +24 -62
  60. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -1
  61. package/dist/mcp-server/tools/definitions/check-report-status.tool.js +4 -0
  62. package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -1
  63. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +47 -35
  64. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -1
  65. package/dist/mcp-server/tools/definitions/create-entity.tool.js +99 -3
  66. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -1
  67. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +51 -100
  68. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -1
  69. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +113 -33
  70. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -1
  71. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +47 -53
  72. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -1
  73. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +129 -8
  74. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -1
  75. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +34 -40
  76. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -1
  77. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +79 -25
  78. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -1
  79. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +84 -214
  80. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -1
  81. package/dist/mcp-server/tools/definitions/download-report.tool.js +7 -2
  82. package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -1
  83. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +105 -0
  84. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
  85. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +171 -0
  86. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
  87. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +12 -32
  88. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -1
  89. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +6 -2
  90. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -1
  91. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +24 -244
  92. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -1
  93. package/dist/mcp-server/tools/definitions/get-entity.tool.js +41 -67
  94. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -1
  95. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts +2 -0
  96. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map +1 -0
  97. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js +20 -0
  98. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map +1 -0
  99. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +104 -204
  100. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -1
  101. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +9 -0
  102. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -1
  103. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +100 -188
  104. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -1
  105. package/dist/mcp-server/tools/definitions/get-report.tool.js +9 -1
  106. package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -1
  107. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +57 -0
  108. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
  109. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +97 -0
  110. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
  111. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +49 -38
  112. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -1
  113. package/dist/mcp-server/tools/definitions/import-from-google.tool.js +101 -10
  114. package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -1
  115. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  116. package/dist/mcp-server/tools/definitions/index.js +6 -0
  117. package/dist/mcp-server/tools/definitions/index.js.map +1 -1
  118. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +14 -90
  119. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -1
  120. package/dist/mcp-server/tools/definitions/list-accounts.tool.js +5 -1
  121. package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -1
  122. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +18 -70
  123. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -1
  124. package/dist/mcp-server/tools/definitions/list-entities.tool.js +9 -2
  125. package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -1
  126. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +5 -16
  127. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -1
  128. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +4 -3
  129. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -1
  130. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +46 -37
  131. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -1
  132. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +106 -6
  133. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -1
  134. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +58 -47
  135. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -1
  136. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +111 -8
  137. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -1
  138. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +17 -40
  139. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -1
  140. package/dist/mcp-server/tools/definitions/search-targeting.tool.js +12 -19
  141. package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -1
  142. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +57 -89
  143. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -1
  144. package/dist/mcp-server/tools/definitions/submit-report.tool.js +97 -2
  145. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -1
  146. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +39 -1907
  147. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -1
  148. package/dist/mcp-server/tools/definitions/update-entity.tool.js +74 -85
  149. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -1
  150. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +45 -116
  151. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -1
  152. package/dist/mcp-server/tools/definitions/validate-entity.tool.js +3 -2
  153. package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -1
  154. package/dist/mcp-server/tools/index.d.ts +4 -1
  155. package/dist/mcp-server/tools/index.d.ts.map +1 -1
  156. package/dist/mcp-server/tools/index.js +7 -1
  157. package/dist/mcp-server/tools/index.js.map +1 -1
  158. package/dist/mcp-server/tools/utils/bulk-capacity.d.ts +9 -0
  159. package/dist/mcp-server/tools/utils/bulk-capacity.d.ts.map +1 -0
  160. package/dist/mcp-server/tools/utils/bulk-capacity.js +96 -0
  161. package/dist/mcp-server/tools/utils/bulk-capacity.js.map +1 -0
  162. package/dist/mcp-server/tools/utils/capture-snapshot.d.ts +5 -2
  163. package/dist/mcp-server/tools/utils/capture-snapshot.d.ts.map +1 -1
  164. package/dist/mcp-server/tools/utils/capture-snapshot.js +38 -19
  165. package/dist/mcp-server/tools/utils/capture-snapshot.js.map +1 -1
  166. package/dist/mcp-server/tools/utils/dry-run.d.ts +17 -2
  167. package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -1
  168. package/dist/mcp-server/tools/utils/dry-run.js +71 -6
  169. package/dist/mcp-server/tools/utils/dry-run.js.map +1 -1
  170. package/dist/mcp-server/tools/utils/entity-mapping.d.ts +27 -0
  171. package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -1
  172. package/dist/mcp-server/tools/utils/entity-mapping.js +105 -0
  173. package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -1
  174. package/dist/mcp-server/tools/utils/parent-ids.d.ts +16 -0
  175. package/dist/mcp-server/tools/utils/parent-ids.d.ts.map +1 -0
  176. package/dist/mcp-server/tools/utils/parent-ids.js +28 -0
  177. package/dist/mcp-server/tools/utils/parent-ids.js.map +1 -0
  178. package/dist/mcp-server/tools/utils/targeting-values.d.ts +9 -0
  179. package/dist/mcp-server/tools/utils/targeting-values.d.ts.map +1 -0
  180. package/dist/mcp-server/tools/utils/targeting-values.js +16 -0
  181. package/dist/mcp-server/tools/utils/targeting-values.js.map +1 -0
  182. package/dist/mcp-server/transports/streamable-http-transport.d.ts +22 -20
  183. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -1
  184. package/dist/mcp-server/transports/streamable-http-transport.js +16 -51
  185. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -1
  186. package/dist/services/msads/msads-http-client.d.ts +5 -1
  187. package/dist/services/msads/msads-http-client.d.ts.map +1 -1
  188. package/dist/services/msads/msads-http-client.js +49 -2
  189. package/dist/services/msads/msads-http-client.js.map +1 -1
  190. package/dist/services/msads/msads-reporting-service.d.ts +3 -9
  191. package/dist/services/msads/msads-reporting-service.d.ts.map +1 -1
  192. package/dist/services/msads/msads-reporting-service.js +62 -27
  193. package/dist/services/msads/msads-reporting-service.js.map +1 -1
  194. package/dist/services/msads/msads-service.d.ts +53 -5
  195. package/dist/services/msads/msads-service.d.ts.map +1 -1
  196. package/dist/services/msads/msads-service.js +235 -35
  197. package/dist/services/msads/msads-service.js.map +1 -1
  198. package/dist/services/msads/partial-errors.d.ts +34 -0
  199. package/dist/services/msads/partial-errors.d.ts.map +1 -0
  200. package/dist/services/msads/partial-errors.js +149 -0
  201. package/dist/services/msads/partial-errors.js.map +1 -0
  202. package/dist/services/msads/rate-limit-keys.d.ts +8 -2
  203. package/dist/services/msads/rate-limit-keys.d.ts.map +1 -1
  204. package/dist/services/msads/rate-limit-keys.js +16 -2
  205. package/dist/services/msads/rate-limit-keys.js.map +1 -1
  206. package/dist/services/msads/types.d.ts +1 -2
  207. package/dist/services/msads/types.d.ts.map +1 -1
  208. package/dist/services/msads/types.js.map +1 -1
  209. package/dist/services/session-services.d.ts +2 -2
  210. package/dist/services/session-services.d.ts.map +1 -1
  211. package/dist/services/session-services.js +10 -10
  212. package/dist/services/session-services.js.map +1 -1
  213. package/dist/services/session-wiring.d.ts +7 -0
  214. package/dist/services/session-wiring.d.ts.map +1 -0
  215. package/dist/services/session-wiring.js +20 -0
  216. package/dist/services/session-wiring.js.map +1 -0
  217. package/dist/testkit/fixtures/index.d.ts +4 -0
  218. package/dist/testkit/fixtures/index.d.ts.map +1 -1
  219. package/dist/testkit/fixtures/index.js +105 -3
  220. package/dist/testkit/fixtures/index.js.map +1 -1
  221. package/dist/testkit/types.d.ts +2 -2
  222. package/dist/testkit/types.d.ts.map +1 -1
  223. package/package.json +8 -8
package/README.md CHANGED
@@ -14,7 +14,7 @@ through the Model Context Protocol.
14
14
  ## Features
15
15
 
16
16
  - **Per-session Bearer token auth** via `MsAdsBearerAuthStrategy`
17
- - **Streamable HTTP + stdio transports** via Hono + `@hono/mcp`
17
+ - **Streamable HTTP + stdio transports** via Hono + the MCP SDK's web-standard transport
18
18
  - **OpenTelemetry** instrumentation for traces and metrics
19
19
  - **Rate limiting** via shared `RateLimiter` class
20
20
  - **Structured logging** via Pino
@@ -24,14 +24,14 @@ through the Model Context Protocol.
24
24
 
25
25
  ### Core CRUD
26
26
 
27
- | Tool | Description |
28
- | --------------------- | ------------------------------------------------------- |
29
- | `msads_list_entities` | List Microsoft Ads entities with filters and pagination |
30
- | `msads_get_entity` | Get a single entity by ID |
31
- | `msads_create_entity` | Create a new entity |
32
- | `msads_update_entity` | Update an existing entity |
33
- | `msads_delete_entity` | Delete an entity |
34
- | `msads_list_accounts` | List accessible ad accounts |
27
+ | Tool | Description |
28
+ | --------------------- | -------------------------------------------------- |
29
+ | `msads_list_entities` | List entities by account or parent (no pagination) |
30
+ | `msads_get_entity` | Get a single entity by ID |
31
+ | `msads_create_entity` | Create a new entity |
32
+ | `msads_update_entity` | Update an existing entity |
33
+ | `msads_delete_entity` | Delete an entity |
34
+ | `msads_list_accounts` | List accessible ad accounts |
35
35
 
36
36
  ### Reporting
37
37
 
@@ -56,35 +56,49 @@ All reporting tools below accept the shared bounded report-view params: `mode` (
56
56
 
57
57
  ### Specialized
58
58
 
59
- | Tool | Description |
60
- | ---------------------------- | ------------------------------------------------ |
61
- | `msads_manage_ad_extensions` | Manage ad extensions (sitelinks, callouts, etc.) |
62
- | `msads_manage_criterions` | Manage targeting criterions |
63
- | `msads_search_targeting` | Search available targeting options |
64
- | `msads_get_ad_details` | Get stored ad details (copy, URLs, status) |
65
- | `msads_validate_entity` | Validate entity payload |
66
- | `msads_import_from_google` | Import campaigns from Google Ads |
59
+ | Tool | Description |
60
+ | ----------------------------- | ------------------------------------------------ |
61
+ | `msads_manage_ad_extensions` | Manage ad extensions (sitelinks, callouts, etc.) |
62
+ | `msads_manage_criterions` | Manage targeting criterions |
63
+ | `msads_search_targeting` | Search available targeting options |
64
+ | `msads_get_ad_details` | Get stored ad details (copy, URLs, status) |
65
+ | `msads_validate_entity` | Validate entity payload |
66
+ | `msads_import_from_google` | Import campaigns from Google Ads |
67
+ | `msads_duplicate_entity` | Copy a campaign (always created `Paused`) |
68
+ | `msads_get_targeting_options` | Static criterion values for `manage_criterions` |
69
+ | `msads_get_pacing_status` | Client-side pacing calculator (no API call) |
70
+ | `msads_search_tools` | Rank this server's tools against a query |
71
+
72
+ ### Report Schedules (not supported by the platform)
73
+
74
+ The Reporting API v13 exposes only `GenerateReport/Submit` and `GenerateReport/Poll`; `ReportRequest` has no `Schedule` element. These tools stay registered so tool lists do not churn, but none of them schedules, lists or deletes anything.
75
+
76
+ | Tool | Behaviour |
77
+ | ------------------------------ | -------------------------------------------------- |
78
+ | `msads_create_report_schedule` | Always fails without calling Microsoft Advertising |
79
+ | `msads_list_report_schedules` | Returns guidance only |
80
+ | `msads_delete_report_schedule` | Always fails without calling Microsoft Advertising |
67
81
 
68
82
  ## Supported Entity Types
69
83
 
70
- | Entity Type | API Service Path | Parent Entity | Batch Limit | Notes |
71
- | ------------- | ----------------- | ------------- | ----------- | ---------------------------------------------- |
72
- | `campaign` | `/Campaigns/*` | Account | 100 | Top-level entity; requires budget reference |
73
- | `adGroup` | `/AdGroups/*` | Campaign | 1000 | Requires parent `CampaignId` |
74
- | `ad` | `/Ads/*` | Ad Group | 50 | Requires parent `AdGroupId` |
75
- | `keyword` | `/Keywords/*` | Ad Group | 1000 | Requires parent `AdGroupId` |
76
- | `budget` | `/Budgets/*` | Account | 100 | Shared budgets; create before campaigns |
77
- | `adExtension` | `/AdExtensions/*` | Account | 100 | Sitelinks, callouts, structured snippets, etc. |
78
- | `audience` | `/Audiences/*` | Account | 100 | Remarketing lists, custom audiences |
79
- | `label` | `/Labels/*` | Account | 100 | For organizing and filtering entities |
84
+ | Entity Type | API Service Path | Parent Entity | Batch Limit | Notes |
85
+ | ------------- | ----------------- | ------------- | ----------- | --------------------------------------------------------- |
86
+ | `campaign` | `/Campaigns/*` | Account | 100 | Top-level entity; inline `DailyBudget` or a shared budget |
87
+ | `adGroup` | `/AdGroups/*` | Campaign | 1000 | Requires parent `CampaignId` |
88
+ | `ad` | `/Ads/*` | Ad Group | 50 | Requires parent `AdGroupId` |
89
+ | `keyword` | `/Keywords/*` | Ad Group | 1000 | Requires parent `AdGroupId` |
90
+ | `budget` | `/Budgets/*` | Account | 100 | Shared budgets; create before campaigns |
91
+ | `adExtension` | `/AdExtensions/*` | Account | 100 | Sitelinks, callouts, structured snippets, etc. |
92
+ | `audience` | `/Audiences/*` | Account | 100 | Remarketing lists, custom audiences |
93
+ | `label` | `/Labels/*` | Account | 100 | For organizing and filtering entities |
80
94
 
81
95
  **Entity Hierarchy:** Account > Budget > Campaign > Ad Group > Ad / Keyword
82
96
 
83
97
  ## Current Status
84
98
 
85
- **Phase: Production-Ready**
99
+ The tools call the Microsoft Advertising API v13 JSON endpoints. Request shapes are checked against the MicrosoftDocs/Advertising reference (see `tests/tools/msads-wire-requests.test.ts`), but no tool has been exercised against a live account, so every governed tool is at `declared` verification.
86
100
 
87
- All listed tools are implemented against the Microsoft Advertising API v13 JSON endpoints.
101
+ - The stdio transport takes a static `MSADS_ACCESS_TOKEN` and has no refresh-token flow; an access token expires after the `expires_in` seconds returned with it (MicrosoftDocs `authentication-oauth-get-tokens.md`), so long stdio sessions need a fresh token. Mint it with the `https://ads.microsoft.com/msads.manage` scope.
88
102
 
89
103
  ## Development
90
104
 
@@ -155,7 +169,7 @@ When running in stdio transport mode (e.g., Claude Desktop), set these environme
155
169
 
156
170
  ### Transport
157
171
 
158
- - **Streamable HTTP**: MCP protocol via Hono + `@hono/mcp`
172
+ - **Streamable HTTP**: MCP protocol via Hono + the MCP SDK's web-standard transport
159
173
  - **Health check**: `/health` endpoint
160
174
 
161
175
  ## Contributing
@@ -1 +1 @@
1
- {"version":3,"file":"msads-auth-adapter.d.ts","sourceRoot":"","sources":["../../src/auth/msads-auth-adapter.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,gBAAgB;IAC/B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAYD,qBAAa,uBAAwB,YAAW,gBAAgB;IAK5D,OAAO,CAAC,QAAQ,CAAC,WAAW;aACZ,cAAc,EAAE,MAAM;aACtB,UAAU,EAAE,MAAM;aAClB,SAAS,EAAE,MAAM;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IARrC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAM;gBAGF,WAAW,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAChB,kBAAkB,GAAE,MAAgF;IAGvH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAEK,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAIjC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA+BhC;AAMD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,CAUR;AAKD,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,CAMR;AAKD,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,CAMR;AAKD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,CAMR;AAKD,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}
1
+ {"version":3,"file":"msads-auth-adapter.d.ts","sourceRoot":"","sources":["../../src/auth/msads-auth-adapter.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,gBAAgB;IAC/B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAgBD,qBAAa,uBAAwB,YAAW,gBAAgB;IAK5D,OAAO,CAAC,QAAQ,CAAC,WAAW;aACZ,cAAc,EAAE,MAAM;aACtB,UAAU,EAAE,MAAM;aAClB,SAAS,EAAE,MAAM;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IARrC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAM;gBAGF,WAAW,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAChB,kBAAkB,GAAE,MAAgF;IAGvH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAEK,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAIjC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA+BhC;AAMD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,CAUR;AAKD,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,CAMR;AAKD,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,CAMR;AAKD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,CAMR;AAKD,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}
@@ -37,7 +37,7 @@ export class MsAdsAccessTokenAdapter {
37
37
  throw new McpError(JsonRpcErrorCode.Unauthorized, `Microsoft Ads token validation failed: ${response.status} ${response.statusText}`, { body: errorBody.substring(0, 200) });
38
38
  }
39
39
  const data = (await response.json());
40
- this._userId = String(data.UserId ?? "unknown");
40
+ this._userId = String(data.User?.Id ?? "unknown");
41
41
  this.validated = true;
42
42
  }
43
43
  }
@@ -1 +1 @@
1
- {"version":3,"file":"msads-auth-adapter.js","sourceRoot":"","sources":["../../src/auth/msads-auth-adapter.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"msads-auth-adapter.js","sourceRoot":"","sources":["../../src/auth/msads-auth-adapter.ts"],"names":[],"mappings":"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"}
@@ -1,22 +1,158 @@
1
1
  {
2
2
  "manifestVersion": 1,
3
3
  "packageName": "@cesteral/msads-mcp",
4
- "packageVersion": "1.2.0",
5
- "generatedAt": "2026-06-01T18:49:33.439Z",
4
+ "packageVersion": "2.0.0",
5
+ "generatedAt": "2026-11-18T11:08:18.201Z",
6
6
  "tools": [
7
+ {
8
+ "toolName": "msads_adjust_bids",
9
+ "contractPlatformSlug": "msads",
10
+ "contractToolSlug": "adjust_bids",
11
+ "schemaVersion": "1",
12
+ "definitionHash": "9994b7f426a124474eeb450424256878d0a5c6eb2bbcb1b7a8092a97749b9768",
13
+ "verification": {
14
+ "status": "declared"
15
+ }
16
+ },
17
+ {
18
+ "toolName": "msads_bulk_create_entities",
19
+ "contractPlatformSlug": "msads",
20
+ "contractToolSlug": "bulk_create_entities",
21
+ "schemaVersion": "1",
22
+ "definitionHash": "fb2bc547fed2c0049dc80f9542a29903e2776dd6ce9ef570380b18a0dd09a15b",
23
+ "verification": {
24
+ "status": "declared"
25
+ }
26
+ },
27
+ {
28
+ "toolName": "msads_bulk_update_entities",
29
+ "contractPlatformSlug": "msads",
30
+ "contractToolSlug": "bulk_update_entities",
31
+ "schemaVersion": "1",
32
+ "definitionHash": "610837a3e1b57dbcc54e9629a48a6aabcfb0a21cf2ab3dc1a8035025c1ff99c2",
33
+ "verification": {
34
+ "status": "declared"
35
+ }
36
+ },
37
+ {
38
+ "toolName": "msads_bulk_update_status",
39
+ "contractPlatformSlug": "msads",
40
+ "contractToolSlug": "bulk_update_status",
41
+ "schemaVersion": "1",
42
+ "definitionHash": "6d03159f0c59237c2c37d8a78ad0dfbd4c68532555ee82b0703ac56ac886073f",
43
+ "verification": {
44
+ "status": "declared"
45
+ }
46
+ },
47
+ {
48
+ "toolName": "msads_create_entity",
49
+ "contractPlatformSlug": "msads",
50
+ "contractToolSlug": "create_entity",
51
+ "schemaVersion": "1",
52
+ "definitionHash": "0b8b9cbf6efaf8ce21ea9cb2c7a55ec17baf103b1a119fd337da38aa9c3fe63c",
53
+ "verification": {
54
+ "status": "declared"
55
+ }
56
+ },
57
+ {
58
+ "toolName": "msads_create_report_schedule",
59
+ "contractPlatformSlug": "msads",
60
+ "contractToolSlug": "create_report_schedule",
61
+ "schemaVersion": "1",
62
+ "definitionHash": "e16949f58cc40a293708313bc61c6cb32b33c7aa169add723bdc64497b5fad8d",
63
+ "verification": {
64
+ "status": "declared"
65
+ }
66
+ },
67
+ {
68
+ "toolName": "msads_delete_entity",
69
+ "contractPlatformSlug": "msads",
70
+ "contractToolSlug": "delete_entity",
71
+ "schemaVersion": "1",
72
+ "definitionHash": "8ef3e203481091805b13dbd8aaee73b6d927ef184282ff218dc0fdaeaa2d7000",
73
+ "verification": {
74
+ "status": "declared"
75
+ }
76
+ },
77
+ {
78
+ "toolName": "msads_delete_report_schedule",
79
+ "contractPlatformSlug": "msads",
80
+ "contractToolSlug": "delete_report_schedule",
81
+ "schemaVersion": "1",
82
+ "definitionHash": "46603ef771e18b66b801db63da8b37bc70997972566ff60f257710a956c4e2fb",
83
+ "verification": {
84
+ "status": "declared"
85
+ }
86
+ },
87
+ {
88
+ "toolName": "msads_duplicate_entity",
89
+ "contractPlatformSlug": "msads",
90
+ "contractToolSlug": "duplicate_entity",
91
+ "schemaVersion": "1",
92
+ "definitionHash": "cdee51649feb3cded5cffdb3d87fe9ec58bba68b25e99543e57fe090e0a56e0e",
93
+ "verification": {
94
+ "status": "declared"
95
+ }
96
+ },
7
97
  {
8
98
  "toolName": "msads_get_entity",
9
99
  "contractPlatformSlug": "msads",
10
100
  "contractToolSlug": "get_entity",
11
101
  "schemaVersion": "1",
12
- "definitionHash": "d33960e312ffd4b7074c60ebf22ab650580fbc53c8e974620aa451a4ba5832f0"
102
+ "definitionHash": "626e0e039d09c6d8e07882ad683e0a3604c881ea7a23241506b291e70ce0100c",
103
+ "verification": {
104
+ "status": "declared"
105
+ }
106
+ },
107
+ {
108
+ "toolName": "msads_import_from_google",
109
+ "contractPlatformSlug": "msads",
110
+ "contractToolSlug": "import_from_google",
111
+ "schemaVersion": "1",
112
+ "definitionHash": "e5efe1181d5e73e8b0d80a5a3b9a6acd45aabbdcb38c18bee342defa57d8cba9",
113
+ "verification": {
114
+ "status": "declared"
115
+ }
116
+ },
117
+ {
118
+ "toolName": "msads_manage_ad_extensions",
119
+ "contractPlatformSlug": "msads",
120
+ "contractToolSlug": "manage_ad_extensions",
121
+ "schemaVersion": "1",
122
+ "definitionHash": "51f7b0112d223290a6d8bb1c4270e3136126a97b5ee57e9870a9426f82323230",
123
+ "verification": {
124
+ "status": "declared"
125
+ }
126
+ },
127
+ {
128
+ "toolName": "msads_manage_criterions",
129
+ "contractPlatformSlug": "msads",
130
+ "contractToolSlug": "manage_criterions",
131
+ "schemaVersion": "1",
132
+ "definitionHash": "195b9a1e18fa8474e5fcd62b0acb003a8757ed2a56e023ae49c84be5ae9a4ba6",
133
+ "verification": {
134
+ "status": "declared"
135
+ }
136
+ },
137
+ {
138
+ "toolName": "msads_submit_report",
139
+ "contractPlatformSlug": "msads",
140
+ "contractToolSlug": "submit_report",
141
+ "schemaVersion": "1",
142
+ "definitionHash": "ef734d26aabe86363844df5656b565878b630da35d4c215043150f4bbab973a6",
143
+ "verification": {
144
+ "status": "declared"
145
+ }
13
146
  },
14
147
  {
15
148
  "toolName": "msads_update_entity",
16
149
  "contractPlatformSlug": "msads",
17
150
  "contractToolSlug": "update_entity",
18
151
  "schemaVersion": "1",
19
- "definitionHash": "e45479e3141a76d2ae7ab0be1ecdcfe1932d5d6457bafe1521aea7249f78bf7d"
152
+ "definitionHash": "4b95c98389efb2ffb6fdcbc88e6cc8b15fce345effc736d478b063a98d5e46e5",
153
+ "verification": {
154
+ "status": "declared"
155
+ }
20
156
  }
21
157
  ]
22
158
  }
@@ -1,21 +1,41 @@
1
1
  import { z } from "zod";
2
2
  declare const ConfigSchema: z.ZodObject<{
3
3
  host: z.ZodDefault<z.ZodString>;
4
- nodeEnv: z.ZodDefault<z.ZodEnum<["development", "production", "test"]>>;
4
+ nodeEnv: z.ZodDefault<z.ZodEnum<{
5
+ development: "development";
6
+ production: "production";
7
+ test: "test";
8
+ }>>;
5
9
  mcpStatefulSessionTimeoutMs: z.ZodDefault<z.ZodNumber>;
6
10
  mcpAuthSecretKey: z.ZodOptional<z.ZodString>;
7
11
  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"]>>;
12
+ mcpAllowedHosts: z.ZodOptional<z.ZodString>;
13
+ logLevel: z.ZodDefault<z.ZodEnum<{
14
+ error: "error";
15
+ info: "info";
16
+ debug: "debug";
17
+ warning: "warning";
18
+ notice: "notice";
19
+ }>>;
20
+ mcpLogLevel: z.ZodDefault<z.ZodEnum<{
21
+ error: "error";
22
+ info: "info";
23
+ debug: "debug";
24
+ warning: "warning";
25
+ notice: "notice";
26
+ }>>;
10
27
  otelEnabled: z.ZodDefault<z.ZodBoolean>;
11
28
  otelExporterOtlpTracesEndpoint: z.ZodOptional<z.ZodString>;
12
29
  otelExporterOtlpMetricsEndpoint: z.ZodOptional<z.ZodString>;
13
30
  gcsBucketName: z.ZodOptional<z.ZodString>;
14
- } & {
15
31
  serviceName: z.ZodDefault<z.ZodString>;
16
32
  port: z.ZodDefault<z.ZodNumber>;
17
33
  otelServiceName: z.ZodDefault<z.ZodString>;
18
- mcpAuthMode: z.ZodDefault<z.ZodEnum<["msads-bearer", "jwt", "none"]>>;
34
+ mcpAuthMode: z.ZodDefault<z.ZodEnum<{
35
+ "msads-bearer": "msads-bearer";
36
+ jwt: "jwt";
37
+ none: "none";
38
+ }>>;
19
39
  msadsCampaignApiBaseUrl: z.ZodDefault<z.ZodString>;
20
40
  msadsReportingApiBaseUrl: z.ZodDefault<z.ZodString>;
21
41
  msadsCustomerApiBaseUrl: z.ZodDefault<z.ZodString>;
@@ -26,62 +46,16 @@ declare const ConfigSchema: z.ZodObject<{
26
46
  msadsAccountId: z.ZodOptional<z.ZodString>;
27
47
  msadsReportPollIntervalMs: z.ZodDefault<z.ZodNumber>;
28
48
  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;
49
+ }, z.core.$strip>;
50
+ export type AppConfig = z.infer<typeof ConfigSchema>;
51
+ export declare function parseConfig(): AppConfig;
52
+ export declare const mcpConfig: {
40
53
  host: string;
41
54
  nodeEnv: "development" | "production" | "test";
42
55
  mcpStatefulSessionTimeoutMs: number;
43
- logLevel: "debug" | "info" | "notice" | "warning" | "error";
44
- mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
56
+ logLevel: "error" | "info" | "debug" | "warning" | "notice";
57
+ mcpLogLevel: "error" | "info" | "debug" | "warning" | "notice";
45
58
  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
59
  serviceName: string;
86
60
  port: number;
87
61
  otelServiceName: string;
@@ -92,21 +66,16 @@ export declare const mcpConfig: {
92
66
  msadsRateLimitPerMinute: number;
93
67
  msadsReportPollIntervalMs: number;
94
68
  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
69
  mcpAuthSecretKey?: string | undefined;
106
70
  mcpAllowedOrigins?: string | undefined;
71
+ mcpAllowedHosts?: string | undefined;
107
72
  otelExporterOtlpTracesEndpoint?: string | undefined;
108
73
  otelExporterOtlpMetricsEndpoint?: string | undefined;
109
74
  gcsBucketName?: string | undefined;
75
+ msadsAccessToken?: string | undefined;
76
+ msadsDeveloperToken?: string | undefined;
77
+ msadsCustomerId?: string | undefined;
78
+ msadsAccountId?: string | undefined;
110
79
  };
111
80
  export {};
112
81
  //# sourceMappingURL=index.d.ts.map
@@ -1 +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"}
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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmChB,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"}
package/dist/index.js CHANGED
@@ -3,33 +3,23 @@ import { mcpConfig } from "./config/index.js";
3
3
  import { createMcpServer, runStdioServer } from "./mcp-server/server.js";
4
4
  import { startHttpServer } from "./mcp-server/transports/streamable-http-transport.js";
5
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";
6
+ import { detectTransportMode, createServerLogger, bootstrapMcpServer, createStdioSessionSetup, } from "@cesteral/shared";
7
+ import { sessionServiceStore } from "./services/session-services.js";
8
+ import { buildEnvAuthAdapter, buildSessionServices } from "./services/session-wiring.js";
9
9
  import { rateLimiter } from "./utils/platform.js";
10
+ import { allTools } from "./mcp-server/tools/index.js";
10
11
  const transportMode = detectTransportMode();
11
12
  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
- }
13
+ const setupStdioCredentials = createStdioSessionSetup({
14
+ sessionServiceStore,
15
+ logger,
16
+ buildEnvAdapter: () => buildEnvAuthAdapter(mcpConfig),
17
+ buildServices: (adapter) => buildSessionServices(mcpConfig, adapter, logger),
18
+ missingCredentialsWarning: "No Microsoft Ads credentials found in env vars. " +
19
+ "Set MSADS_ACCESS_TOKEN, MSADS_DEVELOPER_TOKEN, MSADS_CUSTOMER_ID, and MSADS_ACCOUNT_ID for stdio mode.",
20
+ });
32
21
  bootstrapMcpServer({
22
+ tools: allTools,
33
23
  serviceName: "msads-mcp",
34
24
  config: mcpConfig,
35
25
  logger,
package/dist/index.js.map CHANGED
@@ -1 +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"}
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,EACL,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;AAC5C,MAAM,MAAM,GAAG,kBAAkB,CAAC,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;AAG9E,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;IACpD,mBAAmB;IACnB,MAAM;IACN,eAAe,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC;IACrD,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;IAC5E,yBAAyB,EACvB,kDAAkD;QAClD,wGAAwG;CAC3G,CAAC,CAAC;AAEH,kBAAkB,CAAC;IAEjB,KAAK,EAAE,QAAQ;IACf,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"}
@@ -1,4 +1,4 @@
1
- import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
1
+ import type { Prompt } from "@modelcontextprotocol/server";
2
2
  export declare const msadsBulkOperationsWorkflowPrompt: Prompt;
3
3
  export declare function getMsAdsBulkOperationsWorkflowMessage(): string;
4
4
  //# sourceMappingURL=bulk-operations-workflow.prompt.d.ts.map
@@ -1 +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"}
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,8BAA8B,CAAC;AAE3D,eAAO,MAAM,iCAAiC,EAAE,MAI/C,CAAC;AAEF,wBAAgB,qCAAqC,IAAI,MAAM,CAqD9D"}
@@ -10,17 +10,21 @@ export function getMsAdsBulkOperationsWorkflowMessage() {
10
10
  \`\`\`json
11
11
  msads_bulk_create_entities({
12
12
  "entityType": "keyword",
13
+ "adGroupId": "123",
13
14
  "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 } }
15
+ { "Text": "keyword 1", "MatchType": "Phrase", "Bid": { "Amount": 1.50 } },
16
+ { "Text": "keyword 2", "MatchType": "Exact", "Bid": { "Amount": 2.00 } }
16
17
  ]
17
18
  })
18
19
  \`\`\`
20
+ Every item in one call belongs to one parent, passed as \`accountId\` (campaign, adExtension),
21
+ \`campaignId\` (adGroup) or \`adGroupId\` (ad, keyword) and sent as the request-body parent element.
19
22
 
20
23
  ## Bulk Update Status (Pause/Activate)
21
24
  \`\`\`json
22
25
  msads_bulk_update_status({
23
26
  "entityType": "campaign",
27
+ "accountId": "789012",
24
28
  "entityIds": ["111", "222", "333"],
25
29
  "status": "Paused"
26
30
  })
@@ -30,13 +34,15 @@ msads_bulk_update_status({
30
34
  \`\`\`json
31
35
  msads_adjust_bids({
32
36
  "entityType": "keyword",
37
+ "scope": { "adGroupId": "123" },
33
38
  "adjustments": [
34
39
  { "entityId": "111", "bidField": "Bid", "newBid": 1.75 },
35
40
  { "entityId": "222", "bidField": "Bid", "newBid": 2.25 }
36
41
  ]
37
42
  })
38
43
  \`\`\`
39
- The adjust-bids tool uses a safe read-modify-write pattern.
44
+ The adjust-bids tool reads the entities first, then sends a minimal Update with each bid as a
45
+ Bid object (\`{ "Amount": newBid }\`), so no other field is touched.
40
46
 
41
47
  ## Batch Limits
42
48
  | Entity | Batch Limit |
@@ -1 +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"}
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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDR,CAAC;AACF,CAAC"}
@@ -1,4 +1,4 @@
1
- import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
1
+ import type { Prompt } from "@modelcontextprotocol/server";
2
2
  export declare const campaignSetupWorkflowPrompt: Prompt;
3
3
  export declare function getCampaignSetupWorkflowMessage(args?: Record<string, string>): string;
4
4
  //# sourceMappingURL=campaign-setup-workflow.prompt.d.ts.map
@@ -1 +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"}
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,8BAA8B,CAAC;AAE3D,eAAO,MAAM,2BAA2B,EAAE,MAWzC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAwIrF"}
@@ -21,8 +21,8 @@ msads_create_entity({
21
21
  "data": {
22
22
  "Budgets": [{
23
23
  "Name": "Q1 2026 Budget",
24
- "Amount": 3000.00,
25
- "BudgetType": "MonthlyBudgetSpendUntilDepleted"
24
+ "Amount": 100.00,
25
+ "BudgetType": "DailyBudgetStandard"
26
26
  }]
27
27
  }
28
28
  })
@@ -129,7 +129,9 @@ msads_manage_ad_extensions({
129
129
  \`\`\`json
130
130
  msads_update_entity({
131
131
  "entityType": "campaign",
132
- "data": { "Campaigns": [{ "Id": {campaignId}, "Status": "Active" }] }
132
+ "entityId": "{campaignId}",
133
+ "accountId": "${args?.accountId || "{accountId}"}",
134
+ "data": { "Status": "Active" }
133
135
  })
134
136
  \`\`\`
135
137
 
@@ -1 +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"}
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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA4FnB,IAAI,EAAE,SAAS,IAAI,aAAa;;;;;;;;;;;;;;CAcjD,CAAC;AACF,CAAC"}
@@ -1,4 +1,4 @@
1
- import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
1
+ import type { Prompt } from "@modelcontextprotocol/server";
2
2
  export declare const googleImportWorkflowPrompt: Prompt;
3
3
  export declare function getGoogleImportWorkflowMessage(args?: Record<string, string>): string;
4
4
  //# sourceMappingURL=google-import-workflow.prompt.d.ts.map