@cesteral/meta-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.
- package/LICENSE.md +201 -0
- package/README.md +337 -0
- package/dist/auth/index.d.ts +3 -0
- package/dist/auth/index.d.ts.map +1 -0
- package/dist/auth/index.js +3 -0
- package/dist/auth/index.js.map +1 -0
- package/dist/auth/meta-auth-adapter.d.ts +37 -0
- package/dist/auth/meta-auth-adapter.d.ts.map +1 -0
- package/dist/auth/meta-auth-adapter.js +109 -0
- package/dist/auth/meta-auth-adapter.js.map +1 -0
- package/dist/auth/meta-auth-strategy.d.ts +13 -0
- package/dist/auth/meta-auth-strategy.d.ts.map +1 -0
- package/dist/auth/meta-auth-strategy.js +47 -0
- package/dist/auth/meta-auth-strategy.js.map +1 -0
- package/dist/config/index.d.ts +108 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +51 -0
- package/dist/config/index.js.map +1 -0
- package/dist/config/insights-catalog.json +95 -0
- package/dist/container/index.d.ts +5 -0
- package/dist/container/index.d.ts.map +1 -0
- package/dist/container/index.js +14 -0
- package/dist/container/index.js.map +1 -0
- package/dist/container/registrations/core.d.ts +3 -0
- package/dist/container/registrations/core.d.ts.map +1 -0
- package/dist/container/registrations/core.js +16 -0
- package/dist/container/registrations/core.js.map +1 -0
- package/dist/container/registrations/mcp.d.ts +2 -0
- package/dist/container/registrations/mcp.d.ts.map +1 -0
- package/dist/container/registrations/mcp.js +3 -0
- package/dist/container/registrations/mcp.js.map +1 -0
- package/dist/container/tokens.d.ts +6 -0
- package/dist/container/tokens.d.ts.map +1 -0
- package/dist/container/tokens.js +6 -0
- package/dist/container/tokens.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +40 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +244 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +111 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js +160 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js +299 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js +170 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js +234 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js +159 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.js +79 -0
- package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js +289 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js +109 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +77 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/index.d.ts +9 -0
- package/dist/mcp-server/prompts/index.d.ts.map +1 -0
- package/dist/mcp-server/prompts/index.js +97 -0
- package/dist/mcp-server/prompts/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js +140 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +117 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +125 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.js +28 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/findings.resource.d.ts +8 -0
- package/dist/mcp-server/resources/definitions/findings.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/findings.resource.js +33 -0
- package/dist/mcp-server/resources/definitions/findings.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/index.d.ts +8 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/index.js +81 -0
- package/dist/mcp-server/resources/definitions/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.js +113 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.js +98 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.js.map +1 -0
- package/dist/mcp-server/resources/index.d.ts +3 -0
- package/dist/mcp-server/resources/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/index.js +2 -0
- package/dist/mcp-server/resources/index.js.map +1 -0
- package/dist/mcp-server/resources/types.d.ts +8 -0
- package/dist/mcp-server/resources/types.d.ts.map +1 -0
- package/dist/mcp-server/resources/types.js +2 -0
- package/dist/mcp-server/resources/types.js.map +1 -0
- package/dist/mcp-server/resources/utils/field-rules.d.ts +18 -0
- package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -0
- package/dist/mcp-server/resources/utils/field-rules.js +103 -0
- package/dist/mcp-server/resources/utils/field-rules.js.map +1 -0
- package/dist/mcp-server/server.d.ts +5 -0
- package/dist/mcp-server/server.d.ts.map +1 -0
- package/dist/mcp-server/server.js +133 -0
- package/dist/mcp-server/server.js.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +221 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +178 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +143 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +108 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +180 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +125 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +140 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +112 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +148 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js +107 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +115 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js +104 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +93 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js +102 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +183 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js +109 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +115 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +98 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +69 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +63 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts +69 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js +68 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-available-metrics.tool.d.ts +91 -0
- package/dist/mcp-server/tools/definitions/get-available-metrics.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-available-metrics.tool.js +85 -0
- package/dist/mcp-server/tools/definitions/get-available-metrics.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.d.ts +82 -0
- package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.js +72 -0
- package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +90 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js +83 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.d.ts +277 -0
- package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.js +175 -0
- package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.d.ts +274 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.js +188 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts +141 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js +157 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +81 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +73 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +29 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/index.js +87 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts +147 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js +83 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +184 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js +105 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.d.ts +128 -0
- package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.js +145 -0
- package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +89 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js +87 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +192 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.js +131 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +1714 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +146 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts +88 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.js +89 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts +94 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.js +151 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +169 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js +103 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/index.d.ts +2 -0
- package/dist/mcp-server/tools/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/index.js +2 -0
- package/dist/mcp-server/tools/index.js.map +1 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts +8 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.js +70 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.js.map +1 -0
- package/dist/mcp-server/tools/utils/dry-run.d.ts +11 -0
- package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/dry-run.js +60 -0
- package/dist/mcp-server/tools/utils/dry-run.js.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts +14 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js +138 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
- package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts +53 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.js +80 -0
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
- package/dist/services/meta/meta-graph-api-client.d.ts +19 -0
- package/dist/services/meta/meta-graph-api-client.d.ts.map +1 -0
- package/dist/services/meta/meta-graph-api-client.js +226 -0
- package/dist/services/meta/meta-graph-api-client.js.map +1 -0
- package/dist/services/meta/meta-insights-service.d.ts +76 -0
- package/dist/services/meta/meta-insights-service.d.ts.map +1 -0
- package/dist/services/meta/meta-insights-service.js +209 -0
- package/dist/services/meta/meta-insights-service.js.map +1 -0
- package/dist/services/meta/meta-service.d.ts +64 -0
- package/dist/services/meta/meta-service.d.ts.map +1 -0
- package/dist/services/meta/meta-service.js +177 -0
- package/dist/services/meta/meta-service.js.map +1 -0
- package/dist/services/meta/meta-targeting-service.d.ts +13 -0
- package/dist/services/meta/meta-targeting-service.d.ts.map +1 -0
- package/dist/services/meta/meta-targeting-service.js +38 -0
- package/dist/services/meta/meta-targeting-service.js.map +1 -0
- package/dist/services/meta/types.d.ts +227 -0
- package/dist/services/meta/types.d.ts.map +1 -0
- package/dist/services/meta/types.js +55 -0
- package/dist/services/meta/types.js.map +1 -0
- package/dist/services/session-services.d.ts +19 -0
- package/dist/services/session-services.d.ts.map +1 -0
- package/dist/services/session-services.js +19 -0
- package/dist/services/session-services.js.map +1 -0
- package/dist/testkit/fixtures/index.d.ts +9 -0
- package/dist/testkit/fixtures/index.d.ts.map +1 -0
- package/dist/testkit/fixtures/index.js +201 -0
- package/dist/testkit/fixtures/index.js.map +1 -0
- package/dist/testkit/index.d.ts +6 -0
- package/dist/testkit/index.d.ts.map +1 -0
- package/dist/testkit/index.js +26 -0
- package/dist/testkit/index.js.map +1 -0
- package/dist/testkit/types.d.ts +17 -0
- package/dist/testkit/types.d.ts.map +1 -0
- package/dist/testkit/types.js +2 -0
- package/dist/testkit/types.js.map +1 -0
- package/dist/types-global/mcp.d.ts +2 -0
- package/dist/types-global/mcp.d.ts.map +1 -0
- package/dist/types-global/mcp.js +2 -0
- package/dist/types-global/mcp.js.map +1 -0
- package/dist/utils/errors/index.d.ts +2 -0
- package/dist/utils/errors/index.d.ts.map +1 -0
- package/dist/utils/errors/index.js +2 -0
- package/dist/utils/errors/index.js.map +1 -0
- package/dist/utils/internal/request-context.d.ts +20 -0
- package/dist/utils/internal/request-context.d.ts.map +1 -0
- package/dist/utils/internal/request-context.js +19 -0
- package/dist/utils/internal/request-context.js.map +1 -0
- package/dist/utils/platform.d.ts +3 -0
- package/dist/utils/platform.d.ts.map +1 -0
- package/dist/utils/platform.js +5 -0
- package/dist/utils/platform.js.map +1 -0
- package/dist/utils/security/rate-limiter.d.ts +3 -0
- package/dist/utils/security/rate-limiter.d.ts.map +1 -0
- package/dist/utils/security/rate-limiter.js +5 -0
- package/dist/utils/security/rate-limiter.js.map +1 -0
- package/dist/utils/telemetry/index.d.ts +2 -0
- package/dist/utils/telemetry/index.d.ts.map +1 -0
- package/dist/utils/telemetry/index.js +2 -0
- package/dist/utils/telemetry/index.js.map +1 -0
- package/dist/utils/telemetry/tracing.d.ts +3 -0
- package/dist/utils/telemetry/tracing.d.ts.map +1 -0
- package/dist/utils/telemetry/tracing.js +4 -0
- package/dist/utils/telemetry/tracing.js.map +1 -0
- package/package.json +66 -0
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { PaginationOutputSchema, buildPaginationOutput, formatPaginationHint, } from "@cesteral/shared";
|
|
4
|
+
const TOOL_NAME = "meta_list_ad_accounts";
|
|
5
|
+
const TOOL_TITLE = "List Meta Ad Accounts";
|
|
6
|
+
const TOOL_DESCRIPTION = `List ad accounts accessible to the authenticated user.
|
|
7
|
+
|
|
8
|
+
Returns account ID (with act_ prefix), name, status, currency, timezone, and spend.
|
|
9
|
+
Use this to discover available ad accounts before performing other operations.`;
|
|
10
|
+
export const ListAdAccountsInputSchema = z
|
|
11
|
+
.object({
|
|
12
|
+
fields: z
|
|
13
|
+
.array(z.string())
|
|
14
|
+
.optional()
|
|
15
|
+
.describe("Fields to return (defaults: id, name, account_status, currency, timezone_name, amount_spent, balance)"),
|
|
16
|
+
limit: z.number().min(1).max(100).optional().describe("Number of accounts to return"),
|
|
17
|
+
after: z
|
|
18
|
+
.string()
|
|
19
|
+
.optional()
|
|
20
|
+
.describe("Pagination cursor — pass nextCursor from a previous response to get the next page"),
|
|
21
|
+
})
|
|
22
|
+
.describe("Parameters for listing ad accounts");
|
|
23
|
+
export const ListAdAccountsOutputSchema = z
|
|
24
|
+
.object({
|
|
25
|
+
accounts: z.array(z.record(z.any())).describe("List of ad accounts"),
|
|
26
|
+
pagination: PaginationOutputSchema,
|
|
27
|
+
timestamp: z.string().datetime(),
|
|
28
|
+
})
|
|
29
|
+
.describe("Ad accounts list result");
|
|
30
|
+
export async function listAdAccountsLogic(input, context, sdkContext) {
|
|
31
|
+
const { metaService } = resolveSessionServices(sdkContext);
|
|
32
|
+
const result = await metaService.listAdAccounts(input.fields, input.limit, input.after, context);
|
|
33
|
+
const accounts = result.accounts;
|
|
34
|
+
return {
|
|
35
|
+
accounts,
|
|
36
|
+
pagination: buildPaginationOutput({
|
|
37
|
+
nextCursor: result.nextCursor,
|
|
38
|
+
pageSize: accounts.length,
|
|
39
|
+
nextPageInputKey: "after",
|
|
40
|
+
}),
|
|
41
|
+
timestamp: new Date().toISOString(),
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
export function listAdAccountsResponseFormatter(result) {
|
|
45
|
+
const count = result.pagination.pageSize;
|
|
46
|
+
const summary = `Found ${count} ad account(s)`;
|
|
47
|
+
const accountsBlock = count > 0 ? `\n\n${JSON.stringify(result.accounts, null, 2)}` : "\n\nNo ad accounts found";
|
|
48
|
+
return [
|
|
49
|
+
{
|
|
50
|
+
type: "text",
|
|
51
|
+
text: `${summary}${accountsBlock}${formatPaginationHint(result.pagination)}\n\nTimestamp: ${result.timestamp}`,
|
|
52
|
+
},
|
|
53
|
+
];
|
|
54
|
+
}
|
|
55
|
+
export const listAdAccountsTool = {
|
|
56
|
+
name: TOOL_NAME,
|
|
57
|
+
title: TOOL_TITLE,
|
|
58
|
+
description: TOOL_DESCRIPTION,
|
|
59
|
+
inputSchema: ListAdAccountsInputSchema,
|
|
60
|
+
outputSchema: ListAdAccountsOutputSchema,
|
|
61
|
+
annotations: {
|
|
62
|
+
readOnlyHint: true,
|
|
63
|
+
openWorldHint: false,
|
|
64
|
+
idempotentHint: true,
|
|
65
|
+
destructiveHint: false,
|
|
66
|
+
},
|
|
67
|
+
inputExamples: [
|
|
68
|
+
{
|
|
69
|
+
label: "List all accessible ad accounts",
|
|
70
|
+
input: {},
|
|
71
|
+
},
|
|
72
|
+
{
|
|
73
|
+
label: "List accounts with specific fields",
|
|
74
|
+
input: {
|
|
75
|
+
fields: ["id", "name", "account_status", "currency", "amount_spent"],
|
|
76
|
+
limit: 10,
|
|
77
|
+
},
|
|
78
|
+
},
|
|
79
|
+
],
|
|
80
|
+
logic: listAdAccountsLogic,
|
|
81
|
+
responseFormatter: listAdAccountsResponseFormatter,
|
|
82
|
+
};
|
|
83
|
+
//# sourceMappingURL=list-ad-accounts.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"list-ad-accounts.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-ad-accounts.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "@cesteral/shared";
|
|
4
|
+
export declare const ListEntitiesInputSchema: z.ZodObject<{
|
|
5
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
6
|
+
adAccountId: z.ZodString;
|
|
7
|
+
fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
8
|
+
filtering: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
|
|
9
|
+
limit: z.ZodOptional<z.ZodNumber>;
|
|
10
|
+
after: z.ZodOptional<z.ZodString>;
|
|
11
|
+
}, "strip", z.ZodTypeAny, {
|
|
12
|
+
entityType: string;
|
|
13
|
+
adAccountId: string;
|
|
14
|
+
fields?: string[] | undefined;
|
|
15
|
+
filtering?: Record<string, unknown>[] | undefined;
|
|
16
|
+
limit?: number | undefined;
|
|
17
|
+
after?: string | undefined;
|
|
18
|
+
}, {
|
|
19
|
+
entityType: string;
|
|
20
|
+
adAccountId: string;
|
|
21
|
+
fields?: string[] | undefined;
|
|
22
|
+
filtering?: Record<string, unknown>[] | undefined;
|
|
23
|
+
limit?: number | undefined;
|
|
24
|
+
after?: string | undefined;
|
|
25
|
+
}>;
|
|
26
|
+
export declare const ListEntitiesOutputSchema: z.ZodObject<{
|
|
27
|
+
entities: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
|
|
28
|
+
pagination: z.ZodObject<{
|
|
29
|
+
nextCursor: z.ZodNullable<z.ZodString>;
|
|
30
|
+
hasMore: z.ZodBoolean;
|
|
31
|
+
pageSize: z.ZodNumber;
|
|
32
|
+
totalCount: z.ZodOptional<z.ZodNumber>;
|
|
33
|
+
nextPageInputKey: z.ZodString;
|
|
34
|
+
}, "strip", z.ZodTypeAny, {
|
|
35
|
+
nextCursor: string | null;
|
|
36
|
+
hasMore: boolean;
|
|
37
|
+
pageSize: number;
|
|
38
|
+
nextPageInputKey: string;
|
|
39
|
+
totalCount?: number | undefined;
|
|
40
|
+
}, {
|
|
41
|
+
nextCursor: string | null;
|
|
42
|
+
hasMore: boolean;
|
|
43
|
+
pageSize: number;
|
|
44
|
+
nextPageInputKey: string;
|
|
45
|
+
totalCount?: number | undefined;
|
|
46
|
+
}>;
|
|
47
|
+
timestamp: z.ZodString;
|
|
48
|
+
}, "strip", z.ZodTypeAny, {
|
|
49
|
+
entities: Record<string, any>[];
|
|
50
|
+
pagination: {
|
|
51
|
+
nextCursor: string | null;
|
|
52
|
+
hasMore: boolean;
|
|
53
|
+
pageSize: number;
|
|
54
|
+
nextPageInputKey: string;
|
|
55
|
+
totalCount?: number | undefined;
|
|
56
|
+
};
|
|
57
|
+
timestamp: string;
|
|
58
|
+
}, {
|
|
59
|
+
entities: Record<string, any>[];
|
|
60
|
+
pagination: {
|
|
61
|
+
nextCursor: string | null;
|
|
62
|
+
hasMore: boolean;
|
|
63
|
+
pageSize: number;
|
|
64
|
+
nextPageInputKey: string;
|
|
65
|
+
totalCount?: number | undefined;
|
|
66
|
+
};
|
|
67
|
+
timestamp: string;
|
|
68
|
+
}>;
|
|
69
|
+
type ListEntitiesInput = z.infer<typeof ListEntitiesInputSchema>;
|
|
70
|
+
type ListEntitiesOutput = z.infer<typeof ListEntitiesOutputSchema>;
|
|
71
|
+
export declare function listEntitiesLogic(input: ListEntitiesInput, _context: RequestContext, sdkContext?: SdkContext): Promise<ListEntitiesOutput>;
|
|
72
|
+
export declare function listEntitiesResponseFormatter(result: ListEntitiesOutput): McpTextContent[];
|
|
73
|
+
export declare const listEntitiesTool: {
|
|
74
|
+
name: string;
|
|
75
|
+
title: string;
|
|
76
|
+
description: string;
|
|
77
|
+
inputSchema: z.ZodObject<{
|
|
78
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
79
|
+
adAccountId: z.ZodString;
|
|
80
|
+
fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
81
|
+
filtering: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
|
|
82
|
+
limit: z.ZodOptional<z.ZodNumber>;
|
|
83
|
+
after: z.ZodOptional<z.ZodString>;
|
|
84
|
+
}, "strip", z.ZodTypeAny, {
|
|
85
|
+
entityType: string;
|
|
86
|
+
adAccountId: string;
|
|
87
|
+
fields?: string[] | undefined;
|
|
88
|
+
filtering?: Record<string, unknown>[] | undefined;
|
|
89
|
+
limit?: number | undefined;
|
|
90
|
+
after?: string | undefined;
|
|
91
|
+
}, {
|
|
92
|
+
entityType: string;
|
|
93
|
+
adAccountId: string;
|
|
94
|
+
fields?: string[] | undefined;
|
|
95
|
+
filtering?: Record<string, unknown>[] | undefined;
|
|
96
|
+
limit?: number | undefined;
|
|
97
|
+
after?: string | undefined;
|
|
98
|
+
}>;
|
|
99
|
+
outputSchema: z.ZodObject<{
|
|
100
|
+
entities: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
|
|
101
|
+
pagination: z.ZodObject<{
|
|
102
|
+
nextCursor: z.ZodNullable<z.ZodString>;
|
|
103
|
+
hasMore: z.ZodBoolean;
|
|
104
|
+
pageSize: z.ZodNumber;
|
|
105
|
+
totalCount: z.ZodOptional<z.ZodNumber>;
|
|
106
|
+
nextPageInputKey: z.ZodString;
|
|
107
|
+
}, "strip", z.ZodTypeAny, {
|
|
108
|
+
nextCursor: string | null;
|
|
109
|
+
hasMore: boolean;
|
|
110
|
+
pageSize: number;
|
|
111
|
+
nextPageInputKey: string;
|
|
112
|
+
totalCount?: number | undefined;
|
|
113
|
+
}, {
|
|
114
|
+
nextCursor: string | null;
|
|
115
|
+
hasMore: boolean;
|
|
116
|
+
pageSize: number;
|
|
117
|
+
nextPageInputKey: string;
|
|
118
|
+
totalCount?: number | undefined;
|
|
119
|
+
}>;
|
|
120
|
+
timestamp: z.ZodString;
|
|
121
|
+
}, "strip", z.ZodTypeAny, {
|
|
122
|
+
entities: Record<string, any>[];
|
|
123
|
+
pagination: {
|
|
124
|
+
nextCursor: string | null;
|
|
125
|
+
hasMore: boolean;
|
|
126
|
+
pageSize: number;
|
|
127
|
+
nextPageInputKey: string;
|
|
128
|
+
totalCount?: number | undefined;
|
|
129
|
+
};
|
|
130
|
+
timestamp: string;
|
|
131
|
+
}, {
|
|
132
|
+
entities: Record<string, any>[];
|
|
133
|
+
pagination: {
|
|
134
|
+
nextCursor: string | null;
|
|
135
|
+
hasMore: boolean;
|
|
136
|
+
pageSize: number;
|
|
137
|
+
nextPageInputKey: string;
|
|
138
|
+
totalCount?: number | undefined;
|
|
139
|
+
};
|
|
140
|
+
timestamp: string;
|
|
141
|
+
}>;
|
|
142
|
+
annotations: {
|
|
143
|
+
readOnlyHint: boolean;
|
|
144
|
+
openWorldHint: boolean;
|
|
145
|
+
idempotentHint: boolean;
|
|
146
|
+
destructiveHint: boolean;
|
|
147
|
+
};
|
|
148
|
+
inputExamples: ({
|
|
149
|
+
label: string;
|
|
150
|
+
input: {
|
|
151
|
+
entityType: string;
|
|
152
|
+
adAccountId: string;
|
|
153
|
+
filtering: {
|
|
154
|
+
field: string;
|
|
155
|
+
operator: string;
|
|
156
|
+
value: string[];
|
|
157
|
+
}[];
|
|
158
|
+
limit: number;
|
|
159
|
+
fields?: undefined;
|
|
160
|
+
};
|
|
161
|
+
} | {
|
|
162
|
+
label: string;
|
|
163
|
+
input: {
|
|
164
|
+
entityType: string;
|
|
165
|
+
adAccountId: string;
|
|
166
|
+
filtering?: undefined;
|
|
167
|
+
limit?: undefined;
|
|
168
|
+
fields?: undefined;
|
|
169
|
+
};
|
|
170
|
+
} | {
|
|
171
|
+
label: string;
|
|
172
|
+
input: {
|
|
173
|
+
entityType: string;
|
|
174
|
+
adAccountId: string;
|
|
175
|
+
fields: string[];
|
|
176
|
+
limit: number;
|
|
177
|
+
filtering?: undefined;
|
|
178
|
+
};
|
|
179
|
+
})[];
|
|
180
|
+
logic: typeof listEntitiesLogic;
|
|
181
|
+
responseFormatter: typeof listEntitiesResponseFormatter;
|
|
182
|
+
};
|
|
183
|
+
export {};
|
|
184
|
+
//# 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;AAQxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;EAoBmB,CAAC;AAExD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMJ,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,QAAQ,EAAE,cAAc,EACxB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAuB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAc1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC5B,CAAC"}
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { getEntityTypeEnum } from "../utils/entity-mapping.js";
|
|
4
|
+
import { PaginationOutputSchema, buildPaginationOutput, formatPaginationHint, } from "@cesteral/shared";
|
|
5
|
+
const TOOL_NAME = "meta_list_entities";
|
|
6
|
+
const TOOL_TITLE = "List Meta Ads Entities";
|
|
7
|
+
const TOOL_DESCRIPTION = `List Meta Ads entities with optional filtering and cursor-based pagination. All entities are scoped to an ad account. Specify \`fields\` to control returned data (Meta returns no fields by default). Use \`after\` cursor for subsequent pages.`;
|
|
8
|
+
export const ListEntitiesInputSchema = z
|
|
9
|
+
.object({
|
|
10
|
+
entityType: z.enum(getEntityTypeEnum()).describe("Type of entities to list"),
|
|
11
|
+
adAccountId: z.string().describe("Ad Account ID (with or without act_ prefix)"),
|
|
12
|
+
fields: z
|
|
13
|
+
.array(z.string())
|
|
14
|
+
.optional()
|
|
15
|
+
.describe("Fields to return (defaults to common fields for the entity type)"),
|
|
16
|
+
filtering: z
|
|
17
|
+
.array(z.record(z.unknown()))
|
|
18
|
+
.optional()
|
|
19
|
+
.describe("Meta filtering array, e.g. [{field:'status',operator:'IN',value:['ACTIVE']}]"),
|
|
20
|
+
limit: z
|
|
21
|
+
.number()
|
|
22
|
+
.min(1)
|
|
23
|
+
.max(100)
|
|
24
|
+
.optional()
|
|
25
|
+
.describe("Number of entities per page (default 25)"),
|
|
26
|
+
after: z.string().optional().describe("Cursor for next page of results"),
|
|
27
|
+
})
|
|
28
|
+
.describe("Parameters for listing Meta Ads entities");
|
|
29
|
+
export const ListEntitiesOutputSchema = z
|
|
30
|
+
.object({
|
|
31
|
+
entities: z.array(z.record(z.any())).describe("List of entities"),
|
|
32
|
+
pagination: PaginationOutputSchema,
|
|
33
|
+
timestamp: z.string().datetime(),
|
|
34
|
+
})
|
|
35
|
+
.describe("Entity list result");
|
|
36
|
+
export async function listEntitiesLogic(input, _context, sdkContext) {
|
|
37
|
+
const { metaService } = resolveSessionServices(sdkContext);
|
|
38
|
+
const result = await metaService.listEntities(input.entityType, input.adAccountId, input.fields, input.filtering, input.limit, input.after, _context);
|
|
39
|
+
const entities = result.entities;
|
|
40
|
+
return {
|
|
41
|
+
entities,
|
|
42
|
+
pagination: buildPaginationOutput({
|
|
43
|
+
nextCursor: result.nextCursor,
|
|
44
|
+
pageSize: entities.length,
|
|
45
|
+
nextPageInputKey: "after",
|
|
46
|
+
}),
|
|
47
|
+
timestamp: new Date().toISOString(),
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
export function listEntitiesResponseFormatter(result) {
|
|
51
|
+
const count = result.pagination.pageSize;
|
|
52
|
+
const summary = `Found ${count} entities`;
|
|
53
|
+
const entities = count > 0
|
|
54
|
+
? `\n\nEntities:\n${JSON.stringify(result.entities, null, 2)}`
|
|
55
|
+
: "\n\nNo entities found";
|
|
56
|
+
return [
|
|
57
|
+
{
|
|
58
|
+
type: "text",
|
|
59
|
+
text: `${summary}${entities}${formatPaginationHint(result.pagination)}\n\nTimestamp: ${result.timestamp}`,
|
|
60
|
+
},
|
|
61
|
+
];
|
|
62
|
+
}
|
|
63
|
+
export const listEntitiesTool = {
|
|
64
|
+
name: TOOL_NAME,
|
|
65
|
+
title: TOOL_TITLE,
|
|
66
|
+
description: TOOL_DESCRIPTION,
|
|
67
|
+
inputSchema: ListEntitiesInputSchema,
|
|
68
|
+
outputSchema: ListEntitiesOutputSchema,
|
|
69
|
+
annotations: {
|
|
70
|
+
readOnlyHint: true,
|
|
71
|
+
openWorldHint: false,
|
|
72
|
+
idempotentHint: true,
|
|
73
|
+
destructiveHint: false,
|
|
74
|
+
},
|
|
75
|
+
inputExamples: [
|
|
76
|
+
{
|
|
77
|
+
label: "List active campaigns for an ad account",
|
|
78
|
+
input: {
|
|
79
|
+
entityType: "campaign",
|
|
80
|
+
adAccountId: "act_123456789",
|
|
81
|
+
filtering: [{ field: "status", operator: "IN", value: ["ACTIVE"] }],
|
|
82
|
+
limit: 25,
|
|
83
|
+
},
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
label: "List all ad sets",
|
|
87
|
+
input: {
|
|
88
|
+
entityType: "adSet",
|
|
89
|
+
adAccountId: "act_123456789",
|
|
90
|
+
},
|
|
91
|
+
},
|
|
92
|
+
{
|
|
93
|
+
label: "List ad creatives with specific fields",
|
|
94
|
+
input: {
|
|
95
|
+
entityType: "adCreative",
|
|
96
|
+
adAccountId: "act_123456789",
|
|
97
|
+
fields: ["id", "name", "body", "image_url"],
|
|
98
|
+
limit: 50,
|
|
99
|
+
},
|
|
100
|
+
},
|
|
101
|
+
],
|
|
102
|
+
logic: listEntitiesLogic,
|
|
103
|
+
responseFormatter: listEntitiesResponseFormatter,
|
|
104
|
+
};
|
|
105
|
+
//# 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":"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"}
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "@cesteral/shared";
|
|
4
|
+
export declare const ManageBudgetScheduleInputSchema: z.ZodEffects<z.ZodObject<{
|
|
5
|
+
operation: z.ZodEnum<["create", "list"]>;
|
|
6
|
+
campaignId: z.ZodString;
|
|
7
|
+
data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
|
|
8
|
+
}, "strip", z.ZodTypeAny, {
|
|
9
|
+
operation: "create" | "list";
|
|
10
|
+
campaignId: string;
|
|
11
|
+
data?: Record<string, any> | undefined;
|
|
12
|
+
}, {
|
|
13
|
+
operation: "create" | "list";
|
|
14
|
+
campaignId: string;
|
|
15
|
+
data?: Record<string, any> | undefined;
|
|
16
|
+
}>, {
|
|
17
|
+
operation: "create" | "list";
|
|
18
|
+
campaignId: string;
|
|
19
|
+
data?: Record<string, any> | undefined;
|
|
20
|
+
}, {
|
|
21
|
+
operation: "create" | "list";
|
|
22
|
+
campaignId: string;
|
|
23
|
+
data?: Record<string, any> | undefined;
|
|
24
|
+
}>;
|
|
25
|
+
export declare const ManageBudgetScheduleOutputSchema: z.ZodObject<{
|
|
26
|
+
confirmed: z.ZodBoolean;
|
|
27
|
+
declineReason: z.ZodOptional<z.ZodString>;
|
|
28
|
+
operation: z.ZodString;
|
|
29
|
+
campaignId: z.ZodString;
|
|
30
|
+
result: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
31
|
+
timestamp: z.ZodString;
|
|
32
|
+
}, "strip", z.ZodTypeAny, {
|
|
33
|
+
operation: string;
|
|
34
|
+
timestamp: string;
|
|
35
|
+
confirmed: boolean;
|
|
36
|
+
result: Record<string, any>;
|
|
37
|
+
campaignId: string;
|
|
38
|
+
declineReason?: string | undefined;
|
|
39
|
+
}, {
|
|
40
|
+
operation: string;
|
|
41
|
+
timestamp: string;
|
|
42
|
+
confirmed: boolean;
|
|
43
|
+
result: Record<string, any>;
|
|
44
|
+
campaignId: string;
|
|
45
|
+
declineReason?: string | undefined;
|
|
46
|
+
}>;
|
|
47
|
+
type ManageBudgetScheduleInput = z.infer<typeof ManageBudgetScheduleInputSchema>;
|
|
48
|
+
type ManageBudgetScheduleOutput = z.infer<typeof ManageBudgetScheduleOutputSchema>;
|
|
49
|
+
export declare function manageBudgetScheduleLogic(input: ManageBudgetScheduleInput, context: RequestContext, sdkContext?: SdkContext): Promise<ManageBudgetScheduleOutput>;
|
|
50
|
+
export declare function manageBudgetScheduleResponseFormatter(result: ManageBudgetScheduleOutput): McpTextContent[];
|
|
51
|
+
export declare const manageBudgetScheduleTool: {
|
|
52
|
+
name: string;
|
|
53
|
+
title: string;
|
|
54
|
+
description: string;
|
|
55
|
+
inputSchema: z.ZodEffects<z.ZodObject<{
|
|
56
|
+
operation: z.ZodEnum<["create", "list"]>;
|
|
57
|
+
campaignId: z.ZodString;
|
|
58
|
+
data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
|
|
59
|
+
}, "strip", z.ZodTypeAny, {
|
|
60
|
+
operation: "create" | "list";
|
|
61
|
+
campaignId: string;
|
|
62
|
+
data?: Record<string, any> | undefined;
|
|
63
|
+
}, {
|
|
64
|
+
operation: "create" | "list";
|
|
65
|
+
campaignId: string;
|
|
66
|
+
data?: Record<string, any> | undefined;
|
|
67
|
+
}>, {
|
|
68
|
+
operation: "create" | "list";
|
|
69
|
+
campaignId: string;
|
|
70
|
+
data?: Record<string, any> | undefined;
|
|
71
|
+
}, {
|
|
72
|
+
operation: "create" | "list";
|
|
73
|
+
campaignId: string;
|
|
74
|
+
data?: Record<string, any> | undefined;
|
|
75
|
+
}>;
|
|
76
|
+
outputSchema: z.ZodObject<{
|
|
77
|
+
confirmed: z.ZodBoolean;
|
|
78
|
+
declineReason: z.ZodOptional<z.ZodString>;
|
|
79
|
+
operation: z.ZodString;
|
|
80
|
+
campaignId: z.ZodString;
|
|
81
|
+
result: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
82
|
+
timestamp: z.ZodString;
|
|
83
|
+
}, "strip", z.ZodTypeAny, {
|
|
84
|
+
operation: string;
|
|
85
|
+
timestamp: string;
|
|
86
|
+
confirmed: boolean;
|
|
87
|
+
result: Record<string, any>;
|
|
88
|
+
campaignId: string;
|
|
89
|
+
declineReason?: string | undefined;
|
|
90
|
+
}, {
|
|
91
|
+
operation: string;
|
|
92
|
+
timestamp: string;
|
|
93
|
+
confirmed: boolean;
|
|
94
|
+
result: Record<string, any>;
|
|
95
|
+
campaignId: string;
|
|
96
|
+
declineReason?: string | undefined;
|
|
97
|
+
}>;
|
|
98
|
+
annotations: {
|
|
99
|
+
readOnlyHint: boolean;
|
|
100
|
+
openWorldHint: boolean;
|
|
101
|
+
idempotentHint: boolean;
|
|
102
|
+
destructiveHint: boolean;
|
|
103
|
+
};
|
|
104
|
+
inputExamples: ({
|
|
105
|
+
label: string;
|
|
106
|
+
input: {
|
|
107
|
+
operation: string;
|
|
108
|
+
campaignId: string;
|
|
109
|
+
data: {
|
|
110
|
+
budget_value: string;
|
|
111
|
+
budget_value_type: string;
|
|
112
|
+
time_start: string;
|
|
113
|
+
time_end: string;
|
|
114
|
+
};
|
|
115
|
+
};
|
|
116
|
+
} | {
|
|
117
|
+
label: string;
|
|
118
|
+
input: {
|
|
119
|
+
operation: string;
|
|
120
|
+
campaignId: string;
|
|
121
|
+
data?: undefined;
|
|
122
|
+
};
|
|
123
|
+
})[];
|
|
124
|
+
logic: typeof manageBudgetScheduleLogic;
|
|
125
|
+
responseFormatter: typeof manageBudgetScheduleResponseFormatter;
|
|
126
|
+
};
|
|
127
|
+
export {};
|
|
128
|
+
//# sourceMappingURL=manage-budget-schedule.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"manage-budget-schedule.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/manage-budget-schedule.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAmBnD,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;EAoByB,CAAC;AAEtE,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;EASE,CAAC;AAEhD,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACjF,KAAK,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAEnF,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,yBAAyB,EAChC,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,0BAA0B,CAAC,CA0CrC;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,0BAA0B,GACjC,cAAc,EAAE,CAoBlB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCpC,CAAC"}
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { elicitBudgetChangeConfirmation } from "@cesteral/shared";
|
|
4
|
+
const TOOL_NAME = "meta_manage_budget_schedule";
|
|
5
|
+
const TOOL_TITLE = "Meta Ads Budget Schedule Management";
|
|
6
|
+
const TOOL_DESCRIPTION = `Create or list budget schedules for a campaign.
|
|
7
|
+
|
|
8
|
+
Budget schedules allow temporary budget increases during high-demand periods
|
|
9
|
+
(e.g., flash sales, holidays). Uses POST /{campaignId}/budget_schedules.
|
|
10
|
+
|
|
11
|
+
**Operations:**
|
|
12
|
+
- \`create\` — Create a new budget schedule on a campaign
|
|
13
|
+
- \`list\` — List existing budget schedules for a campaign
|
|
14
|
+
|
|
15
|
+
**Create requires:**
|
|
16
|
+
- \`budget_value\` (string) — Budget amount in cents (e.g., "5000" for $50)
|
|
17
|
+
- \`budget_value_type\` (string) — ABSOLUTE or RELATIVE
|
|
18
|
+
- \`time_start\` (string) — ISO 8601 start time
|
|
19
|
+
- \`time_end\` (string) — ISO 8601 end time`;
|
|
20
|
+
export const ManageBudgetScheduleInputSchema = z
|
|
21
|
+
.object({
|
|
22
|
+
operation: z.enum(["create", "list"]).describe("Operation to perform"),
|
|
23
|
+
campaignId: z.string().min(1).describe("Campaign ID to manage budget schedules for"),
|
|
24
|
+
data: z
|
|
25
|
+
.record(z.any())
|
|
26
|
+
.optional()
|
|
27
|
+
.describe("Budget schedule data (required for create: budget_value, budget_value_type, time_start, time_end)"),
|
|
28
|
+
})
|
|
29
|
+
.superRefine((val, ctx) => {
|
|
30
|
+
if (val.operation === "create" && !val.data) {
|
|
31
|
+
ctx.addIssue({
|
|
32
|
+
code: z.ZodIssueCode.custom,
|
|
33
|
+
path: ["data"],
|
|
34
|
+
message: "data is required when operation is 'create'",
|
|
35
|
+
});
|
|
36
|
+
}
|
|
37
|
+
})
|
|
38
|
+
.describe("Parameters for managing Meta campaign budget schedules");
|
|
39
|
+
export const ManageBudgetScheduleOutputSchema = z
|
|
40
|
+
.object({
|
|
41
|
+
confirmed: z.boolean(),
|
|
42
|
+
declineReason: z.string().optional(),
|
|
43
|
+
operation: z.string(),
|
|
44
|
+
campaignId: z.string(),
|
|
45
|
+
result: z.record(z.any()).describe("API response data"),
|
|
46
|
+
timestamp: z.string().datetime(),
|
|
47
|
+
})
|
|
48
|
+
.describe("Budget schedule operation result");
|
|
49
|
+
export async function manageBudgetScheduleLogic(input, context, sdkContext) {
|
|
50
|
+
if (input.operation === "create") {
|
|
51
|
+
const data = input.data ?? {};
|
|
52
|
+
const budget = data.budget_value ?? "(unspecified)";
|
|
53
|
+
const valueType = data.budget_value_type ?? "ABSOLUTE";
|
|
54
|
+
const start = data.time_start ?? "";
|
|
55
|
+
const end = data.time_end ?? "";
|
|
56
|
+
const confirmed = await elicitBudgetChangeConfirmation({
|
|
57
|
+
entityLabel: "campaign",
|
|
58
|
+
entityId: input.campaignId,
|
|
59
|
+
summary: `Creating budget schedule: ${valueType} budget=${budget} cents from ${start} to ${end}.`,
|
|
60
|
+
sdkContext,
|
|
61
|
+
});
|
|
62
|
+
if (!confirmed) {
|
|
63
|
+
return {
|
|
64
|
+
confirmed: false,
|
|
65
|
+
declineReason: "user_declined",
|
|
66
|
+
operation: input.operation,
|
|
67
|
+
campaignId: input.campaignId,
|
|
68
|
+
result: {},
|
|
69
|
+
timestamp: new Date().toISOString(),
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
const { metaService } = resolveSessionServices(sdkContext);
|
|
74
|
+
let result;
|
|
75
|
+
if (input.operation === "create") {
|
|
76
|
+
result = await metaService.createBudgetSchedule(input.campaignId, input.data, context);
|
|
77
|
+
}
|
|
78
|
+
else {
|
|
79
|
+
result = await metaService.listBudgetSchedules(input.campaignId, context);
|
|
80
|
+
}
|
|
81
|
+
return {
|
|
82
|
+
confirmed: true,
|
|
83
|
+
operation: input.operation,
|
|
84
|
+
campaignId: input.campaignId,
|
|
85
|
+
result: result,
|
|
86
|
+
timestamp: new Date().toISOString(),
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
export function manageBudgetScheduleResponseFormatter(result) {
|
|
90
|
+
if (!result.confirmed) {
|
|
91
|
+
return [
|
|
92
|
+
{
|
|
93
|
+
type: "text",
|
|
94
|
+
text: `Budget schedule creation cancelled by user.\n\nTimestamp: ${result.timestamp}`,
|
|
95
|
+
},
|
|
96
|
+
];
|
|
97
|
+
}
|
|
98
|
+
const header = result.operation === "create"
|
|
99
|
+
? `Budget schedule created for campaign ${result.campaignId}`
|
|
100
|
+
: `Budget schedules for campaign ${result.campaignId}`;
|
|
101
|
+
return [
|
|
102
|
+
{
|
|
103
|
+
type: "text",
|
|
104
|
+
text: `${header}\n\n${JSON.stringify(result.result, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
105
|
+
},
|
|
106
|
+
];
|
|
107
|
+
}
|
|
108
|
+
export const manageBudgetScheduleTool = {
|
|
109
|
+
name: TOOL_NAME,
|
|
110
|
+
title: TOOL_TITLE,
|
|
111
|
+
description: TOOL_DESCRIPTION,
|
|
112
|
+
inputSchema: ManageBudgetScheduleInputSchema,
|
|
113
|
+
outputSchema: ManageBudgetScheduleOutputSchema,
|
|
114
|
+
annotations: {
|
|
115
|
+
readOnlyHint: false,
|
|
116
|
+
openWorldHint: true,
|
|
117
|
+
idempotentHint: false,
|
|
118
|
+
destructiveHint: false,
|
|
119
|
+
},
|
|
120
|
+
inputExamples: [
|
|
121
|
+
{
|
|
122
|
+
label: "Create a budget schedule for a flash sale",
|
|
123
|
+
input: {
|
|
124
|
+
operation: "create",
|
|
125
|
+
campaignId: "23456789012345",
|
|
126
|
+
data: {
|
|
127
|
+
budget_value: "10000",
|
|
128
|
+
budget_value_type: "ABSOLUTE",
|
|
129
|
+
time_start: "2026-04-01T00:00:00-0700",
|
|
130
|
+
time_end: "2026-04-02T00:00:00-0700",
|
|
131
|
+
},
|
|
132
|
+
},
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
label: "List budget schedules for a campaign",
|
|
136
|
+
input: {
|
|
137
|
+
operation: "list",
|
|
138
|
+
campaignId: "23456789012345",
|
|
139
|
+
},
|
|
140
|
+
},
|
|
141
|
+
],
|
|
142
|
+
logic: manageBudgetScheduleLogic,
|
|
143
|
+
responseFormatter: manageBudgetScheduleResponseFormatter,
|
|
144
|
+
};
|
|
145
|
+
//# sourceMappingURL=manage-budget-schedule.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"manage-budget-schedule.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/manage-budget-schedule.tool.ts"],"names":[],"mappings":"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"}
|