@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,260 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const GetReportInputSchema: z.ZodEffects<z.ZodObject<{
4
+ reportType: z.ZodString;
5
+ accountId: z.ZodString;
6
+ columns: z.ZodArray<z.ZodString, "many">;
7
+ datePreset: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
8
+ startDate: z.ZodOptional<z.ZodString>;
9
+ endDate: z.ZodOptional<z.ZodString>;
10
+ aggregation: z.ZodOptional<z.ZodString>;
11
+ } & Omit<{
12
+ mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
13
+ columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
14
+ offset: z.ZodOptional<z.ZodNumber>;
15
+ maxRows: z.ZodOptional<z.ZodNumber>;
16
+ aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
17
+ aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
18
+ }, "columns">, "strip", z.ZodTypeAny, {
19
+ accountId: string;
20
+ reportType: string;
21
+ columns: string[];
22
+ mode: "rows" | "summary";
23
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
24
+ startDate?: string | undefined;
25
+ endDate?: string | undefined;
26
+ aggregation?: string | undefined;
27
+ offset?: number | undefined;
28
+ maxRows?: number | undefined;
29
+ aggregateBy?: string[] | undefined;
30
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
31
+ }, {
32
+ accountId: string;
33
+ reportType: string;
34
+ columns: string[];
35
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
36
+ startDate?: string | undefined;
37
+ endDate?: string | undefined;
38
+ aggregation?: string | undefined;
39
+ mode?: "rows" | "summary" | undefined;
40
+ offset?: number | undefined;
41
+ maxRows?: number | undefined;
42
+ aggregateBy?: string[] | undefined;
43
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
44
+ }>, {
45
+ accountId: string;
46
+ reportType: string;
47
+ columns: string[];
48
+ mode: "rows" | "summary";
49
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
50
+ startDate?: string | undefined;
51
+ endDate?: string | undefined;
52
+ aggregation?: string | undefined;
53
+ offset?: number | undefined;
54
+ maxRows?: number | undefined;
55
+ aggregateBy?: string[] | undefined;
56
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
57
+ }, {
58
+ accountId: string;
59
+ reportType: string;
60
+ columns: string[];
61
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
62
+ startDate?: string | undefined;
63
+ endDate?: string | undefined;
64
+ aggregation?: string | undefined;
65
+ mode?: "rows" | "summary" | undefined;
66
+ offset?: number | undefined;
67
+ maxRows?: number | undefined;
68
+ aggregateBy?: string[] | undefined;
69
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
70
+ }>;
71
+ export declare const GetReportOutputSchema: z.ZodObject<{
72
+ timestamp: z.ZodString;
73
+ totalRows: z.ZodNumber;
74
+ returnedRows: z.ZodNumber;
75
+ truncated: z.ZodBoolean;
76
+ nextOffset: z.ZodNullable<z.ZodNumber>;
77
+ headers: z.ZodArray<z.ZodString, "many">;
78
+ selectedColumns: z.ZodArray<z.ZodString, "many">;
79
+ mode: z.ZodEnum<["summary", "rows"]>;
80
+ previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
81
+ rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
82
+ warnings: z.ZodArray<z.ZodString, "many">;
83
+ reportRequestId: z.ZodString;
84
+ }, "strip", z.ZodTypeAny, {
85
+ reportRequestId: string;
86
+ headers: string[];
87
+ totalRows: number;
88
+ timestamp: string;
89
+ mode: "rows" | "summary";
90
+ returnedRows: number;
91
+ truncated: boolean;
92
+ nextOffset: number | null;
93
+ selectedColumns: string[];
94
+ warnings: string[];
95
+ rows?: Record<string, any>[] | undefined;
96
+ previewRows?: Record<string, any>[] | undefined;
97
+ }, {
98
+ reportRequestId: string;
99
+ headers: string[];
100
+ totalRows: number;
101
+ timestamp: string;
102
+ mode: "rows" | "summary";
103
+ returnedRows: number;
104
+ truncated: boolean;
105
+ nextOffset: number | null;
106
+ selectedColumns: string[];
107
+ warnings: string[];
108
+ rows?: Record<string, any>[] | undefined;
109
+ previewRows?: Record<string, any>[] | undefined;
110
+ }>;
111
+ type GetReportInput = z.infer<typeof GetReportInputSchema>;
112
+ type GetReportOutput = z.infer<typeof GetReportOutputSchema>;
113
+ export declare function getReportLogic(input: GetReportInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetReportOutput>;
114
+ export declare function getReportResponseFormatter(result: GetReportOutput): McpTextContent[];
115
+ export declare const getReportTool: {
116
+ name: string;
117
+ title: string;
118
+ description: string;
119
+ inputSchema: z.ZodEffects<z.ZodObject<{
120
+ reportType: z.ZodString;
121
+ accountId: z.ZodString;
122
+ columns: z.ZodArray<z.ZodString, "many">;
123
+ datePreset: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
124
+ startDate: z.ZodOptional<z.ZodString>;
125
+ endDate: z.ZodOptional<z.ZodString>;
126
+ aggregation: z.ZodOptional<z.ZodString>;
127
+ } & Omit<{
128
+ mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
129
+ columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
130
+ offset: z.ZodOptional<z.ZodNumber>;
131
+ maxRows: z.ZodOptional<z.ZodNumber>;
132
+ aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
133
+ aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
134
+ }, "columns">, "strip", z.ZodTypeAny, {
135
+ accountId: string;
136
+ reportType: string;
137
+ columns: string[];
138
+ mode: "rows" | "summary";
139
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
140
+ startDate?: string | undefined;
141
+ endDate?: string | undefined;
142
+ aggregation?: string | undefined;
143
+ offset?: number | undefined;
144
+ maxRows?: number | undefined;
145
+ aggregateBy?: string[] | undefined;
146
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
147
+ }, {
148
+ accountId: string;
149
+ reportType: string;
150
+ columns: string[];
151
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
152
+ startDate?: string | undefined;
153
+ endDate?: string | undefined;
154
+ aggregation?: string | undefined;
155
+ mode?: "rows" | "summary" | undefined;
156
+ offset?: number | undefined;
157
+ maxRows?: number | undefined;
158
+ aggregateBy?: string[] | undefined;
159
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
160
+ }>, {
161
+ accountId: string;
162
+ reportType: string;
163
+ columns: string[];
164
+ mode: "rows" | "summary";
165
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
166
+ startDate?: string | undefined;
167
+ endDate?: string | undefined;
168
+ aggregation?: string | undefined;
169
+ offset?: number | undefined;
170
+ maxRows?: number | undefined;
171
+ aggregateBy?: string[] | undefined;
172
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
173
+ }, {
174
+ accountId: string;
175
+ reportType: string;
176
+ columns: string[];
177
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
178
+ startDate?: string | undefined;
179
+ endDate?: string | undefined;
180
+ aggregation?: string | undefined;
181
+ mode?: "rows" | "summary" | undefined;
182
+ offset?: number | undefined;
183
+ maxRows?: number | undefined;
184
+ aggregateBy?: string[] | undefined;
185
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
186
+ }>;
187
+ outputSchema: z.ZodObject<{
188
+ timestamp: z.ZodString;
189
+ totalRows: z.ZodNumber;
190
+ returnedRows: z.ZodNumber;
191
+ truncated: z.ZodBoolean;
192
+ nextOffset: z.ZodNullable<z.ZodNumber>;
193
+ headers: z.ZodArray<z.ZodString, "many">;
194
+ selectedColumns: z.ZodArray<z.ZodString, "many">;
195
+ mode: z.ZodEnum<["summary", "rows"]>;
196
+ previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
197
+ rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
198
+ warnings: z.ZodArray<z.ZodString, "many">;
199
+ reportRequestId: z.ZodString;
200
+ }, "strip", z.ZodTypeAny, {
201
+ reportRequestId: string;
202
+ headers: string[];
203
+ totalRows: number;
204
+ timestamp: string;
205
+ mode: "rows" | "summary";
206
+ returnedRows: number;
207
+ truncated: boolean;
208
+ nextOffset: number | null;
209
+ selectedColumns: string[];
210
+ warnings: string[];
211
+ rows?: Record<string, any>[] | undefined;
212
+ previewRows?: Record<string, any>[] | undefined;
213
+ }, {
214
+ reportRequestId: string;
215
+ headers: string[];
216
+ totalRows: number;
217
+ timestamp: string;
218
+ mode: "rows" | "summary";
219
+ returnedRows: number;
220
+ truncated: boolean;
221
+ nextOffset: number | null;
222
+ selectedColumns: string[];
223
+ warnings: string[];
224
+ rows?: Record<string, any>[] | undefined;
225
+ previewRows?: Record<string, any>[] | undefined;
226
+ }>;
227
+ annotations: {
228
+ readOnlyHint: boolean;
229
+ openWorldHint: boolean;
230
+ idempotentHint: boolean;
231
+ destructiveHint: boolean;
232
+ };
233
+ inputExamples: ({
234
+ label: string;
235
+ input: {
236
+ reportType: string;
237
+ accountId: string;
238
+ columns: string[];
239
+ datePreset: string;
240
+ mode: string;
241
+ startDate?: undefined;
242
+ endDate?: undefined;
243
+ };
244
+ } | {
245
+ label: string;
246
+ input: {
247
+ reportType: string;
248
+ accountId: string;
249
+ columns: string[];
250
+ startDate: string;
251
+ endDate: string;
252
+ datePreset?: undefined;
253
+ mode?: undefined;
254
+ };
255
+ })[];
256
+ logic: typeof getReportLogic;
257
+ responseFormatter: typeof getReportResponseFormatter;
258
+ };
259
+ export {};
260
+ //# sourceMappingURL=get-report.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-report.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-report.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAUnF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B2B,CAAC;AAE7D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMN,CAAC;AAE7B,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC3D,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7D,wBAAsB,cAAc,CAClC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,eAAe,CAAC,CAiC1B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,EAAE,CAOpF;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCzB,CAAC"}
@@ -0,0 +1,118 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { arrayRowsToRecords, createReportView, formatReportViewResponse, getReportViewFetchLimit, resolveDatePreset, DATE_PRESET_VALUES, ReportViewInputSchema, ReportViewOutputSchema, } from "@cesteral/shared";
4
+ const TOOL_NAME = "msads_get_report";
5
+ const TOOL_TITLE = "Get Microsoft Ads Report";
6
+ const TOOL_DESCRIPTION = `Submit a Microsoft Advertising report request, poll until complete, and download results (blocking).
7
+
8
+ Report types: CampaignPerformanceReportRequest, AdGroupPerformanceReportRequest, AdPerformanceReportRequest, KeywordPerformanceReportRequest, SearchQueryPerformanceReportRequest, etc.
9
+
10
+ This is a blocking operation — it will wait for the report to complete before returning.`;
11
+ export const GetReportInputSchema = z
12
+ .object({
13
+ reportType: z.string().describe("Report type (e.g., CampaignPerformanceReportRequest)"),
14
+ accountId: z.string().describe("Microsoft Ads Account ID"),
15
+ columns: z
16
+ .array(z.string())
17
+ .min(1)
18
+ .describe("Report columns to include (e.g., CampaignName, Impressions, Clicks)"),
19
+ datePreset: z
20
+ .enum(DATE_PRESET_VALUES)
21
+ .optional()
22
+ .describe("Preset date range. Use this OR startDate+endDate (not both)"),
23
+ startDate: z
24
+ .string()
25
+ .optional()
26
+ .describe("Start date (YYYY-MM-DD, required if datePreset not provided)"),
27
+ endDate: z
28
+ .string()
29
+ .optional()
30
+ .describe("End date (YYYY-MM-DD, required if datePreset not provided)"),
31
+ aggregation: z
32
+ .string()
33
+ .optional()
34
+ .describe("Time aggregation (Daily, Weekly, Monthly, Hourly). Default: Daily"),
35
+ })
36
+ .merge(ReportViewInputSchema.omit({ columns: true }))
37
+ .refine((data) => data.datePreset !== undefined || (data.startDate !== undefined && data.endDate !== undefined), { message: "Provide either datePreset or both startDate and endDate" })
38
+ .describe("Parameters for running a Microsoft Ads report");
39
+ export const GetReportOutputSchema = z
40
+ .object({
41
+ reportRequestId: z.string(),
42
+ ...ReportViewOutputSchema.shape,
43
+ timestamp: z.string().datetime(),
44
+ })
45
+ .describe("Report result");
46
+ export async function getReportLogic(input, context, sdkContext) {
47
+ const { msadsReportingService } = resolveSessionServices(sdkContext);
48
+ let resolvedStartDate = input.startDate;
49
+ let resolvedEndDate = input.endDate;
50
+ if (input.datePreset) {
51
+ const resolved = resolveDatePreset(input.datePreset);
52
+ resolvedStartDate = resolved.startDate;
53
+ resolvedEndDate = resolved.endDate;
54
+ }
55
+ const result = await msadsReportingService.getReport({
56
+ reportType: input.reportType,
57
+ accountId: input.accountId,
58
+ columns: input.columns,
59
+ dateRange: { startDate: resolvedStartDate, endDate: resolvedEndDate },
60
+ aggregation: input.aggregation,
61
+ }, getReportViewFetchLimit(input), context);
62
+ return {
63
+ reportRequestId: result.reportRequestId,
64
+ ...createReportView({
65
+ headers: result.headers,
66
+ rows: arrayRowsToRecords(result.headers, result.rows),
67
+ totalRows: result.totalRows,
68
+ input,
69
+ }),
70
+ timestamp: new Date().toISOString(),
71
+ };
72
+ }
73
+ export function getReportResponseFormatter(result) {
74
+ return [
75
+ {
76
+ type: "text",
77
+ text: `Report ${result.reportRequestId} completed\n\n${formatReportViewResponse(result, "Report data")}\n\nTimestamp: ${result.timestamp}`,
78
+ },
79
+ ];
80
+ }
81
+ export const getReportTool = {
82
+ name: TOOL_NAME,
83
+ title: TOOL_TITLE,
84
+ description: TOOL_DESCRIPTION,
85
+ inputSchema: GetReportInputSchema,
86
+ outputSchema: GetReportOutputSchema,
87
+ annotations: {
88
+ readOnlyHint: true,
89
+ openWorldHint: false,
90
+ idempotentHint: false,
91
+ destructiveHint: false,
92
+ },
93
+ inputExamples: [
94
+ {
95
+ label: "Campaign performance report",
96
+ input: {
97
+ reportType: "CampaignPerformanceReportRequest",
98
+ accountId: "123456789",
99
+ columns: ["CampaignName", "Impressions", "Clicks", "Spend"],
100
+ datePreset: "LAST_30_DAYS",
101
+ mode: "summary",
102
+ },
103
+ },
104
+ {
105
+ label: "Campaign performance with explicit dates",
106
+ input: {
107
+ reportType: "CampaignPerformanceReportRequest",
108
+ accountId: "123456789",
109
+ columns: ["CampaignName", "Impressions", "Clicks", "Spend"],
110
+ startDate: "2026-01-01",
111
+ endDate: "2026-01-31",
112
+ },
113
+ },
114
+ ],
115
+ logic: getReportLogic,
116
+ responseFormatter: getReportResponseFormatter,
117
+ };
118
+ //# sourceMappingURL=get-report.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-report.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-report.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,79 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const ImportFromGoogleInputSchema: z.ZodObject<{
4
+ operation: z.ZodEnum<["create", "getStatus", "getResults"]>;
5
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
6
+ }, "strip", z.ZodTypeAny, {
7
+ data: Record<string, unknown>;
8
+ operation: "create" | "getStatus" | "getResults";
9
+ }, {
10
+ data: Record<string, unknown>;
11
+ operation: "create" | "getStatus" | "getResults";
12
+ }>;
13
+ export declare const ImportFromGoogleOutputSchema: z.ZodObject<{
14
+ result: z.ZodRecord<z.ZodString, z.ZodAny>;
15
+ operation: z.ZodString;
16
+ timestamp: z.ZodString;
17
+ }, "strip", z.ZodTypeAny, {
18
+ timestamp: string;
19
+ result: Record<string, any>;
20
+ operation: string;
21
+ }, {
22
+ timestamp: string;
23
+ result: Record<string, any>;
24
+ operation: string;
25
+ }>;
26
+ type ImportFromGoogleInput = z.infer<typeof ImportFromGoogleInputSchema>;
27
+ type ImportFromGoogleOutput = z.infer<typeof ImportFromGoogleOutputSchema>;
28
+ export declare function importFromGoogleLogic(input: ImportFromGoogleInput, context: RequestContext, sdkContext?: SdkContext): Promise<ImportFromGoogleOutput>;
29
+ export declare function importFromGoogleResponseFormatter(result: ImportFromGoogleOutput): McpTextContent[];
30
+ export declare const importFromGoogleTool: {
31
+ name: string;
32
+ title: string;
33
+ description: string;
34
+ inputSchema: z.ZodObject<{
35
+ operation: z.ZodEnum<["create", "getStatus", "getResults"]>;
36
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
37
+ }, "strip", z.ZodTypeAny, {
38
+ data: Record<string, unknown>;
39
+ operation: "create" | "getStatus" | "getResults";
40
+ }, {
41
+ data: Record<string, unknown>;
42
+ operation: "create" | "getStatus" | "getResults";
43
+ }>;
44
+ outputSchema: z.ZodObject<{
45
+ result: z.ZodRecord<z.ZodString, z.ZodAny>;
46
+ operation: z.ZodString;
47
+ timestamp: z.ZodString;
48
+ }, "strip", z.ZodTypeAny, {
49
+ timestamp: string;
50
+ result: Record<string, any>;
51
+ operation: string;
52
+ }, {
53
+ timestamp: string;
54
+ result: Record<string, any>;
55
+ operation: string;
56
+ }>;
57
+ annotations: {
58
+ readOnlyHint: boolean;
59
+ openWorldHint: boolean;
60
+ idempotentHint: boolean;
61
+ destructiveHint: boolean;
62
+ };
63
+ inputExamples: {
64
+ label: string;
65
+ input: {
66
+ operation: string;
67
+ data: {
68
+ ImportJobs: {
69
+ Type: string;
70
+ GoogleAccountId: string;
71
+ }[];
72
+ };
73
+ };
74
+ }[];
75
+ logic: typeof importFromGoogleLogic;
76
+ responseFormatter: typeof importFromGoogleResponseFormatter;
77
+ };
78
+ export {};
79
+ //# sourceMappingURL=import-from-google.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"import-from-google.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/import-from-google.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;AAanF,eAAO,MAAM,2BAA2B;;;;;;;;;EAWO,CAAC;AAEhD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;EAMH,CAAC;AAEvC,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AACzE,KAAK,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAQ3E,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,sBAAsB,CAAC,CAqBjC;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,sBAAsB,GAC7B,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BhC,CAAC"}
@@ -0,0 +1,88 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
4
+ const TOOL_NAME = "msads_import_from_google";
5
+ const TOOL_TITLE = "Import from Google Ads";
6
+ const TOOL_DESCRIPTION = `Import campaigns from Google Ads into Microsoft Advertising using the ImportJobs API.
7
+
8
+ This is a Microsoft Ads-specific feature that allows migrating Google Ads campaigns, ad groups, ads, and keywords into your Microsoft Ads account.
9
+
10
+ Operations:
11
+ - create: Create a new import job
12
+ - getStatus: Check import job status
13
+ - getResults: Get import job results`;
14
+ export const ImportFromGoogleInputSchema = z
15
+ .object({
16
+ operation: z
17
+ .enum(["create", "getStatus", "getResults"])
18
+ .describe("Import operation to perform"),
19
+ data: z
20
+ .record(z.unknown())
21
+ .describe("Operation data — for create: import job config; for getStatus/getResults: { ImportJobId }"),
22
+ })
23
+ .describe("Parameters for Google Ads import");
24
+ export const ImportFromGoogleOutputSchema = z
25
+ .object({
26
+ result: z.record(z.any()),
27
+ operation: z.string(),
28
+ timestamp: z.string().datetime(),
29
+ })
30
+ .describe("Import operation result");
31
+ const OPERATION_PATHS = {
32
+ create: "/ImportJobs",
33
+ getStatus: "/ImportJobs/QueryByIds",
34
+ getResults: "/ImportResults/QueryByIds",
35
+ };
36
+ export async function importFromGoogleLogic(input, context, sdkContext) {
37
+ const { msadsService } = resolveSessionServices(sdkContext);
38
+ const path = OPERATION_PATHS[input.operation];
39
+ if (!path) {
40
+ throw new McpError(JsonRpcErrorCode.InvalidParams, `Unknown import operation: ${input.operation}`);
41
+ }
42
+ const result = (await msadsService.executeOperation(path, input.data, context));
43
+ return {
44
+ result,
45
+ operation: input.operation,
46
+ timestamp: new Date().toISOString(),
47
+ };
48
+ }
49
+ export function importFromGoogleResponseFormatter(result) {
50
+ return [
51
+ {
52
+ type: "text",
53
+ text: `Google Ads import ${result.operation} completed\n\nResult:\n${JSON.stringify(result.result, null, 2)}\n\nTimestamp: ${result.timestamp}`,
54
+ },
55
+ ];
56
+ }
57
+ export const importFromGoogleTool = {
58
+ name: TOOL_NAME,
59
+ title: TOOL_TITLE,
60
+ description: TOOL_DESCRIPTION,
61
+ inputSchema: ImportFromGoogleInputSchema,
62
+ outputSchema: ImportFromGoogleOutputSchema,
63
+ annotations: {
64
+ readOnlyHint: false,
65
+ openWorldHint: false,
66
+ idempotentHint: false,
67
+ destructiveHint: false,
68
+ },
69
+ inputExamples: [
70
+ {
71
+ label: "Create Google Ads import job",
72
+ input: {
73
+ operation: "create",
74
+ data: {
75
+ ImportJobs: [
76
+ {
77
+ Type: "GoogleImportJob",
78
+ GoogleAccountId: "123-456-7890",
79
+ },
80
+ ],
81
+ },
82
+ },
83
+ },
84
+ ],
85
+ logic: importFromGoogleLogic,
86
+ responseFormatter: importFromGoogleResponseFormatter,
87
+ };
88
+ //# sourceMappingURL=import-from-google.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"import-from-google.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/import-from-google.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { type ToolDefinitionForFactory } from "@cesteral/shared";
2
+ export declare const productionTools: ToolDefinitionForFactory[];
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAwB,KAAK,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEvF,eAAO,MAAM,eAAe,EAAE,wBAAwB,EA0BrD,CAAC"}
@@ -0,0 +1,53 @@
1
+ import { listEntitiesTool } from "./list-entities.tool.js";
2
+ import { getEntityTool } from "./get-entity.tool.js";
3
+ import { createEntityTool } from "./create-entity.tool.js";
4
+ import { updateEntityTool } from "./update-entity.tool.js";
5
+ import { deleteEntityTool } from "./delete-entity.tool.js";
6
+ import { listAccountsTool } from "./list-accounts.tool.js";
7
+ import { getReportTool } from "./get-report.tool.js";
8
+ import { getReportBreakdownsTool } from "./get-report-breakdowns.tool.js";
9
+ import { submitReportTool } from "./submit-report.tool.js";
10
+ import { checkReportStatusTool } from "./check-report-status.tool.js";
11
+ import { downloadReportTool } from "./download-report.tool.js";
12
+ import { bulkCreateEntitiesTool } from "./bulk-create-entities.tool.js";
13
+ import { bulkUpdateEntitiesTool } from "./bulk-update-entities.tool.js";
14
+ import { bulkUpdateStatusTool } from "./bulk-update-status.tool.js";
15
+ import { adjustBidsTool } from "./adjust-bids.tool.js";
16
+ import { manageAdExtensionsTool } from "./manage-ad-extensions.tool.js";
17
+ import { manageCriterionsTool } from "./manage-criterions.tool.js";
18
+ import { getAdDetailsTool } from "./get-ad-details.tool.js";
19
+ import { validateEntityTool } from "./validate-entity.tool.js";
20
+ import { importFromGoogleTool } from "./import-from-google.tool.js";
21
+ import { searchTargetingTool } from "./search-targeting.tool.js";
22
+ import { createReportScheduleTool } from "./create-report-schedule.tool.js";
23
+ import { listReportSchedulesTool } from "./list-report-schedules.tool.js";
24
+ import { deleteReportScheduleTool } from "./delete-report-schedule.tool.js";
25
+ import { createToolSearchTool } from "@cesteral/shared";
26
+ export const productionTools = [
27
+ listEntitiesTool,
28
+ getEntityTool,
29
+ createEntityTool,
30
+ updateEntityTool,
31
+ deleteEntityTool,
32
+ listAccountsTool,
33
+ getReportTool,
34
+ getReportBreakdownsTool,
35
+ submitReportTool,
36
+ checkReportStatusTool,
37
+ downloadReportTool,
38
+ bulkCreateEntitiesTool,
39
+ bulkUpdateEntitiesTool,
40
+ bulkUpdateStatusTool,
41
+ adjustBidsTool,
42
+ manageAdExtensionsTool,
43
+ manageCriterionsTool,
44
+ getAdDetailsTool,
45
+ validateEntityTool,
46
+ importFromGoogleTool,
47
+ searchTargetingTool,
48
+ createReportScheduleTool,
49
+ listReportSchedulesTool,
50
+ deleteReportScheduleTool,
51
+ createToolSearchTool({ platform: "msads", getTools: () => productionTools }),
52
+ ];
53
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAiC,MAAM,kBAAkB,CAAC;AAEvF,MAAM,CAAC,MAAM,eAAe,GAA+B;IACzD,gBAAgB;IAChB,aAAa;IACb,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,aAAa;IACb,uBAAuB;IACvB,gBAAgB;IAChB,qBAAqB;IACrB,kBAAkB;IAClB,sBAAsB;IACtB,sBAAsB;IACtB,oBAAoB;IACpB,cAAc;IACd,sBAAsB;IACtB,oBAAoB;IACpB,gBAAgB;IAChB,kBAAkB;IAClB,oBAAoB;IACpB,mBAAmB;IACnB,wBAAwB;IACxB,uBAAuB;IACvB,wBAAwB;IACxB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC;CAC7E,CAAC"}