@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,73 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { fromMicrosoftStatus, ReportStatusSchema } from "@cesteral/shared";
4
+ const TOOL_NAME = "msads_check_report_status";
5
+ const TOOL_TITLE = "Check Microsoft Ads Report Status";
6
+ const TOOL_DESCRIPTION = `Check the status of a previously submitted Microsoft Advertising report.
7
+
8
+ **Canonical states:** \`pending\`, \`running\`, \`complete\`, \`failed\`, \`cancelled\`.
9
+ Microsoft Ads raw statuses (Pending/InProgress/Success/Error) are mapped; the raw string is returned as \`rawStatus\`.
10
+ Returns the canonical state and download URL when the report is ready.`;
11
+ export const CheckReportStatusInputSchema = z
12
+ .object({
13
+ reportRequestId: z.string().describe("Report request ID from msads_submit_report"),
14
+ })
15
+ .describe("Parameters for checking report status");
16
+ export const CheckReportStatusOutputSchema = ReportStatusSchema.extend({
17
+ reportRequestId: z.string(),
18
+ rawStatus: z.string().describe("Raw Microsoft Ads status (Pending/InProgress/Success/Error)"),
19
+ isComplete: z.boolean().describe("Whether the canonical state is 'complete'"),
20
+ timestamp: z.string().datetime(),
21
+ }).describe("Report status result");
22
+ export async function checkReportStatusLogic(input, context, sdkContext) {
23
+ const { msadsReportingService } = resolveSessionServices(sdkContext);
24
+ const result = await msadsReportingService.checkReportStatus(input.reportRequestId, context);
25
+ const canonical = fromMicrosoftStatus({
26
+ ReportRequestStatus: result.status,
27
+ ReportDownloadUrl: result.downloadUrl,
28
+ });
29
+ return {
30
+ ...canonical,
31
+ reportRequestId: input.reportRequestId,
32
+ rawStatus: result.status,
33
+ isComplete: canonical.state === "complete",
34
+ timestamp: new Date().toISOString(),
35
+ };
36
+ }
37
+ export function checkReportStatusResponseFormatter(result) {
38
+ let text = `Report ${result.reportRequestId} state: ${result.state} (${result.rawStatus})`;
39
+ if (result.downloadUrl) {
40
+ text += `\n\nDownload URL: ${result.downloadUrl}\n\nUse msads_download_report to download and parse the results.`;
41
+ }
42
+ else if (result.state === "running" || result.state === "pending") {
43
+ text += "\n\nReport is still processing. Check again shortly.";
44
+ }
45
+ return [
46
+ {
47
+ type: "text",
48
+ text: `${text}\n\nTimestamp: ${result.timestamp}`,
49
+ },
50
+ ];
51
+ }
52
+ export const checkReportStatusTool = {
53
+ name: TOOL_NAME,
54
+ title: TOOL_TITLE,
55
+ description: TOOL_DESCRIPTION,
56
+ inputSchema: CheckReportStatusInputSchema,
57
+ outputSchema: CheckReportStatusOutputSchema,
58
+ annotations: {
59
+ readOnlyHint: true,
60
+ openWorldHint: false,
61
+ idempotentHint: true,
62
+ destructiveHint: false,
63
+ },
64
+ inputExamples: [
65
+ {
66
+ label: "Check report status",
67
+ input: { reportRequestId: "abc-123-def" },
68
+ },
69
+ ],
70
+ logic: checkReportStatusLogic,
71
+ responseFormatter: checkReportStatusResponseFormatter,
72
+ };
73
+ //# sourceMappingURL=check-report-status.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"check-report-status.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/check-report-status.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,81 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const CreateEntityInputSchema: z.ZodObject<{
4
+ entityType: z.ZodEnum<[string, ...string[]]>;
5
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
6
+ }, "strip", z.ZodTypeAny, {
7
+ entityType: string;
8
+ data: Record<string, unknown>;
9
+ }, {
10
+ entityType: string;
11
+ data: Record<string, unknown>;
12
+ }>;
13
+ export declare const CreateEntityOutputSchema: z.ZodObject<{
14
+ result: z.ZodRecord<z.ZodString, z.ZodAny>;
15
+ entityType: z.ZodString;
16
+ timestamp: z.ZodString;
17
+ }, "strip", z.ZodTypeAny, {
18
+ entityType: string;
19
+ timestamp: string;
20
+ result: Record<string, any>;
21
+ }, {
22
+ entityType: string;
23
+ timestamp: string;
24
+ result: Record<string, any>;
25
+ }>;
26
+ type CreateEntityInput = z.infer<typeof CreateEntityInputSchema>;
27
+ type CreateEntityOutput = z.infer<typeof CreateEntityOutputSchema>;
28
+ export declare function createEntityLogic(input: CreateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<CreateEntityOutput>;
29
+ export declare function createEntityResponseFormatter(result: CreateEntityOutput): McpTextContent[];
30
+ export declare const createEntityTool: {
31
+ name: string;
32
+ title: string;
33
+ description: string;
34
+ inputSchema: z.ZodObject<{
35
+ entityType: z.ZodEnum<[string, ...string[]]>;
36
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
37
+ }, "strip", z.ZodTypeAny, {
38
+ entityType: string;
39
+ data: Record<string, unknown>;
40
+ }, {
41
+ entityType: string;
42
+ data: Record<string, unknown>;
43
+ }>;
44
+ outputSchema: z.ZodObject<{
45
+ result: z.ZodRecord<z.ZodString, z.ZodAny>;
46
+ entityType: z.ZodString;
47
+ timestamp: z.ZodString;
48
+ }, "strip", z.ZodTypeAny, {
49
+ entityType: string;
50
+ timestamp: string;
51
+ result: Record<string, any>;
52
+ }, {
53
+ entityType: string;
54
+ timestamp: string;
55
+ result: Record<string, any>;
56
+ }>;
57
+ annotations: {
58
+ readOnlyHint: boolean;
59
+ openWorldHint: boolean;
60
+ idempotentHint: boolean;
61
+ destructiveHint: boolean;
62
+ };
63
+ inputExamples: {
64
+ label: string;
65
+ input: {
66
+ entityType: string;
67
+ data: {
68
+ Campaigns: {
69
+ Name: string;
70
+ BudgetType: string;
71
+ DailyBudget: number;
72
+ TimeZone: string;
73
+ }[];
74
+ };
75
+ };
76
+ }[];
77
+ logic: typeof createEntityLogic;
78
+ responseFormatter: typeof createEntityResponseFormatter;
79
+ };
80
+ export {};
81
+ //# sourceMappingURL=create-entity.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAUnF,eAAO,MAAM,uBAAuB;;;;;;;;;EAKyB,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAMA,CAAC;AAEtC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAc7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC5B,CAAC"}
@@ -0,0 +1,74 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { getEntityTypeEnum } from "../utils/entity-mapping.js";
4
+ const TOOL_NAME = "msads_create_entity";
5
+ const TOOL_TITLE = "Create Microsoft Ads Entity";
6
+ const TOOL_DESCRIPTION = `Create a new Microsoft Advertising entity.
7
+
8
+ The data object should follow Microsoft Ads API v13 format. Wrap entities in their plural key (e.g., { "Campaigns": [{ "Name": "..." }] }).
9
+
10
+ Use the entity-schema and entity-examples MCP resources to discover required fields.`;
11
+ export const CreateEntityInputSchema = z
12
+ .object({
13
+ entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to create"),
14
+ data: z.record(z.unknown()).describe("Entity data payload following Microsoft Ads API format"),
15
+ })
16
+ .describe("Parameters for creating a Microsoft Ads entity");
17
+ export const CreateEntityOutputSchema = z
18
+ .object({
19
+ result: z.record(z.any()).describe("API response with created entity IDs"),
20
+ entityType: z.string(),
21
+ timestamp: z.string().datetime(),
22
+ })
23
+ .describe("Entity creation result");
24
+ export async function createEntityLogic(input, context, sdkContext) {
25
+ const { msadsService } = resolveSessionServices(sdkContext);
26
+ const result = (await msadsService.createEntity(input.entityType, input.data, context));
27
+ return {
28
+ result,
29
+ entityType: input.entityType,
30
+ timestamp: new Date().toISOString(),
31
+ };
32
+ }
33
+ export function createEntityResponseFormatter(result) {
34
+ return [
35
+ {
36
+ type: "text",
37
+ text: `Created ${result.entityType} entity\n\nResult:\n${JSON.stringify(result.result, null, 2)}\n\nTimestamp: ${result.timestamp}`,
38
+ },
39
+ ];
40
+ }
41
+ export const createEntityTool = {
42
+ name: TOOL_NAME,
43
+ title: TOOL_TITLE,
44
+ description: TOOL_DESCRIPTION,
45
+ inputSchema: CreateEntityInputSchema,
46
+ outputSchema: CreateEntityOutputSchema,
47
+ annotations: {
48
+ readOnlyHint: false,
49
+ openWorldHint: false,
50
+ idempotentHint: false,
51
+ destructiveHint: false,
52
+ },
53
+ inputExamples: [
54
+ {
55
+ label: "Create a campaign",
56
+ input: {
57
+ entityType: "campaign",
58
+ data: {
59
+ Campaigns: [
60
+ {
61
+ Name: "My Campaign",
62
+ BudgetType: "DailyBudgetStandard",
63
+ DailyBudget: 50.0,
64
+ TimeZone: "EasternTimeUSCanada",
65
+ },
66
+ ],
67
+ },
68
+ },
69
+ },
70
+ ],
71
+ logic: createEntityLogic,
72
+ responseFormatter: createEntityResponseFormatter,
73
+ };
74
+ //# sourceMappingURL=create-entity.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAwB,MAAM,4BAA4B,CAAC;AAGrF,MAAM,SAAS,GAAG,qBAAqB,CAAC;AACxC,MAAM,UAAU,GAAG,6BAA6B,CAAC;AACjD,MAAM,gBAAgB,GAAG;;;;qFAI4D,CAAC;AAEtF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC5E,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,wDAAwD,CAAC;CAC/F,CAAC;KACD,QAAQ,CAAC,gDAAgD,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC1E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AAKtC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,YAAY,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,MAAM,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAC7C,KAAK,CAAC,UAA6B,EACnC,KAAK,CAAC,IAAI,EACV,OAAO,CACR,CAA4B,CAAC;IAE9B,OAAO;QACL,MAAM;QACN,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA0B;IACtE,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,WAAW,MAAM,CAAC,UAAU,uBAAuB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACpI;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,KAAK;QACrB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,mBAAmB;YAC1B,KAAK,EAAE;gBACL,UAAU,EAAE,UAAU;gBACtB,IAAI,EAAE;oBACJ,SAAS,EAAE;wBACT;4BACE,IAAI,EAAE,aAAa;4BACnB,UAAU,EAAE,qBAAqB;4BACjC,WAAW,EAAE,IAAI;4BACjB,QAAQ,EAAE,qBAAqB;yBAChC;qBACF;iBACF;aACF;SACF;KACF;IACD,KAAK,EAAE,iBAAiB;IACxB,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}
@@ -0,0 +1,160 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const CreateReportScheduleInputSchema: z.ZodObject<{
4
+ accountId: z.ZodString;
5
+ scheduleName: z.ZodString;
6
+ reportType: z.ZodString;
7
+ columns: z.ZodArray<z.ZodString, "many">;
8
+ startDate: z.ZodString;
9
+ endDate: z.ZodString;
10
+ aggregation: z.ZodOptional<z.ZodString>;
11
+ schedule: z.ZodObject<{
12
+ StartDate: z.ZodString;
13
+ EndDate: z.ZodOptional<z.ZodString>;
14
+ Frequency: z.ZodEnum<["Daily", "Weekly", "Monthly"]>;
15
+ }, "strip", z.ZodTypeAny, {
16
+ StartDate: string;
17
+ Frequency: "Daily" | "Weekly" | "Monthly";
18
+ EndDate?: string | undefined;
19
+ }, {
20
+ StartDate: string;
21
+ Frequency: "Daily" | "Weekly" | "Monthly";
22
+ EndDate?: string | undefined;
23
+ }>;
24
+ }, "strip", z.ZodTypeAny, {
25
+ accountId: string;
26
+ reportType: string;
27
+ scheduleName: string;
28
+ columns: string[];
29
+ startDate: string;
30
+ endDate: string;
31
+ schedule: {
32
+ StartDate: string;
33
+ Frequency: "Daily" | "Weekly" | "Monthly";
34
+ EndDate?: string | undefined;
35
+ };
36
+ aggregation?: string | undefined;
37
+ }, {
38
+ accountId: string;
39
+ reportType: string;
40
+ scheduleName: string;
41
+ columns: string[];
42
+ startDate: string;
43
+ endDate: string;
44
+ schedule: {
45
+ StartDate: string;
46
+ Frequency: "Daily" | "Weekly" | "Monthly";
47
+ EndDate?: string | undefined;
48
+ };
49
+ aggregation?: string | undefined;
50
+ }>;
51
+ export declare const CreateReportScheduleOutputSchema: z.ZodObject<{
52
+ scheduleId: z.ZodString;
53
+ scheduleName: z.ZodString;
54
+ timestamp: z.ZodString;
55
+ }, "strip", z.ZodTypeAny, {
56
+ scheduleName: string;
57
+ scheduleId: string;
58
+ timestamp: string;
59
+ }, {
60
+ scheduleName: string;
61
+ scheduleId: string;
62
+ timestamp: string;
63
+ }>;
64
+ type CreateReportScheduleInput = z.infer<typeof CreateReportScheduleInputSchema>;
65
+ type CreateReportScheduleOutput = z.infer<typeof CreateReportScheduleOutputSchema>;
66
+ export declare function createReportScheduleLogic(input: CreateReportScheduleInput, context: RequestContext, sdkContext?: SdkContext): Promise<CreateReportScheduleOutput>;
67
+ export declare function createReportScheduleResponseFormatter(result: CreateReportScheduleOutput): McpTextContent[];
68
+ export declare const createReportScheduleTool: {
69
+ name: string;
70
+ title: string;
71
+ description: string;
72
+ inputSchema: z.ZodObject<{
73
+ accountId: z.ZodString;
74
+ scheduleName: z.ZodString;
75
+ reportType: z.ZodString;
76
+ columns: z.ZodArray<z.ZodString, "many">;
77
+ startDate: z.ZodString;
78
+ endDate: z.ZodString;
79
+ aggregation: z.ZodOptional<z.ZodString>;
80
+ schedule: z.ZodObject<{
81
+ StartDate: z.ZodString;
82
+ EndDate: z.ZodOptional<z.ZodString>;
83
+ Frequency: z.ZodEnum<["Daily", "Weekly", "Monthly"]>;
84
+ }, "strip", z.ZodTypeAny, {
85
+ StartDate: string;
86
+ Frequency: "Daily" | "Weekly" | "Monthly";
87
+ EndDate?: string | undefined;
88
+ }, {
89
+ StartDate: string;
90
+ Frequency: "Daily" | "Weekly" | "Monthly";
91
+ EndDate?: string | undefined;
92
+ }>;
93
+ }, "strip", z.ZodTypeAny, {
94
+ accountId: string;
95
+ reportType: string;
96
+ scheduleName: string;
97
+ columns: string[];
98
+ startDate: string;
99
+ endDate: string;
100
+ schedule: {
101
+ StartDate: string;
102
+ Frequency: "Daily" | "Weekly" | "Monthly";
103
+ EndDate?: string | undefined;
104
+ };
105
+ aggregation?: string | undefined;
106
+ }, {
107
+ accountId: string;
108
+ reportType: string;
109
+ scheduleName: string;
110
+ columns: string[];
111
+ startDate: string;
112
+ endDate: string;
113
+ schedule: {
114
+ StartDate: string;
115
+ Frequency: "Daily" | "Weekly" | "Monthly";
116
+ EndDate?: string | undefined;
117
+ };
118
+ aggregation?: string | undefined;
119
+ }>;
120
+ outputSchema: z.ZodObject<{
121
+ scheduleId: z.ZodString;
122
+ scheduleName: z.ZodString;
123
+ timestamp: z.ZodString;
124
+ }, "strip", z.ZodTypeAny, {
125
+ scheduleName: string;
126
+ scheduleId: string;
127
+ timestamp: string;
128
+ }, {
129
+ scheduleName: string;
130
+ scheduleId: string;
131
+ timestamp: string;
132
+ }>;
133
+ annotations: {
134
+ readOnlyHint: boolean;
135
+ openWorldHint: boolean;
136
+ destructiveHint: boolean;
137
+ idempotentHint: boolean;
138
+ };
139
+ inputExamples: {
140
+ label: string;
141
+ input: {
142
+ accountId: string;
143
+ scheduleName: string;
144
+ reportType: string;
145
+ columns: string[];
146
+ startDate: string;
147
+ endDate: string;
148
+ aggregation: string;
149
+ schedule: {
150
+ StartDate: string;
151
+ EndDate: string;
152
+ Frequency: string;
153
+ };
154
+ };
155
+ }[];
156
+ logic: typeof createReportScheduleLogic;
157
+ responseFormatter: typeof createReportScheduleResponseFormatter;
158
+ };
159
+ export {};
160
+ //# sourceMappingURL=create-report-schedule.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-report-schedule.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-report-schedule.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAqBnF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoB2B,CAAC;AAExE,eAAO,MAAM,gCAAgC;;;;;;;;;;;;EAMP,CAAC;AAEvC,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACjF,KAAK,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAEnF,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,yBAAyB,EAChC,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,0BAA0B,CAAC,CAqBrC;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,0BAA0B,GACjC,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCpC,CAAC"}
@@ -0,0 +1,108 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ const TOOL_NAME = "msads_create_report_schedule";
4
+ const TOOL_TITLE = "Create Microsoft Ads Report Schedule";
5
+ const TOOL_DESCRIPTION = `Create a scheduled report request in Microsoft Advertising.
6
+
7
+ Submits a report request with a Schedule object, which Microsoft Advertising will re-run on the configured frequency. Returns a scheduleId to reference this schedule.
8
+
9
+ **Frequency values:** Daily, Weekly, Monthly
10
+
11
+ **Example schedule:**
12
+ \`\`\`json
13
+ {
14
+ "StartDate": "2026-04-07",
15
+ "EndDate": "2026-12-31",
16
+ "Frequency": "Weekly"
17
+ }
18
+ \`\`\`
19
+
20
+ Note: Microsoft Advertising's API has limited schedule management. Use the UI at app.ads.microsoft.com to view, edit, or delete existing schedules.`;
21
+ export const CreateReportScheduleInputSchema = z
22
+ .object({
23
+ accountId: z.string().describe("Microsoft Ads Account ID"),
24
+ scheduleName: z.string().min(1).describe("Name for the scheduled report"),
25
+ reportType: z.string().describe("Report type (e.g., CampaignPerformanceReportRequest)"),
26
+ columns: z.array(z.string()).min(1).describe("Report columns to include"),
27
+ startDate: z.string().describe("Report data start date (YYYY-MM-DD)"),
28
+ endDate: z.string().describe("Report data end date (YYYY-MM-DD)"),
29
+ aggregation: z
30
+ .string()
31
+ .optional()
32
+ .describe("Time aggregation (Daily, Weekly, Monthly). Default: Daily"),
33
+ schedule: z
34
+ .object({
35
+ StartDate: z.string().describe("Schedule start date (YYYY-MM-DD)"),
36
+ EndDate: z.string().optional().describe("Schedule end date (YYYY-MM-DD)"),
37
+ Frequency: z.enum(["Daily", "Weekly", "Monthly"]).describe("How often the report runs"),
38
+ })
39
+ .describe("Schedule configuration"),
40
+ })
41
+ .describe("Parameters for creating a scheduled Microsoft Ads report");
42
+ export const CreateReportScheduleOutputSchema = z
43
+ .object({
44
+ scheduleId: z.string().describe("Schedule ID (ReportRequestId of first scheduled run)"),
45
+ scheduleName: z.string(),
46
+ timestamp: z.string().datetime(),
47
+ })
48
+ .describe("Created report schedule");
49
+ export async function createReportScheduleLogic(input, context, sdkContext) {
50
+ const { msadsReportingService } = resolveSessionServices(sdkContext);
51
+ const result = await msadsReportingService.createReportSchedule({
52
+ reportType: input.reportType,
53
+ accountId: input.accountId,
54
+ columns: input.columns,
55
+ dateRange: { startDate: input.startDate, endDate: input.endDate },
56
+ aggregation: input.aggregation,
57
+ scheduleName: input.scheduleName,
58
+ schedule: input.schedule,
59
+ }, context);
60
+ return {
61
+ scheduleId: result.scheduleId,
62
+ scheduleName: result.scheduleName,
63
+ timestamp: new Date().toISOString(),
64
+ };
65
+ }
66
+ export function createReportScheduleResponseFormatter(result) {
67
+ return [
68
+ {
69
+ type: "text",
70
+ text: `Scheduled report created: ${result.scheduleId}\nName: ${result.scheduleName}\nTimestamp: ${result.timestamp}`,
71
+ },
72
+ ];
73
+ }
74
+ export const createReportScheduleTool = {
75
+ name: TOOL_NAME,
76
+ title: TOOL_TITLE,
77
+ description: TOOL_DESCRIPTION,
78
+ inputSchema: CreateReportScheduleInputSchema,
79
+ outputSchema: CreateReportScheduleOutputSchema,
80
+ annotations: {
81
+ readOnlyHint: false,
82
+ openWorldHint: false,
83
+ destructiveHint: false,
84
+ idempotentHint: false,
85
+ },
86
+ inputExamples: [
87
+ {
88
+ label: "Weekly campaign performance schedule",
89
+ input: {
90
+ accountId: "123456789",
91
+ scheduleName: "Weekly Campaign Report",
92
+ reportType: "CampaignPerformanceReportRequest",
93
+ columns: ["CampaignName", "Impressions", "Clicks", "Spend", "Conversions"],
94
+ startDate: "2026-04-07",
95
+ endDate: "2026-04-13",
96
+ aggregation: "Daily",
97
+ schedule: {
98
+ StartDate: "2026-04-07",
99
+ EndDate: "2026-12-31",
100
+ Frequency: "Weekly",
101
+ },
102
+ },
103
+ },
104
+ ],
105
+ logic: createReportScheduleLogic,
106
+ responseFormatter: createReportScheduleResponseFormatter,
107
+ };
108
+ //# sourceMappingURL=create-report-schedule.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-report-schedule.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/create-report-schedule.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,98 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const DeleteEntityInputSchema: z.ZodObject<{
4
+ entityType: z.ZodEnum<[string, ...string[]]>;
5
+ entityIds: z.ZodArray<z.ZodString, "many">;
6
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
7
+ }, "strip", z.ZodTypeAny, {
8
+ entityType: string;
9
+ entityIds: string[];
10
+ additionalParams?: Record<string, unknown> | undefined;
11
+ }, {
12
+ entityType: string;
13
+ entityIds: string[];
14
+ additionalParams?: Record<string, unknown> | undefined;
15
+ }>;
16
+ export declare const DeleteEntityOutputSchema: z.ZodObject<{
17
+ confirmed: z.ZodBoolean;
18
+ declineReason: z.ZodOptional<z.ZodString>;
19
+ result: z.ZodRecord<z.ZodString, z.ZodAny>;
20
+ entityType: z.ZodString;
21
+ deletedCount: z.ZodNumber;
22
+ timestamp: z.ZodString;
23
+ }, "strip", z.ZodTypeAny, {
24
+ entityType: string;
25
+ timestamp: string;
26
+ result: Record<string, any>;
27
+ confirmed: boolean;
28
+ deletedCount: number;
29
+ declineReason?: string | undefined;
30
+ }, {
31
+ entityType: string;
32
+ timestamp: string;
33
+ result: Record<string, any>;
34
+ confirmed: boolean;
35
+ deletedCount: number;
36
+ declineReason?: string | undefined;
37
+ }>;
38
+ type DeleteEntityInput = z.infer<typeof DeleteEntityInputSchema>;
39
+ type DeleteEntityOutput = z.infer<typeof DeleteEntityOutputSchema>;
40
+ export declare function deleteEntityLogic(input: DeleteEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<DeleteEntityOutput>;
41
+ export declare function deleteEntityResponseFormatter(result: DeleteEntityOutput): McpTextContent[];
42
+ export declare const deleteEntityTool: {
43
+ name: string;
44
+ title: string;
45
+ description: string;
46
+ inputSchema: z.ZodObject<{
47
+ entityType: z.ZodEnum<[string, ...string[]]>;
48
+ entityIds: z.ZodArray<z.ZodString, "many">;
49
+ additionalParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
50
+ }, "strip", z.ZodTypeAny, {
51
+ entityType: string;
52
+ entityIds: string[];
53
+ additionalParams?: Record<string, unknown> | undefined;
54
+ }, {
55
+ entityType: string;
56
+ entityIds: string[];
57
+ additionalParams?: Record<string, unknown> | undefined;
58
+ }>;
59
+ outputSchema: z.ZodObject<{
60
+ confirmed: z.ZodBoolean;
61
+ declineReason: z.ZodOptional<z.ZodString>;
62
+ result: z.ZodRecord<z.ZodString, z.ZodAny>;
63
+ entityType: z.ZodString;
64
+ deletedCount: z.ZodNumber;
65
+ timestamp: z.ZodString;
66
+ }, "strip", z.ZodTypeAny, {
67
+ entityType: string;
68
+ timestamp: string;
69
+ result: Record<string, any>;
70
+ confirmed: boolean;
71
+ deletedCount: number;
72
+ declineReason?: string | undefined;
73
+ }, {
74
+ entityType: string;
75
+ timestamp: string;
76
+ result: Record<string, any>;
77
+ confirmed: boolean;
78
+ deletedCount: number;
79
+ declineReason?: string | undefined;
80
+ }>;
81
+ annotations: {
82
+ readOnlyHint: boolean;
83
+ openWorldHint: boolean;
84
+ idempotentHint: boolean;
85
+ destructiveHint: boolean;
86
+ };
87
+ inputExamples: {
88
+ label: string;
89
+ input: {
90
+ entityType: string;
91
+ entityIds: string[];
92
+ };
93
+ }[];
94
+ logic: typeof deleteEntityLogic;
95
+ responseFormatter: typeof deleteEntityResponseFormatter;
96
+ };
97
+ export {};
98
+ //# sourceMappingURL=delete-entity.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"delete-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/delete-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EASyB,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EASA,CAAC;AAEtC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAkC7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAe1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB5B,CAAC"}