@cesteral/pinterest-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 (263) hide show
  1. package/LICENSE.md +201 -0
  2. package/README.md +348 -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/pinterest-auth-adapter.d.ts +38 -0
  8. package/dist/auth/pinterest-auth-adapter.d.ts.map +1 -0
  9. package/dist/auth/pinterest-auth-adapter.js +117 -0
  10. package/dist/auth/pinterest-auth-adapter.js.map +1 -0
  11. package/dist/auth/pinterest-auth-strategy.d.ts +13 -0
  12. package/dist/auth/pinterest-auth-strategy.d.ts.map +1 -0
  13. package/dist/auth/pinterest-auth-strategy.js +52 -0
  14. package/dist/auth/pinterest-auth-strategy.js.map +1 -0
  15. package/dist/config/index.d.ts +120 -0
  16. package/dist/config/index.d.ts.map +1 -0
  17. package/dist/config/index.js +55 -0
  18. package/dist/config/index.js.map +1 -0
  19. package/dist/generated/types.d.ts +18119 -0
  20. package/dist/generated/types.d.ts.map +1 -0
  21. package/dist/generated/types.js +2 -0
  22. package/dist/generated/types.js.map +1 -0
  23. package/dist/index.d.ts +3 -0
  24. package/dist/index.d.ts.map +1 -0
  25. package/dist/index.js +47 -0
  26. package/dist/index.js.map +1 -0
  27. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
  28. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
  29. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +125 -0
  30. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
  31. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
  32. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
  33. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +105 -0
  34. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
  35. package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts +4 -0
  36. package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts.map +1 -0
  37. package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js +95 -0
  38. package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js.map +1 -0
  39. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts +4 -0
  40. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts.map +1 -0
  41. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js +301 -0
  42. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js.map +1 -0
  43. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts +4 -0
  44. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts.map +1 -0
  45. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js +170 -0
  46. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js.map +1 -0
  47. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts +4 -0
  48. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts.map +1 -0
  49. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js +198 -0
  50. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js.map +1 -0
  51. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts +4 -0
  52. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts.map +1 -0
  53. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js +188 -0
  54. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js.map +1 -0
  55. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +4 -0
  56. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -0
  57. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js +126 -0
  58. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js.map +1 -0
  59. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts +4 -0
  60. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts.map +1 -0
  61. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js +197 -0
  62. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js.map +1 -0
  63. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts +4 -0
  64. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts.map +1 -0
  65. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js +93 -0
  66. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js.map +1 -0
  67. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
  68. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
  69. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +111 -0
  70. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
  71. package/dist/mcp-server/prompts/index.d.ts +9 -0
  72. package/dist/mcp-server/prompts/index.d.ts.map +1 -0
  73. package/dist/mcp-server/prompts/index.js +97 -0
  74. package/dist/mcp-server/prompts/index.js.map +1 -0
  75. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
  76. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
  77. package/dist/mcp-server/resources/definitions/entity-examples.resource.js +180 -0
  78. package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
  79. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
  80. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
  81. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +140 -0
  82. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
  83. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
  84. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
  85. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +125 -0
  86. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
  87. package/dist/mcp-server/resources/definitions/index.d.ts +7 -0
  88. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  89. package/dist/mcp-server/resources/definitions/index.js +58 -0
  90. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  91. package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts +3 -0
  92. package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts.map +1 -0
  93. package/dist/mcp-server/resources/definitions/reporting-reference.resource.js +148 -0
  94. package/dist/mcp-server/resources/definitions/reporting-reference.resource.js.map +1 -0
  95. package/dist/mcp-server/resources/index.d.ts +3 -0
  96. package/dist/mcp-server/resources/index.d.ts.map +1 -0
  97. package/dist/mcp-server/resources/index.js +2 -0
  98. package/dist/mcp-server/resources/index.js.map +1 -0
  99. package/dist/mcp-server/resources/types.d.ts +8 -0
  100. package/dist/mcp-server/resources/types.d.ts.map +1 -0
  101. package/dist/mcp-server/resources/types.js +2 -0
  102. package/dist/mcp-server/resources/types.js.map +1 -0
  103. package/dist/mcp-server/server.d.ts +5 -0
  104. package/dist/mcp-server/server.d.ts.map +1 -0
  105. package/dist/mcp-server/server.js +133 -0
  106. package/dist/mcp-server/server.js.map +1 -0
  107. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +209 -0
  108. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
  109. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +141 -0
  110. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
  111. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +151 -0
  112. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
  113. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +109 -0
  114. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
  115. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +193 -0
  116. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
  117. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +127 -0
  118. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
  119. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +153 -0
  120. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
  121. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +134 -0
  122. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
  123. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +119 -0
  124. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
  125. package/dist/mcp-server/tools/definitions/check-report-status.tool.js +91 -0
  126. package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
  127. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +113 -0
  128. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
  129. package/dist/mcp-server/tools/definitions/create-entity.tool.js +99 -0
  130. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
  131. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +100 -0
  132. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
  133. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +110 -0
  134. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
  135. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +297 -0
  136. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
  137. package/dist/mcp-server/tools/definitions/download-report.tool.js +110 -0
  138. package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
  139. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +105 -0
  140. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
  141. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +85 -0
  142. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
  143. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +89 -0
  144. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
  145. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +74 -0
  146. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
  147. package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.d.ts +85 -0
  148. package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.d.ts.map +1 -0
  149. package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.js +88 -0
  150. package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.js.map +1 -0
  151. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +76 -0
  152. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
  153. package/dist/mcp-server/tools/definitions/get-entity.tool.js +71 -0
  154. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
  155. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +319 -0
  156. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -0
  157. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +183 -0
  158. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -0
  159. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +301 -0
  160. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -0
  161. package/dist/mcp-server/tools/definitions/get-report.tool.js +176 -0
  162. package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -0
  163. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +75 -0
  164. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
  165. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +72 -0
  166. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
  167. package/dist/mcp-server/tools/definitions/index.d.ts +25 -0
  168. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  169. package/dist/mcp-server/tools/definitions/index.js +75 -0
  170. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  171. package/dist/mcp-server/tools/definitions/list-advertisers.tool.d.ts +54 -0
  172. package/dist/mcp-server/tools/definitions/list-advertisers.tool.d.ts.map +1 -0
  173. package/dist/mcp-server/tools/definitions/list-advertisers.tool.js +58 -0
  174. package/dist/mcp-server/tools/definitions/list-advertisers.tool.js.map +1 -0
  175. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +180 -0
  176. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
  177. package/dist/mcp-server/tools/definitions/list-entities.tool.js +116 -0
  178. package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
  179. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +103 -0
  180. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -0
  181. package/dist/mcp-server/tools/definitions/search-targeting.tool.js +98 -0
  182. package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
  183. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +164 -0
  184. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
  185. package/dist/mcp-server/tools/definitions/submit-report.tool.js +118 -0
  186. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
  187. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +111 -0
  188. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
  189. package/dist/mcp-server/tools/definitions/update-entity.tool.js +89 -0
  190. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
  191. package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts +81 -0
  192. package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts.map +1 -0
  193. package/dist/mcp-server/tools/definitions/upload-image.tool.js +73 -0
  194. package/dist/mcp-server/tools/definitions/upload-image.tool.js.map +1 -0
  195. package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts +82 -0
  196. package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts.map +1 -0
  197. package/dist/mcp-server/tools/definitions/upload-video.tool.js +100 -0
  198. package/dist/mcp-server/tools/definitions/upload-video.tool.js.map +1 -0
  199. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +169 -0
  200. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
  201. package/dist/mcp-server/tools/definitions/validate-entity.tool.js +154 -0
  202. package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
  203. package/dist/mcp-server/tools/index.d.ts +2 -0
  204. package/dist/mcp-server/tools/index.d.ts.map +1 -0
  205. package/dist/mcp-server/tools/index.js +2 -0
  206. package/dist/mcp-server/tools/index.js.map +1 -0
  207. package/dist/mcp-server/tools/utils/entity-mapping.d.ts +22 -0
  208. package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
  209. package/dist/mcp-server/tools/utils/entity-mapping.js +105 -0
  210. package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
  211. package/dist/mcp-server/tools/utils/media-types.d.ts +14 -0
  212. package/dist/mcp-server/tools/utils/media-types.d.ts.map +1 -0
  213. package/dist/mcp-server/tools/utils/media-types.js +2 -0
  214. package/dist/mcp-server/tools/utils/media-types.js.map +1 -0
  215. package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
  216. package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
  217. package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
  218. package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
  219. package/dist/mcp-server/transports/streamable-http-transport.d.ts +59 -0
  220. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
  221. package/dist/mcp-server/transports/streamable-http-transport.js +107 -0
  222. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
  223. package/dist/services/pinterest/pinterest-http-client.d.ts +22 -0
  224. package/dist/services/pinterest/pinterest-http-client.d.ts.map +1 -0
  225. package/dist/services/pinterest/pinterest-http-client.js +149 -0
  226. package/dist/services/pinterest/pinterest-http-client.js.map +1 -0
  227. package/dist/services/pinterest/pinterest-reporting-service.d.ts +60 -0
  228. package/dist/services/pinterest/pinterest-reporting-service.d.ts.map +1 -0
  229. package/dist/services/pinterest/pinterest-reporting-service.js +132 -0
  230. package/dist/services/pinterest/pinterest-reporting-service.js.map +1 -0
  231. package/dist/services/pinterest/pinterest-service.d.ts +110 -0
  232. package/dist/services/pinterest/pinterest-service.d.ts.map +1 -0
  233. package/dist/services/pinterest/pinterest-service.js +238 -0
  234. package/dist/services/pinterest/pinterest-service.js.map +1 -0
  235. package/dist/services/session-services.d.ts +21 -0
  236. package/dist/services/session-services.d.ts.map +1 -0
  237. package/dist/services/session-services.js +23 -0
  238. package/dist/services/session-services.js.map +1 -0
  239. package/dist/types-global/mcp.d.ts +2 -0
  240. package/dist/types-global/mcp.d.ts.map +1 -0
  241. package/dist/types-global/mcp.js +2 -0
  242. package/dist/types-global/mcp.js.map +1 -0
  243. package/dist/utils/errors/index.d.ts +2 -0
  244. package/dist/utils/errors/index.d.ts.map +1 -0
  245. package/dist/utils/errors/index.js +2 -0
  246. package/dist/utils/errors/index.js.map +1 -0
  247. package/dist/utils/platform.d.ts +3 -0
  248. package/dist/utils/platform.d.ts.map +1 -0
  249. package/dist/utils/platform.js +5 -0
  250. package/dist/utils/platform.js.map +1 -0
  251. package/dist/utils/security/rate-limiter.d.ts +3 -0
  252. package/dist/utils/security/rate-limiter.d.ts.map +1 -0
  253. package/dist/utils/security/rate-limiter.js +5 -0
  254. package/dist/utils/security/rate-limiter.js.map +1 -0
  255. package/dist/utils/telemetry/index.d.ts +2 -0
  256. package/dist/utils/telemetry/index.d.ts.map +1 -0
  257. package/dist/utils/telemetry/index.js +2 -0
  258. package/dist/utils/telemetry/index.js.map +1 -0
  259. package/dist/utils/telemetry/tracing.d.ts +3 -0
  260. package/dist/utils/telemetry/tracing.d.ts.map +1 -0
  261. package/dist/utils/telemetry/tracing.js +4 -0
  262. package/dist/utils/telemetry/tracing.js.map +1 -0
  263. package/package.json +57 -0
