@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,135 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const ListAccountsInputSchema: z.ZodEffects<z.ZodObject<{
4
+ predicates: z.ZodArray<z.ZodObject<{
5
+ Field: z.ZodString;
6
+ Operator: z.ZodString;
7
+ Value: z.ZodString;
8
+ }, "strip", z.ZodTypeAny, {
9
+ Field: string;
10
+ Operator: string;
11
+ Value: string;
12
+ }, {
13
+ Field: string;
14
+ Operator: string;
15
+ Value: string;
16
+ }>, "many">;
17
+ }, "strip", z.ZodTypeAny, {
18
+ predicates: {
19
+ Field: string;
20
+ Operator: string;
21
+ Value: string;
22
+ }[];
23
+ }, {
24
+ predicates: {
25
+ Field: string;
26
+ Operator: string;
27
+ Value: string;
28
+ }[];
29
+ }>, {
30
+ predicates: {
31
+ Field: string;
32
+ Operator: string;
33
+ Value: string;
34
+ }[];
35
+ }, {
36
+ predicates: {
37
+ Field: string;
38
+ Operator: string;
39
+ Value: string;
40
+ }[];
41
+ }>;
42
+ export declare const ListAccountsOutputSchema: z.ZodObject<{
43
+ accounts: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
44
+ count: z.ZodNumber;
45
+ timestamp: z.ZodString;
46
+ }, "strip", z.ZodTypeAny, {
47
+ count: number;
48
+ timestamp: string;
49
+ accounts: Record<string, any>[];
50
+ }, {
51
+ count: number;
52
+ timestamp: string;
53
+ accounts: Record<string, any>[];
54
+ }>;
55
+ type ListAccountsInput = z.infer<typeof ListAccountsInputSchema>;
56
+ type ListAccountsOutput = z.infer<typeof ListAccountsOutputSchema>;
57
+ export declare function listAccountsLogic(input: ListAccountsInput, context: RequestContext, sdkContext?: SdkContext): Promise<ListAccountsOutput>;
58
+ export declare function listAccountsResponseFormatter(result: ListAccountsOutput): McpTextContent[];
59
+ export declare const listAccountsTool: {
60
+ name: string;
61
+ title: string;
62
+ description: string;
63
+ inputSchema: z.ZodEffects<z.ZodObject<{
64
+ predicates: z.ZodArray<z.ZodObject<{
65
+ Field: z.ZodString;
66
+ Operator: z.ZodString;
67
+ Value: z.ZodString;
68
+ }, "strip", z.ZodTypeAny, {
69
+ Field: string;
70
+ Operator: string;
71
+ Value: string;
72
+ }, {
73
+ Field: string;
74
+ Operator: string;
75
+ Value: string;
76
+ }>, "many">;
77
+ }, "strip", z.ZodTypeAny, {
78
+ predicates: {
79
+ Field: string;
80
+ Operator: string;
81
+ Value: string;
82
+ }[];
83
+ }, {
84
+ predicates: {
85
+ Field: string;
86
+ Operator: string;
87
+ Value: string;
88
+ }[];
89
+ }>, {
90
+ predicates: {
91
+ Field: string;
92
+ Operator: string;
93
+ Value: string;
94
+ }[];
95
+ }, {
96
+ predicates: {
97
+ Field: string;
98
+ Operator: string;
99
+ Value: string;
100
+ }[];
101
+ }>;
102
+ outputSchema: z.ZodObject<{
103
+ accounts: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
104
+ count: z.ZodNumber;
105
+ timestamp: z.ZodString;
106
+ }, "strip", z.ZodTypeAny, {
107
+ count: number;
108
+ timestamp: string;
109
+ accounts: Record<string, any>[];
110
+ }, {
111
+ count: number;
112
+ timestamp: string;
113
+ accounts: Record<string, any>[];
114
+ }>;
115
+ annotations: {
116
+ readOnlyHint: boolean;
117
+ openWorldHint: boolean;
118
+ idempotentHint: boolean;
119
+ destructiveHint: boolean;
120
+ };
121
+ inputExamples: {
122
+ label: string;
123
+ input: {
124
+ predicates: {
125
+ Field: string;
126
+ Operator: string;
127
+ Value: string;
128
+ }[];
129
+ };
130
+ }[];
131
+ logic: typeof listAccountsLogic;
132
+ responseFormatter: typeof listAccountsResponseFormatter;
133
+ };
134
+ export {};
135
+ //# sourceMappingURL=list-accounts.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list-accounts.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-accounts.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;AAmBnF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBwB,CAAC;AAE7D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAMH,CAAC;AAEnC,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,CAoB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAa1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsB5B,CAAC"}
@@ -0,0 +1,88 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ const TOOL_NAME = "msads_list_accounts";
4
+ const TOOL_TITLE = "List Microsoft Ads Accounts";
5
+ const TOOL_DESCRIPTION = `List accessible Microsoft Advertising accounts for the authenticated user.
6
+
7
+ Uses the Customer Management API SearchAccounts operation.
8
+
9
+ Microsoft Advertising requires at least one predicate for SearchAccounts.`;
10
+ const PredicateSchema = z.object({
11
+ Field: z
12
+ .string()
13
+ .min(1)
14
+ .describe("SearchAccounts field name, e.g. UserId or AccountLifeCycleStatus"),
15
+ Operator: z.string().min(1).describe("Predicate operator, e.g. Equals"),
16
+ Value: z.string().min(1).describe("Predicate value"),
17
+ });
18
+ export const ListAccountsInputSchema = z
19
+ .object({
20
+ predicates: z
21
+ .array(PredicateSchema)
22
+ .min(1)
23
+ .max(2)
24
+ .describe("One SearchAccounts predicate, or two when filtering by AccountLifeCycleStatus plus another field such as UserId"),
25
+ })
26
+ .refine(({ predicates }) => predicates.length === 1 ||
27
+ predicates.some((predicate) => predicate.Field === "AccountLifeCycleStatus"), {
28
+ message: "A second predicate is only valid when one predicate uses Field='AccountLifeCycleStatus'",
29
+ path: ["predicates"],
30
+ })
31
+ .describe("Parameters for listing Microsoft Ads accounts");
32
+ export const ListAccountsOutputSchema = z
33
+ .object({
34
+ accounts: z.array(z.record(z.any())),
35
+ count: z.number(),
36
+ timestamp: z.string().datetime(),
37
+ })
38
+ .describe("Account list result");
39
+ export async function listAccountsLogic(input, context, sdkContext) {
40
+ const { msadsCustomerService } = resolveSessionServices(sdkContext);
41
+ const result = (await msadsCustomerService.executeReadOperation("/Accounts/Search", {
42
+ Predicates: input.predicates,
43
+ Ordering: null,
44
+ PageInfo: { Index: 0, Size: 100 },
45
+ }, context));
46
+ const accounts = result.Accounts ?? [];
47
+ return {
48
+ accounts,
49
+ count: accounts.length,
50
+ timestamp: new Date().toISOString(),
51
+ };
52
+ }
53
+ export function listAccountsResponseFormatter(result) {
54
+ const summary = `Found ${result.count} accounts`;
55
+ const accounts = result.accounts.length > 0
56
+ ? `\n\n${JSON.stringify(result.accounts, null, 2)}`
57
+ : "\n\nNo accounts found";
58
+ return [
59
+ {
60
+ type: "text",
61
+ text: `${summary}${accounts}\n\nTimestamp: ${result.timestamp}`,
62
+ },
63
+ ];
64
+ }
65
+ export const listAccountsTool = {
66
+ name: TOOL_NAME,
67
+ title: TOOL_TITLE,
68
+ description: TOOL_DESCRIPTION,
69
+ inputSchema: ListAccountsInputSchema,
70
+ outputSchema: ListAccountsOutputSchema,
71
+ annotations: {
72
+ readOnlyHint: true,
73
+ openWorldHint: false,
74
+ idempotentHint: true,
75
+ destructiveHint: false,
76
+ },
77
+ inputExamples: [
78
+ {
79
+ label: "List accounts for a user",
80
+ input: {
81
+ predicates: [{ Field: "UserId", Operator: "Equals", Value: "123456" }],
82
+ },
83
+ },
84
+ ],
85
+ logic: listAccountsLogic,
86
+ responseFormatter: listAccountsResponseFormatter,
87
+ };
88
+ //# sourceMappingURL=list-accounts.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list-accounts.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-accounts.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,120 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const ListEntitiesInputSchema: z.ZodEffects<z.ZodObject<{
4
+ entityType: z.ZodEnum<[string, ...string[]]>;
5
+ accountId: z.ZodOptional<z.ZodString>;
6
+ parentId: z.ZodOptional<z.ZodString>;
7
+ filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
8
+ }, "strip", z.ZodTypeAny, {
9
+ entityType: string;
10
+ parentId?: string | undefined;
11
+ accountId?: string | undefined;
12
+ filters?: Record<string, unknown> | undefined;
13
+ }, {
14
+ entityType: string;
15
+ parentId?: string | undefined;
16
+ accountId?: string | undefined;
17
+ filters?: Record<string, unknown> | undefined;
18
+ }>, {
19
+ entityType: string;
20
+ parentId?: string | undefined;
21
+ accountId?: string | undefined;
22
+ filters?: Record<string, unknown> | undefined;
23
+ }, {
24
+ entityType: string;
25
+ parentId?: string | undefined;
26
+ accountId?: string | undefined;
27
+ filters?: Record<string, unknown> | undefined;
28
+ }>;
29
+ export declare const ListEntitiesOutputSchema: z.ZodObject<{
30
+ entities: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
31
+ entityType: z.ZodString;
32
+ count: z.ZodNumber;
33
+ timestamp: z.ZodString;
34
+ }, "strip", z.ZodTypeAny, {
35
+ entityType: string;
36
+ entities: Record<string, any>[];
37
+ count: number;
38
+ timestamp: string;
39
+ }, {
40
+ entityType: string;
41
+ entities: Record<string, any>[];
42
+ count: number;
43
+ timestamp: string;
44
+ }>;
45
+ type ListEntitiesInput = z.infer<typeof ListEntitiesInputSchema>;
46
+ type ListEntitiesOutput = z.infer<typeof ListEntitiesOutputSchema>;
47
+ export declare function listEntitiesLogic(input: ListEntitiesInput, context: RequestContext, sdkContext?: SdkContext): Promise<ListEntitiesOutput>;
48
+ export declare function listEntitiesResponseFormatter(result: ListEntitiesOutput): McpTextContent[];
49
+ export declare const listEntitiesTool: {
50
+ name: string;
51
+ title: string;
52
+ description: string;
53
+ inputSchema: z.ZodEffects<z.ZodObject<{
54
+ entityType: z.ZodEnum<[string, ...string[]]>;
55
+ accountId: z.ZodOptional<z.ZodString>;
56
+ parentId: z.ZodOptional<z.ZodString>;
57
+ filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
58
+ }, "strip", z.ZodTypeAny, {
59
+ entityType: string;
60
+ parentId?: string | undefined;
61
+ accountId?: string | undefined;
62
+ filters?: Record<string, unknown> | undefined;
63
+ }, {
64
+ entityType: string;
65
+ parentId?: string | undefined;
66
+ accountId?: string | undefined;
67
+ filters?: Record<string, unknown> | undefined;
68
+ }>, {
69
+ entityType: string;
70
+ parentId?: string | undefined;
71
+ accountId?: string | undefined;
72
+ filters?: Record<string, unknown> | undefined;
73
+ }, {
74
+ entityType: string;
75
+ parentId?: string | undefined;
76
+ accountId?: string | undefined;
77
+ filters?: Record<string, unknown> | undefined;
78
+ }>;
79
+ outputSchema: z.ZodObject<{
80
+ entities: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
81
+ entityType: z.ZodString;
82
+ count: z.ZodNumber;
83
+ timestamp: z.ZodString;
84
+ }, "strip", z.ZodTypeAny, {
85
+ entityType: string;
86
+ entities: Record<string, any>[];
87
+ count: number;
88
+ timestamp: string;
89
+ }, {
90
+ entityType: string;
91
+ entities: Record<string, any>[];
92
+ count: number;
93
+ timestamp: string;
94
+ }>;
95
+ annotations: {
96
+ readOnlyHint: boolean;
97
+ openWorldHint: boolean;
98
+ idempotentHint: boolean;
99
+ destructiveHint: boolean;
100
+ };
101
+ inputExamples: ({
102
+ label: string;
103
+ input: {
104
+ entityType: string;
105
+ accountId: string;
106
+ parentId?: undefined;
107
+ };
108
+ } | {
109
+ label: string;
110
+ input: {
111
+ entityType: string;
112
+ parentId: string;
113
+ accountId?: undefined;
114
+ };
115
+ })[];
116
+ logic: typeof listEntitiesLogic;
117
+ responseFormatter: typeof listEntitiesResponseFormatter;
118
+ };
119
+ export {};
120
+ //# sourceMappingURL=list-entities.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-entities.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;AAYnF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;EA2BwB,CAAC;AAE7D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAOJ,CAAC;AAElC,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,CAqB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAa1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwB5B,CAAC"}
@@ -0,0 +1,100 @@
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_list_entities";
5
+ const TOOL_TITLE = "List Microsoft Ads Entities";
6
+ const TOOL_DESCRIPTION = `List Microsoft Advertising entities by account or parent entity.
7
+
8
+ Supported entity types: ${getEntityTypeEnum().join(", ")}
9
+
10
+ - Top-level entities (campaign, budget, label): list by accountId
11
+ - Child entities (adGroup, ad, keyword): list by parentId (campaign or ad group)
12
+ - Use filters to narrow results`;
13
+ export const ListEntitiesInputSchema = z
14
+ .object({
15
+ entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to list"),
16
+ accountId: z.string().optional().describe("Microsoft Ads Account ID (for top-level entities)"),
17
+ parentId: z
18
+ .string()
19
+ .optional()
20
+ .describe("Parent entity ID (e.g., CampaignId for adGroups, AdGroupId for ads/keywords)"),
21
+ filters: z.record(z.unknown()).optional().describe("Additional filters to pass to the API"),
22
+ })
23
+ .superRefine((data, ctx) => {
24
+ if (data.entityType === "campaign" && !data.accountId) {
25
+ ctx.addIssue({
26
+ code: z.ZodIssueCode.custom,
27
+ path: ["accountId"],
28
+ message: "accountId is required for campaign queries",
29
+ });
30
+ }
31
+ if (["adGroup", "ad", "keyword"].includes(data.entityType) && !data.parentId) {
32
+ ctx.addIssue({
33
+ code: z.ZodIssueCode.custom,
34
+ path: ["parentId"],
35
+ message: "parentId is required for adGroup, ad, and keyword queries",
36
+ });
37
+ }
38
+ })
39
+ .describe("Parameters for listing Microsoft Ads entities");
40
+ export const ListEntitiesOutputSchema = z
41
+ .object({
42
+ entities: z.array(z.record(z.any())).describe("List of entities"),
43
+ entityType: z.string(),
44
+ count: z.number(),
45
+ timestamp: z.string().datetime(),
46
+ })
47
+ .describe("Entity list result");
48
+ export async function listEntitiesLogic(input, context, sdkContext) {
49
+ const { msadsService } = resolveSessionServices(sdkContext);
50
+ const { entities: rawEntities } = await msadsService.listEntities(input.entityType, {
51
+ accountId: input.accountId,
52
+ parentId: input.parentId,
53
+ filters: input.filters,
54
+ }, context);
55
+ const entities = rawEntities;
56
+ return {
57
+ entities,
58
+ entityType: input.entityType,
59
+ count: entities.length,
60
+ timestamp: new Date().toISOString(),
61
+ };
62
+ }
63
+ export function listEntitiesResponseFormatter(result) {
64
+ const summary = `Found ${result.count} ${result.entityType} entities`;
65
+ const entities = result.entities.length > 0
66
+ ? `\n\nEntities:\n${JSON.stringify(result.entities, null, 2)}`
67
+ : "\n\nNo entities found";
68
+ return [
69
+ {
70
+ type: "text",
71
+ text: `${summary}${entities}\n\nTimestamp: ${result.timestamp}`,
72
+ },
73
+ ];
74
+ }
75
+ export const listEntitiesTool = {
76
+ name: TOOL_NAME,
77
+ title: TOOL_TITLE,
78
+ description: TOOL_DESCRIPTION,
79
+ inputSchema: ListEntitiesInputSchema,
80
+ outputSchema: ListEntitiesOutputSchema,
81
+ annotations: {
82
+ readOnlyHint: true,
83
+ openWorldHint: false,
84
+ idempotentHint: true,
85
+ destructiveHint: false,
86
+ },
87
+ inputExamples: [
88
+ {
89
+ label: "List campaigns",
90
+ input: { entityType: "campaign", accountId: "123456789" },
91
+ },
92
+ {
93
+ label: "List ad groups for a campaign",
94
+ input: { entityType: "adGroup", parentId: "987654321" },
95
+ },
96
+ ],
97
+ logic: listEntitiesLogic,
98
+ responseFormatter: listEntitiesResponseFormatter,
99
+ };
100
+ //# sourceMappingURL=list-entities.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-entities.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;;0BAEC,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;;;;gCAIxB,CAAC;AAEjC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC1E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAC9F,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;IAC3F,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CAC5F,CAAC;KACD,WAAW,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;IACzB,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACtD,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,IAAI,EAAE,CAAC,WAAW,CAAC;YACnB,OAAO,EAAE,4CAA4C;SACtD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7E,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,IAAI,EAAE,CAAC,UAAU,CAAC;YAClB,OAAO,EAAE,2DAA2D;SACrE,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;KACD,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACjE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AAKlC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,YAAY,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,YAAY,CAAC,YAAY,CAC/D,KAAK,CAAC,UAA6B,EACnC;QACE,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,EACD,OAAO,CACR,CAAC;IAEF,MAAM,QAAQ,GAAG,WAAmD,CAAC;IAErE,OAAO;QACL,QAAQ;QACR,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA0B;IACtE,MAAM,OAAO,GAAG,SAAS,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,UAAU,WAAW,CAAC;IACtE,MAAM,QAAQ,GACZ,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QACxB,CAAC,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QAC9D,CAAC,CAAC,uBAAuB,CAAC;IAE9B,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,GAAG,OAAO,GAAG,QAAQ,kBAAkB,MAAM,CAAC,SAAS,EAAE;SAChE;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,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE;SAC1D;QACD;YACE,KAAK,EAAE,+BAA+B;YACtC,KAAK,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE;SACxD;KACF;IACD,KAAK,EAAE,iBAAiB;IACxB,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}
@@ -0,0 +1,47 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const ListReportSchedulesInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
4
+ export declare const ListReportSchedulesOutputSchema: z.ZodObject<{
5
+ note: z.ZodString;
6
+ timestamp: z.ZodString;
7
+ }, "strip", z.ZodTypeAny, {
8
+ note: string;
9
+ timestamp: string;
10
+ }, {
11
+ note: string;
12
+ timestamp: string;
13
+ }>;
14
+ type ListReportSchedulesInput = z.infer<typeof ListReportSchedulesInputSchema>;
15
+ type ListReportSchedulesOutput = z.infer<typeof ListReportSchedulesOutputSchema>;
16
+ export declare function listReportSchedulesLogic(_input: ListReportSchedulesInput, context: RequestContext, sdkContext?: SdkContext): Promise<ListReportSchedulesOutput>;
17
+ export declare function listReportSchedulesResponseFormatter(result: ListReportSchedulesOutput): McpTextContent[];
18
+ export declare const listReportSchedulesTool: {
19
+ name: string;
20
+ title: string;
21
+ description: string;
22
+ inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
23
+ outputSchema: z.ZodObject<{
24
+ note: z.ZodString;
25
+ timestamp: z.ZodString;
26
+ }, "strip", z.ZodTypeAny, {
27
+ note: string;
28
+ timestamp: string;
29
+ }, {
30
+ note: string;
31
+ timestamp: string;
32
+ }>;
33
+ annotations: {
34
+ readOnlyHint: boolean;
35
+ openWorldHint: boolean;
36
+ destructiveHint: boolean;
37
+ idempotentHint: boolean;
38
+ };
39
+ inputExamples: {
40
+ label: string;
41
+ input: {};
42
+ }[];
43
+ logic: typeof listReportSchedulesLogic;
44
+ responseFormatter: typeof listReportSchedulesResponseFormatter;
45
+ };
46
+ export {};
47
+ //# sourceMappingURL=list-report-schedules.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list-report-schedules.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-report-schedules.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;AAanF,eAAO,MAAM,8BAA8B,gDAAkD,CAAC;AAE9F,eAAO,MAAM,+BAA+B;;;;;;;;;EAKN,CAAC;AAEvC,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAC/E,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEjF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,wBAAwB,EAChC,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,yBAAyB,CAAC,CASpC;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,yBAAyB,GAChC,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoBnC,CAAC"}
@@ -0,0 +1,57 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ const TOOL_NAME = "msads_list_report_schedules";
4
+ const TOOL_TITLE = "List Microsoft Ads Report Schedules";
5
+ const TOOL_DESCRIPTION = `List scheduled reports in Microsoft Advertising.
6
+
7
+ Note: The Microsoft Advertising API v13 JSON endpoints do not provide an endpoint to programmatically list all scheduled reports. This tool returns guidance on how to find existing schedules.
8
+
9
+ If Microsoft Advertising exposed such an endpoint, this tool would return an array of canonical \`ReportScheduleSummary\` entries (the same cross-platform shape used by \`ttd_list_report_schedules\` and \`cm360_list_report_schedules\`), mapped via the shared \`fromMsAdsSchedule\` normalizer, with the raw Microsoft Advertising envelopes preserved on a sibling \`raw\` field for platform-specific debugging.
10
+
11
+ To view scheduled reports: visit app.ads.microsoft.com → Reports → Scheduled Reports.
12
+ To manage schedules programmatically, track the scheduleIds returned by msads_create_report_schedule.`;
13
+ export const ListReportSchedulesInputSchema = z.object({}).describe("No parameters required");
14
+ export const ListReportSchedulesOutputSchema = z
15
+ .object({
16
+ note: z.string().describe("Guidance on how to list schedules"),
17
+ timestamp: z.string().datetime(),
18
+ })
19
+ .describe("List schedules response");
20
+ export async function listReportSchedulesLogic(_input, context, sdkContext) {
21
+ const { msadsReportingService } = resolveSessionServices(sdkContext);
22
+ const result = await msadsReportingService.listReportSchedules(context);
23
+ return {
24
+ note: result.note,
25
+ timestamp: new Date().toISOString(),
26
+ };
27
+ }
28
+ export function listReportSchedulesResponseFormatter(result) {
29
+ return [
30
+ {
31
+ type: "text",
32
+ text: `${result.note}\n\nTimestamp: ${result.timestamp}`,
33
+ },
34
+ ];
35
+ }
36
+ export const listReportSchedulesTool = {
37
+ name: TOOL_NAME,
38
+ title: TOOL_TITLE,
39
+ description: TOOL_DESCRIPTION,
40
+ inputSchema: ListReportSchedulesInputSchema,
41
+ outputSchema: ListReportSchedulesOutputSchema,
42
+ annotations: {
43
+ readOnlyHint: true,
44
+ openWorldHint: false,
45
+ destructiveHint: false,
46
+ idempotentHint: true,
47
+ },
48
+ inputExamples: [
49
+ {
50
+ label: "List all report schedules",
51
+ input: {},
52
+ },
53
+ ],
54
+ logic: listReportSchedulesLogic,
55
+ responseFormatter: listReportSchedulesResponseFormatter,
56
+ };
57
+ //# sourceMappingURL=list-report-schedules.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list-report-schedules.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-report-schedules.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,MAAM,SAAS,GAAG,6BAA6B,CAAC;AAChD,MAAM,UAAU,GAAG,qCAAqC,CAAC;AACzD,MAAM,gBAAgB,GAAG;;;;;;;sGAO6E,CAAC;AAEvG,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AAE9F,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC;KAC7C,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAKvC,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAgC,EAChC,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,qBAAqB,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAExE,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,MAAiC;IAEjC,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACzD;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,8BAA8B;IAC3C,YAAY,EAAE,+BAA+B;IAC7C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;KACrB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,2BAA2B;YAClC,KAAK,EAAE,EAAE;SACV;KACF;IACD,KAAK,EAAE,wBAAwB;IAC/B,iBAAiB,EAAE,oCAAoC;CACxD,CAAC"}
@@ -0,0 +1,81 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
3
+ export declare const ManageAdExtensionsInputSchema: z.ZodObject<{
4
+ operation: z.ZodEnum<["setAssociations", "deleteAssociations", "getAssociations"]>;
5
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
6
+ }, "strip", z.ZodTypeAny, {
7
+ data: Record<string, unknown>;
8
+ operation: "setAssociations" | "deleteAssociations" | "getAssociations";
9
+ }, {
10
+ data: Record<string, unknown>;
11
+ operation: "setAssociations" | "deleteAssociations" | "getAssociations";
12
+ }>;
13
+ export declare const ManageAdExtensionsOutputSchema: 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 ManageAdExtensionsInput = z.infer<typeof ManageAdExtensionsInputSchema>;
27
+ type ManageAdExtensionsOutput = z.infer<typeof ManageAdExtensionsOutputSchema>;
28
+ export declare function manageAdExtensionsLogic(input: ManageAdExtensionsInput, context: RequestContext, sdkContext?: SdkContext): Promise<ManageAdExtensionsOutput>;
29
+ export declare function manageAdExtensionsResponseFormatter(result: ManageAdExtensionsOutput): McpTextContent[];
30
+ export declare const manageAdExtensionsTool: {
31
+ name: string;
32
+ title: string;
33
+ description: string;
34
+ inputSchema: z.ZodObject<{
35
+ operation: z.ZodEnum<["setAssociations", "deleteAssociations", "getAssociations"]>;
36
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
37
+ }, "strip", z.ZodTypeAny, {
38
+ data: Record<string, unknown>;
39
+ operation: "setAssociations" | "deleteAssociations" | "getAssociations";
40
+ }, {
41
+ data: Record<string, unknown>;
42
+ operation: "setAssociations" | "deleteAssociations" | "getAssociations";
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
+ AccountId: number;
69
+ AdExtensionIdToEntityIdAssociations: {
70
+ AdExtensionId: number;
71
+ EntityId: number;
72
+ }[];
73
+ AssociationType: string;
74
+ };
75
+ };
76
+ }[];
77
+ logic: typeof manageAdExtensionsLogic;
78
+ responseFormatter: typeof manageAdExtensionsResponseFormatter;
79
+ };
80
+ export {};
81
+ //# sourceMappingURL=manage-ad-extensions.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manage-ad-extensions.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/manage-ad-extensions.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;AAWnF,eAAO,MAAM,6BAA6B;;;;;;;;;EAOU,CAAC;AAErD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;EAME,CAAC;AAE9C,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAC7E,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAQ/E,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAuBnC;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,wBAAwB,GAC/B,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BlC,CAAC"}