@@ -0,0 +1,301 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent } from "@cesteral/shared";
3
+ import type { SdkContext } from "@cesteral/shared";
4
+ export declare const GetReportInputSchema: z.ZodEffects<z.ZodObject<{
5
+ adAccountId: z.ZodString;
6
+ type: z.ZodDefault<z.ZodOptional<z.ZodEnum<["CAMPAIGN", "AD_GROUP", "AD", "KEYWORD", "ACCOUNT"]>>>;
7
+ columns: z.ZodArray<z.ZodString, "many">;
8
+ datePreset: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
9
+ startDate: z.ZodOptional<z.ZodString>;
10
+ endDate: z.ZodOptional<z.ZodString>;
11
+ granularity: z.ZodDefault<z.ZodOptional<z.ZodEnum<["TOTAL", "DAY", "HOUR", "WEEK", "MONTH"]>>>;
12
+ campaignIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
13
+ adGroupIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
14
+ adIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
15
+ includeComputedMetrics: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
16
+ } & Omit<{
17
+ mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
18
+ columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
19
+ offset: z.ZodOptional<z.ZodNumber>;
20
+ maxRows: z.ZodOptional<z.ZodNumber>;
21
+ aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
22
+ aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
23
+ }, "columns">, "strip", z.ZodTypeAny, {
24
+ type: "AD_GROUP" | "KEYWORD" | "CAMPAIGN" | "AD" | "ACCOUNT";
25
+ adAccountId: string;
26
+ granularity: "DAY" | "TOTAL" | "HOUR" | "WEEK" | "MONTH";
27
+ columns: string[];
28
+ includeComputedMetrics: boolean;
29
+ mode: "rows" | "summary";
30
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
31
+ startDate?: string | undefined;
32
+ endDate?: string | undefined;
33
+ campaignIds?: string[] | undefined;
34
+ adGroupIds?: string[] | undefined;
35
+ adIds?: string[] | undefined;
36
+ offset?: number | undefined;
37
+ maxRows?: number | undefined;
38
+ aggregateBy?: string[] | undefined;
39
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
40
+ }, {
41
+ adAccountId: string;
42
+ columns: string[];
43
+ type?: "AD_GROUP" | "KEYWORD" | "CAMPAIGN" | "AD" | "ACCOUNT" | undefined;
44
+ granularity?: "DAY" | "TOTAL" | "HOUR" | "WEEK" | "MONTH" | undefined;
45
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
46
+ startDate?: string | undefined;
47
+ endDate?: string | undefined;
48
+ campaignIds?: string[] | undefined;
49
+ adGroupIds?: string[] | undefined;
50
+ adIds?: string[] | undefined;
51
+ includeComputedMetrics?: boolean | undefined;
52
+ mode?: "rows" | "summary" | 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
+ type: "AD_GROUP" | "KEYWORD" | "CAMPAIGN" | "AD" | "ACCOUNT";
59
+ adAccountId: string;
60
+ granularity: "DAY" | "TOTAL" | "HOUR" | "WEEK" | "MONTH";
61
+ columns: string[];
62
+ includeComputedMetrics: boolean;
63
+ mode: "rows" | "summary";
64
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
65
+ startDate?: string | undefined;
66
+ endDate?: string | undefined;
67
+ campaignIds?: string[] | undefined;
68
+ adGroupIds?: string[] | undefined;
69
+ adIds?: string[] | undefined;
70
+ offset?: number | undefined;
71
+ maxRows?: number | undefined;
72
+ aggregateBy?: string[] | undefined;
73
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
74
+ }, {
75
+ adAccountId: string;
76
+ columns: string[];
77
+ type?: "AD_GROUP" | "KEYWORD" | "CAMPAIGN" | "AD" | "ACCOUNT" | undefined;
78
+ granularity?: "DAY" | "TOTAL" | "HOUR" | "WEEK" | "MONTH" | undefined;
79
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
80
+ startDate?: string | undefined;
81
+ endDate?: string | undefined;
82
+ campaignIds?: string[] | undefined;
83
+ adGroupIds?: string[] | undefined;
84
+ adIds?: string[] | undefined;
85
+ includeComputedMetrics?: boolean | undefined;
86
+ mode?: "rows" | "summary" | undefined;
87
+ offset?: number | undefined;
88
+ maxRows?: number | undefined;
89
+ aggregateBy?: string[] | undefined;
90
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
91
+ }>;
92
+ export declare const GetReportOutputSchema: z.ZodObject<{
93
+ timestamp: z.ZodString;
94
+ totalRows: z.ZodNumber;
95
+ returnedRows: z.ZodNumber;
96
+ truncated: z.ZodBoolean;
97
+ nextOffset: z.ZodNullable<z.ZodNumber>;
98
+ headers: z.ZodArray<z.ZodString, "many">;
99
+ selectedColumns: z.ZodArray<z.ZodString, "many">;
100
+ mode: z.ZodEnum<["summary", "rows"]>;
101
+ previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
102
+ rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
103
+ warnings: z.ZodArray<z.ZodString, "many">;
104
+ taskId: z.ZodString;
105
+ }, "strip", z.ZodTypeAny, {
106
+ taskId: string;
107
+ totalRows: number;
108
+ headers: string[];
109
+ timestamp: string;
110
+ mode: "rows" | "summary";
111
+ returnedRows: number;
112
+ truncated: boolean;
113
+ nextOffset: number | null;
114
+ selectedColumns: string[];
115
+ warnings: string[];
116
+ rows?: Record<string, any>[] | undefined;
117
+ previewRows?: Record<string, any>[] | undefined;
118
+ }, {
119
+ taskId: string;
120
+ totalRows: number;
121
+ headers: string[];
122
+ timestamp: string;
123
+ mode: "rows" | "summary";
124
+ returnedRows: number;
125
+ truncated: boolean;
126
+ nextOffset: number | null;
127
+ selectedColumns: string[];
128
+ warnings: string[];
129
+ rows?: Record<string, any>[] | undefined;
130
+ previewRows?: Record<string, any>[] | undefined;
131
+ }>;
132
+ type GetReportInput = z.infer<typeof GetReportInputSchema>;
133
+ type GetReportOutput = z.infer<typeof GetReportOutputSchema>;
134
+ export declare function getReportLogic(input: GetReportInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetReportOutput>;
135
+ export declare function getReportResponseFormatter(result: GetReportOutput): McpTextContent[];
136
+ export declare const getReportTool: {
137
+ name: string;
138
+ title: string;
139
+ description: string;
140
+ inputSchema: z.ZodEffects<z.ZodObject<{
141
+ adAccountId: z.ZodString;
142
+ type: z.ZodDefault<z.ZodOptional<z.ZodEnum<["CAMPAIGN", "AD_GROUP", "AD", "KEYWORD", "ACCOUNT"]>>>;
143
+ columns: z.ZodArray<z.ZodString, "many">;
144
+ datePreset: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
145
+ startDate: z.ZodOptional<z.ZodString>;
146
+ endDate: z.ZodOptional<z.ZodString>;
147
+ granularity: z.ZodDefault<z.ZodOptional<z.ZodEnum<["TOTAL", "DAY", "HOUR", "WEEK", "MONTH"]>>>;
148
+ campaignIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
149
+ adGroupIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
150
+ adIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
151
+ includeComputedMetrics: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
152
+ } & Omit<{
153
+ mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
154
+ columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
155
+ offset: z.ZodOptional<z.ZodNumber>;
156
+ maxRows: z.ZodOptional<z.ZodNumber>;
157
+ aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
158
+ aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
159
+ }, "columns">, "strip", z.ZodTypeAny, {
160
+ type: "AD_GROUP" | "KEYWORD" | "CAMPAIGN" | "AD" | "ACCOUNT";
161
+ adAccountId: string;
162
+ granularity: "DAY" | "TOTAL" | "HOUR" | "WEEK" | "MONTH";
163
+ columns: string[];
164
+ includeComputedMetrics: boolean;
165
+ mode: "rows" | "summary";
166
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
167
+ startDate?: string | undefined;
168
+ endDate?: string | undefined;
169
+ campaignIds?: string[] | undefined;
170
+ adGroupIds?: string[] | undefined;
171
+ adIds?: string[] | undefined;
172
+ offset?: number | undefined;
173
+ maxRows?: number | undefined;
174
+ aggregateBy?: string[] | undefined;
175
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
176
+ }, {
177
+ adAccountId: string;
178
+ columns: string[];
179
+ type?: "AD_GROUP" | "KEYWORD" | "CAMPAIGN" | "AD" | "ACCOUNT" | undefined;
180
+ granularity?: "DAY" | "TOTAL" | "HOUR" | "WEEK" | "MONTH" | undefined;
181
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
182
+ startDate?: string | undefined;
183
+ endDate?: string | undefined;
184
+ campaignIds?: string[] | undefined;
185
+ adGroupIds?: string[] | undefined;
186
+ adIds?: string[] | undefined;
187
+ includeComputedMetrics?: boolean | undefined;
188
+ mode?: "rows" | "summary" | undefined;
189
+ offset?: number | undefined;
190
+ maxRows?: number | undefined;
191
+ aggregateBy?: string[] | undefined;
192
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
193
+ }>, {
194
+ type: "AD_GROUP" | "KEYWORD" | "CAMPAIGN" | "AD" | "ACCOUNT";
195
+ adAccountId: string;
196
+ granularity: "DAY" | "TOTAL" | "HOUR" | "WEEK" | "MONTH";
197
+ columns: string[];
198
+ includeComputedMetrics: boolean;
199
+ mode: "rows" | "summary";
200
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
201
+ startDate?: string | undefined;
202
+ endDate?: string | undefined;
203
+ campaignIds?: string[] | undefined;
204
+ adGroupIds?: string[] | undefined;
205
+ adIds?: string[] | undefined;
206
+ offset?: number | undefined;
207
+ maxRows?: number | undefined;
208
+ aggregateBy?: string[] | undefined;
209
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
210
+ }, {
211
+ adAccountId: string;
212
+ columns: string[];
213
+ type?: "AD_GROUP" | "KEYWORD" | "CAMPAIGN" | "AD" | "ACCOUNT" | undefined;
214
+ granularity?: "DAY" | "TOTAL" | "HOUR" | "WEEK" | "MONTH" | undefined;
215
+ datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
216
+ startDate?: string | undefined;
217
+ endDate?: string | undefined;
218
+ campaignIds?: string[] | undefined;
219
+ adGroupIds?: string[] | undefined;
220
+ adIds?: string[] | undefined;
221
+ includeComputedMetrics?: boolean | undefined;
222
+ mode?: "rows" | "summary" | undefined;
223
+ offset?: number | undefined;
224
+ maxRows?: number | undefined;
225
+ aggregateBy?: string[] | undefined;
226
+ aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
227
+ }>;
228
+ outputSchema: z.ZodObject<{
229
+ timestamp: z.ZodString;
230
+ totalRows: z.ZodNumber;
231
+ returnedRows: z.ZodNumber;
232
+ truncated: z.ZodBoolean;
233
+ nextOffset: z.ZodNullable<z.ZodNumber>;
234
+ headers: z.ZodArray<z.ZodString, "many">;
235
+ selectedColumns: z.ZodArray<z.ZodString, "many">;
236
+ mode: z.ZodEnum<["summary", "rows"]>;
237
+ previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
238
+ rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
239
+ warnings: z.ZodArray<z.ZodString, "many">;
240
+ taskId: z.ZodString;
241
+ }, "strip", z.ZodTypeAny, {
242
+ taskId: string;
243
+ totalRows: number;
244
+ headers: string[];
245
+ timestamp: string;
246
+ mode: "rows" | "summary";
247
+ returnedRows: number;
248
+ truncated: boolean;
249
+ nextOffset: number | null;
250
+ selectedColumns: string[];
251
+ warnings: string[];
252
+ rows?: Record<string, any>[] | undefined;
253
+ previewRows?: Record<string, any>[] | undefined;
254
+ }, {
255
+ taskId: string;
256
+ totalRows: number;
257
+ headers: string[];
258
+ timestamp: string;
259
+ mode: "rows" | "summary";
260
+ returnedRows: number;
261
+ truncated: boolean;
262
+ nextOffset: number | null;
263
+ selectedColumns: string[];
264
+ warnings: string[];
265
+ rows?: Record<string, any>[] | undefined;
266
+ previewRows?: Record<string, any>[] | undefined;
267
+ }>;
268
+ annotations: {
269
+ readOnlyHint: boolean;
270
+ openWorldHint: boolean;
271
+ idempotentHint: boolean;
272
+ destructiveHint: boolean;
273
+ };
274
+ inputExamples: ({
275
+ label: string;
276
+ input: {
277
+ adAccountId: string;
278
+ type: string;
279
+ columns: string[];
280
+ datePreset: string;
281
+ granularity: string;
282
+ startDate?: undefined;
283
+ endDate?: undefined;
284
+ };
285
+ } | {
286
+ label: string;
287
+ input: {
288
+ adAccountId: string;
289
+ type: string;
290
+ columns: string[];
291
+ startDate: string;
292
+ endDate: string;
293
+ granularity: string;
294
+ datePreset?: undefined;
295
+ };
296
+ })[];
297
+ logic: typeof getReportLogic;
298
+ responseFormatter: typeof getReportResponseFormatter;
299
+ };
300
+ export {};
301
+ //# 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;AAaxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAanD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgD8B,CAAC;AAEhE,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,CA2C1B;AAsCD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,EAAE,CAOpF;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCzB,CAAC"}
@@ -0,0 +1,176 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ import { arrayRowsToRecords, computeMetrics, createReportView, formatReportViewResponse, getReportViewFetchLimit, resolveDatePreset, DATE_PRESET_VALUES, ReportViewInputSchema, ReportViewOutputSchema, } from "@cesteral/shared";
4
+ const TOOL_NAME = "pinterest_get_report";
5
+ const TOOL_TITLE = "Get Pinterest Ads Report";
6
+ const TOOL_DESCRIPTION = `Submit and retrieve an async Pinterest Ads performance report.
7
+
8
+ Follows the async polling pattern: submit task → poll until FINISHED → download CSV.
9
+ This may take 30s–5 minutes depending on the data volume.
10
+
11
+ **Common columns:** IMPRESSION_1, CLICKTHROUGH_1, SPEND_IN_DOLLAR, CTR, CPM, CPC, TOTAL_CONVERSIONS, REACH
12
+ **Report types:** CAMPAIGN (default), AD_GROUP, AD, KEYWORD, ACCOUNT
13
+ **Granularity:** DAY (default), TOTAL, HOUR, WEEK, MONTH`;
14
+ export const GetReportInputSchema = z
15
+ .object({
16
+ adAccountId: z.string().min(1).describe("Pinterest Ad Account ID"),
17
+ type: z
18
+ .enum(["CAMPAIGN", "AD_GROUP", "AD", "KEYWORD", "ACCOUNT"])
19
+ .optional()
20
+ .default("CAMPAIGN")
21
+ .describe("Report type (default: CAMPAIGN)"),
22
+ columns: z
23
+ .array(z.string())
24
+ .min(1)
25
+ .describe("Columns/metrics to include (e.g. ['IMPRESSION_1', 'CLICKTHROUGH_1', 'SPEND_IN_DOLLAR'])"),
26
+ datePreset: z
27
+ .enum(DATE_PRESET_VALUES)
28
+ .optional()
29
+ .describe("Preset date range. Use this OR startDate+endDate (not both)"),
30
+ startDate: z
31
+ .string()
32
+ .regex(/^\d{4}-\d{2}-\d{2}$/)
33
+ .optional()
34
+ .describe("Start date (YYYY-MM-DD, required if datePreset not provided)"),
35
+ endDate: z
36
+ .string()
37
+ .regex(/^\d{4}-\d{2}-\d{2}$/)
38
+ .optional()
39
+ .describe("End date (YYYY-MM-DD, required if datePreset not provided)"),
40
+ granularity: z
41
+ .enum(["TOTAL", "DAY", "HOUR", "WEEK", "MONTH"])
42
+ .optional()
43
+ .default("DAY")
44
+ .describe("Time granularity for the report (default: DAY)"),
45
+ campaignIds: z.array(z.string()).optional().describe("Filter by campaign IDs"),
46
+ adGroupIds: z.array(z.string()).optional().describe("Filter by ad group IDs"),
47
+ adIds: z.array(z.string()).optional().describe("Filter by ad IDs"),
48
+ includeComputedMetrics: z
49
+ .boolean()
50
+ .optional()
51
+ .default(false)
52
+ .describe("Include computed CPA, ROAS, CPM, CTR, CPC"),
53
+ })
54
+ .merge(ReportViewInputSchema.omit({ columns: true }))
55
+ .refine((data) => data.datePreset !== undefined || (data.startDate !== undefined && data.endDate !== undefined), { message: "Provide either datePreset or both startDate and endDate" })
56
+ .describe("Parameters for generating a Pinterest Ads report");
57
+ export const GetReportOutputSchema = z
58
+ .object({
59
+ taskId: z.string().describe("Report token/task ID"),
60
+ ...ReportViewOutputSchema.shape,
61
+ timestamp: z.string().datetime(),
62
+ })
63
+ .describe("Report result");
64
+ export async function getReportLogic(input, context, sdkContext) {
65
+ const { pinterestReportingService } = resolveSessionServices(sdkContext);
66
+ let resolvedStartDate = input.startDate;
67
+ let resolvedEndDate = input.endDate;
68
+ if (input.datePreset) {
69
+ const resolved = resolveDatePreset(input.datePreset);
70
+ resolvedStartDate = resolved.startDate;
71
+ resolvedEndDate = resolved.endDate;
72
+ }
73
+ const result = await pinterestReportingService.getReport({
74
+ type: input.type,
75
+ columns: input.columns,
76
+ start_date: resolvedStartDate,
77
+ end_date: resolvedEndDate,
78
+ granularity: input.granularity,
79
+ ...(input.campaignIds ? { campaign_ids: input.campaignIds } : {}),
80
+ ...(input.adGroupIds ? { ad_group_ids: input.adGroupIds } : {}),
81
+ ...(input.adIds ? { ad_ids: input.adIds } : {}),
82
+ }, getReportViewFetchLimit(input), context);
83
+ let headers = result.headers;
84
+ let rows = result.rows;
85
+ if (input.includeComputedMetrics) {
86
+ ({ headers, rows } = appendComputedMetricsToRows(headers, rows));
87
+ }
88
+ return {
89
+ taskId: result.taskId,
90
+ ...createReportView({
91
+ headers,
92
+ rows: arrayRowsToRecords(headers, rows),
93
+ totalRows: result.totalRows,
94
+ input,
95
+ }),
96
+ timestamp: new Date().toISOString(),
97
+ };
98
+ }
99
+ function appendComputedMetricsToRows(headers, rows) {
100
+ const idx = (name) => headers.findIndex((h) => h.toUpperCase() === name.toUpperCase());
101
+ const spendIdx = idx("SPEND_IN_DOLLAR");
102
+ const impIdx = idx("IMPRESSION_1");
103
+ const clickIdx = idx("CLICKTHROUGH_1");
104
+ const convIdx = idx("TOTAL_CONVERSIONS");
105
+ const newHeaders = [
106
+ ...headers,
107
+ "computed_cpa",
108
+ "computed_roas",
109
+ "computed_cpm",
110
+ "computed_ctr",
111
+ "computed_cpc",
112
+ ];
113
+ const newRows = rows.map((row) => {
114
+ const cost = spendIdx >= 0 ? Number(row[spendIdx] || 0) : 0;
115
+ const impressions = impIdx >= 0 ? Number(row[impIdx] || 0) : 0;
116
+ const clicks = clickIdx >= 0 ? Number(row[clickIdx] || 0) : 0;
117
+ const conversions = convIdx >= 0 ? Number(row[convIdx] || 0) : 0;
118
+ const m = computeMetrics({ cost, impressions, clicks, conversions, conversionValue: 0 });
119
+ return [
120
+ ...row,
121
+ m.cpa !== null ? String(m.cpa) : "",
122
+ m.roas !== null ? String(m.roas) : "",
123
+ m.cpm !== null ? String(m.cpm) : "",
124
+ m.ctr !== null ? String(m.ctr) : "",
125
+ m.cpc !== null ? String(m.cpc) : "",
126
+ ];
127
+ });
128
+ return { headers: newHeaders, rows: newRows };
129
+ }
130
+ export function getReportResponseFormatter(result) {
131
+ return [
132
+ {
133
+ type: "text",
134
+ text: `Report task: ${result.taskId}\n\n${formatReportViewResponse(result, "Report data")}`,
135
+ },
136
+ ];
137
+ }
138
+ export const getReportTool = {
139
+ name: TOOL_NAME,
140
+ title: TOOL_TITLE,
141
+ description: TOOL_DESCRIPTION,
142
+ inputSchema: GetReportInputSchema,
143
+ outputSchema: GetReportOutputSchema,
144
+ annotations: {
145
+ readOnlyHint: true,
146
+ openWorldHint: false,
147
+ idempotentHint: false,
148
+ destructiveHint: false,
149
+ },
150
+ inputExamples: [
151
+ {
152
+ label: "Campaign delivery report for last 7 days",
153
+ input: {
154
+ adAccountId: "1234567890",
155
+ type: "CAMPAIGN",
156
+ columns: ["IMPRESSION_1", "CLICKTHROUGH_1", "SPEND_IN_DOLLAR", "CTR", "CPM"],
157
+ datePreset: "LAST_7_DAYS",
158
+ granularity: "DAY",
159
+ },
160
+ },
161
+ {
162
+ label: "Ad group performance report",
163
+ input: {
164
+ adAccountId: "1234567890",
165
+ type: "AD_GROUP",
166
+ columns: ["IMPRESSION_1", "CLICKTHROUGH_1", "SPEND_IN_DOLLAR", "TOTAL_CONVERSIONS"],
167
+ startDate: "2026-03-01",
168
+ endDate: "2026-03-04",
169
+ granularity: "TOTAL",
170
+ },
171
+ },
172
+ ],
173
+ logic: getReportLogic,
174
+ responseFormatter: getReportResponseFormatter,
175
+ };
176
+ //# 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,75 @@
1
+ import { z } from "zod";
2
+ import type { RequestContext, McpTextContent } from "@cesteral/shared";
3
+ import type { SdkContext } from "@cesteral/shared";
4
+ export declare const GetTargetingOptionsInputSchema: z.ZodObject<{
5
+ adAccountId: z.ZodString;
6
+ targetingType: z.ZodOptional<z.ZodString>;
7
+ }, "strip", z.ZodTypeAny, {
8
+ adAccountId: string;
9
+ targetingType?: string | undefined;
10
+ }, {
11
+ adAccountId: string;
12
+ targetingType?: string | undefined;
13
+ }>;
14
+ export declare const GetTargetingOptionsOutputSchema: z.ZodObject<{
15
+ options: z.ZodRecord<z.ZodString, z.ZodAny>;
16
+ timestamp: z.ZodString;
17
+ }, "strip", z.ZodTypeAny, {
18
+ options: Record<string, any>;
19
+ timestamp: string;
20
+ }, {
21
+ options: Record<string, any>;
22
+ timestamp: string;
23
+ }>;
24
+ type GetTargetingOptionsInput = z.infer<typeof GetTargetingOptionsInputSchema>;
25
+ type GetTargetingOptionsOutput = z.infer<typeof GetTargetingOptionsOutputSchema>;
26
+ export declare function getTargetingOptionsLogic(input: GetTargetingOptionsInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetTargetingOptionsOutput>;
27
+ export declare function getTargetingOptionsResponseFormatter(result: GetTargetingOptionsOutput): McpTextContent[];
28
+ export declare const getTargetingOptionsTool: {
29
+ name: string;
30
+ title: string;
31
+ description: string;
32
+ inputSchema: z.ZodObject<{
33
+ adAccountId: z.ZodString;
34
+ targetingType: z.ZodOptional<z.ZodString>;
35
+ }, "strip", z.ZodTypeAny, {
36
+ adAccountId: string;
37
+ targetingType?: string | undefined;
38
+ }, {
39
+ adAccountId: string;
40
+ targetingType?: string | undefined;
41
+ }>;
42
+ outputSchema: z.ZodObject<{
43
+ options: z.ZodRecord<z.ZodString, z.ZodAny>;
44
+ timestamp: z.ZodString;
45
+ }, "strip", z.ZodTypeAny, {
46
+ options: Record<string, any>;
47
+ timestamp: string;
48
+ }, {
49
+ options: Record<string, any>;
50
+ timestamp: string;
51
+ }>;
52
+ annotations: {
53
+ readOnlyHint: boolean;
54
+ openWorldHint: boolean;
55
+ idempotentHint: boolean;
56
+ destructiveHint: boolean;
57
+ };
58
+ inputExamples: ({
59
+ label: string;
60
+ input: {
61
+ adAccountId: string;
62
+ targetingType?: undefined;
63
+ };
64
+ } | {
65
+ label: string;
66
+ input: {
67
+ adAccountId: string;
68
+ targetingType: string;
69
+ };
70
+ })[];
71
+ logic: typeof getTargetingOptionsLogic;
72
+ responseFormatter: typeof getTargetingOptionsResponseFormatter;
73
+ };
74
+ export {};
75
+ //# sourceMappingURL=get-targeting-options.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-targeting-options.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-targeting-options.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAWnD,eAAO,MAAM,8BAA8B;;;;;;;;;EAUuB,CAAC;AAEnE,eAAO,MAAM,+BAA+B;;;;;;;;;EAKL,CAAC;AAExC,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,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,yBAAyB,CAAC,CAYpC;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,yBAAyB,GAChC,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BnC,CAAC"}
@@ -0,0 +1,72 @@
1
+ import { z } from "zod";
2
+ import { resolveSessionServices } from "../utils/resolve-session.js";
3
+ const TOOL_NAME = "pinterest_get_targeting_options";
4
+ const TOOL_TITLE = "Get Pinterest Targeting Options";
5
+ const TOOL_DESCRIPTION = `Browse available Pinterest ad targeting options and categories.
6
+
7
+ Returns a structured list of targeting options available for a given objective type.
8
+ Use this to discover valid targeting values before creating or updating ad groups.
9
+
10
+ **Common objective types:** TRAFFIC, APP_INSTALLS, CONVERSIONS, AWARENESS, VIDEO_VIEWS`;
11
+ export const GetTargetingOptionsInputSchema = z
12
+ .object({
13
+ adAccountId: z.string().min(1).describe("Pinterest Advertiser ID"),
14
+ targetingType: z
15
+ .string()
16
+ .optional()
17
+ .describe("Optional objective type to filter targeting options (e.g., TRAFFIC, APP_INSTALLS)"),
18
+ })
19
+ .describe("Parameters for browsing Pinterest targeting options");
20
+ export const GetTargetingOptionsOutputSchema = z
21
+ .object({
22
+ options: z.record(z.any()).describe("Available targeting options"),
23
+ timestamp: z.string().datetime(),
24
+ })
25
+ .describe("Targeting options result");
26
+ export async function getTargetingOptionsLogic(input, context, sdkContext) {
27
+ const { pinterestService } = resolveSessionServices(sdkContext);
28
+ const options = (await pinterestService.getTargetingOptions(input.targetingType, context));
29
+ return {
30
+ options,
31
+ timestamp: new Date().toISOString(),
32
+ };
33
+ }
34
+ export function getTargetingOptionsResponseFormatter(result) {
35
+ return [
36
+ {
37
+ type: "text",
38
+ text: `Pinterest targeting options:\n${JSON.stringify(result.options, null, 2)}\n\nTimestamp: ${result.timestamp}`,
39
+ },
40
+ ];
41
+ }
42
+ export const getTargetingOptionsTool = {
43
+ name: TOOL_NAME,
44
+ title: TOOL_TITLE,
45
+ description: TOOL_DESCRIPTION,
46
+ inputSchema: GetTargetingOptionsInputSchema,
47
+ outputSchema: GetTargetingOptionsOutputSchema,
48
+ annotations: {
49
+ readOnlyHint: true,
50
+ openWorldHint: false,
51
+ idempotentHint: true,
52
+ destructiveHint: false,
53
+ },
54
+ inputExamples: [
55
+ {
56
+ label: "Get all targeting options",
57
+ input: {
58
+ adAccountId: "1234567890",
59
+ },
60
+ },
61
+ {
62
+ label: "Get targeting options for traffic objective",
63
+ input: {
64
+ adAccountId: "1234567890",
65
+ targetingType: "TRAFFIC",
66
+ },
67
+ },
68
+ ],
69
+ logic: getTargetingOptionsLogic,
70
+ responseFormatter: getTargetingOptionsResponseFormatter,
71
+ };
72
+ //# sourceMappingURL=get-targeting-options.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-targeting-options.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-targeting-options.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,MAAM,SAAS,GAAG,iCAAiC,CAAC;AACpD,MAAM,UAAU,GAAG,iCAAiC,CAAC;AACrD,MAAM,gBAAgB,GAAG;;;;;uFAK8D,CAAC;AAExF,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC;KAC5C,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAClE,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mFAAmF,CACpF;CACJ,CAAC;KACD,QAAQ,CAAC,qDAAqD,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC;KAC7C,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAClE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,0BAA0B,CAAC,CAAC;AAKxC,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAA+B,EAC/B,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,gBAAgB,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAEhE,MAAM,OAAO,GAAG,CAAC,MAAM,gBAAgB,CAAC,mBAAmB,CACzD,KAAK,CAAC,aAAa,EACnB,OAAO,CACR,CAA4B,CAAC;IAE9B,OAAO;QACL,OAAO;QACP,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,iCAAiC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACnH;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,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,2BAA2B;YAClC,KAAK,EAAE;gBACL,WAAW,EAAE,YAAY;aAC1B;SACF;QACD;YACE,KAAK,EAAE,6CAA6C;YACpD,KAAK,EAAE;gBACL,WAAW,EAAE,YAAY;gBACzB,aAAa,EAAE,SAAS;aACzB;SACF;KACF;IACD,KAAK,EAAE,wBAAwB;IAC/B,iBAAiB,EAAE,oCAAoC;CACxD,CAAC"}