@cesteral/snapchat-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 +336 -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/snapchat-auth-adapter.d.ts +44 -0
- package/dist/auth/snapchat-auth-adapter.d.ts.map +1 -0
- package/dist/auth/snapchat-auth-adapter.js +127 -0
- package/dist/auth/snapchat-auth-adapter.js.map +1 -0
- package/dist/auth/snapchat-auth-strategy.d.ts +13 -0
- package/dist/auth/snapchat-auth-strategy.d.ts.map +1 -0
- package/dist/auth/snapchat-auth-strategy.js +54 -0
- package/dist/auth/snapchat-auth-strategy.js.map +1 -0
- package/dist/config/index.d.ts +124 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +57 -0
- package/dist/config/index.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +46 -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 +127 -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 +121 -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 +121 -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 +198 -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 +189 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js +126 -0
- package/dist/mcp-server/prompts/definitions/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 +198 -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 +91 -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 +111 -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 +89 -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 +177 -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 +194 -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 +117 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/index.d.ts +7 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/index.js +54 -0
- package/dist/mcp-server/resources/definitions/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.js +148 -0
- package/dist/mcp-server/resources/definitions/reporting-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/server.d.ts +5 -0
- package/dist/mcp-server/server.d.ts.map +1 -0
- package/dist/mcp-server/server.js +134 -0
- package/dist/mcp-server/server.js.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +209 -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 +141 -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 +163 -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 +119 -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 +241 -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 +149 -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 +203 -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 +154 -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 +119 -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 +89 -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 +131 -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 +116 -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 +100 -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 +110 -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 +297 -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 +103 -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 +105 -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 +93 -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 +68 -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 +61 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.d.ts +104 -0
- package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.js +107 -0
- package/dist/mcp-server/tools/definitions/get-audience-estimate.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +76 -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 +71 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +295 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +172 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +279 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.js +166 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +89 -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 +99 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +25 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/index.js +75 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-advertisers.tool.d.ts +54 -0
- package/dist/mcp-server/tools/definitions/list-advertisers.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-advertisers.tool.js +61 -0
- package/dist/mcp-server/tools/definitions/list-advertisers.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +161 -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 +94 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +103 -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 +108 -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 +134 -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 +110 -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 +155 -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 +115 -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 +82 -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 +111 -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 +82 -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 +109 -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 +204 -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/entity-mapping.d.ts +18 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js +96 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
- package/dist/mcp-server/tools/utils/media-types.d.ts +19 -0
- package/dist/mcp-server/tools/utils/media-types.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/media-types.js +2 -0
- package/dist/mcp-server/tools/utils/media-types.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 +61 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.js +105 -0
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
- package/dist/services/session-services.d.ts +20 -0
- package/dist/services/session-services.d.ts.map +1 -0
- package/dist/services/session-services.js +23 -0
- package/dist/services/session-services.js.map +1 -0
- package/dist/services/snapchat/snapchat-http-client.d.ts +16 -0
- package/dist/services/snapchat/snapchat-http-client.d.ts.map +1 -0
- package/dist/services/snapchat/snapchat-http-client.js +153 -0
- package/dist/services/snapchat/snapchat-http-client.js.map +1 -0
- package/dist/services/snapchat/snapchat-reporting-service.d.ts +64 -0
- package/dist/services/snapchat/snapchat-reporting-service.d.ts.map +1 -0
- package/dist/services/snapchat/snapchat-reporting-service.js +172 -0
- package/dist/services/snapchat/snapchat-reporting-service.js.map +1 -0
- package/dist/services/snapchat/snapchat-service.d.ts +82 -0
- package/dist/services/snapchat/snapchat-service.d.ts.map +1 -0
- package/dist/services/snapchat/snapchat-service.js +321 -0
- package/dist/services/snapchat/snapchat-service.js.map +1 -0
- package/dist/services/snapchat/types.d.ts +136 -0
- package/dist/services/snapchat/types.d.ts.map +1 -0
- package/dist/services/snapchat/types.js +59 -0
- package/dist/services/snapchat/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/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 +55 -0
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
const TOOL_NAME = "snapchat_search_targeting";
|
|
4
|
+
const TOOL_TITLE = "Snapchat Search Targeting Options";
|
|
5
|
+
const TOOL_DESCRIPTION = `Search documented Snapchat targeting options by keyword.
|
|
6
|
+
|
|
7
|
+
**Common targeting types:**
|
|
8
|
+
- geo_country
|
|
9
|
+
- geo_region
|
|
10
|
+
- geo_metro
|
|
11
|
+
- geo_postal_code
|
|
12
|
+
- interests_slc
|
|
13
|
+
- interests_vac
|
|
14
|
+
- interests_shp
|
|
15
|
+
|
|
16
|
+
This tool fetches a documented targeting endpoint and filters the results client-side.`;
|
|
17
|
+
export const SearchTargetingInputSchema = z
|
|
18
|
+
.object({
|
|
19
|
+
targetingType: z
|
|
20
|
+
.enum([
|
|
21
|
+
"geo_country",
|
|
22
|
+
"geo_region",
|
|
23
|
+
"geo_metro",
|
|
24
|
+
"geo_postal_code",
|
|
25
|
+
"interests_slc",
|
|
26
|
+
"interests_vac",
|
|
27
|
+
"interests_shp",
|
|
28
|
+
])
|
|
29
|
+
.describe("Documented targeting endpoint to query and filter"),
|
|
30
|
+
countryCode: z
|
|
31
|
+
.string()
|
|
32
|
+
.optional()
|
|
33
|
+
.describe("ISO alpha-2 country code required for country-specific targeting types"),
|
|
34
|
+
query: z
|
|
35
|
+
.string()
|
|
36
|
+
.optional()
|
|
37
|
+
.describe("Search keyword (optional — returns top options if omitted)"),
|
|
38
|
+
limit: z
|
|
39
|
+
.number()
|
|
40
|
+
.int()
|
|
41
|
+
.min(1)
|
|
42
|
+
.max(100)
|
|
43
|
+
.optional()
|
|
44
|
+
.default(20)
|
|
45
|
+
.describe("Maximum number of results (default 20)"),
|
|
46
|
+
})
|
|
47
|
+
.describe("Parameters for searching Snapchat targeting options");
|
|
48
|
+
export const SearchTargetingOutputSchema = z
|
|
49
|
+
.object({
|
|
50
|
+
results: z.array(z.record(z.any())).describe("Targeting options matching the query"),
|
|
51
|
+
count: z.number().describe("Number of results returned"),
|
|
52
|
+
targetingType: z.string(),
|
|
53
|
+
timestamp: z.string().datetime(),
|
|
54
|
+
})
|
|
55
|
+
.describe("Targeting search result");
|
|
56
|
+
export async function searchTargetingLogic(input, context, sdkContext) {
|
|
57
|
+
const { snapchatService } = resolveSessionServices(sdkContext);
|
|
58
|
+
const results = (await snapchatService.searchTargeting(input.targetingType, input.countryCode, input.query, input.limit, context));
|
|
59
|
+
return {
|
|
60
|
+
results: results.results,
|
|
61
|
+
count: results.results.length,
|
|
62
|
+
targetingType: input.targetingType,
|
|
63
|
+
timestamp: new Date().toISOString(),
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
export function searchTargetingResponseFormatter(result) {
|
|
67
|
+
return [
|
|
68
|
+
{
|
|
69
|
+
type: "text",
|
|
70
|
+
text: `Found ${result.count} ${result.targetingType} targeting options\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
71
|
+
},
|
|
72
|
+
];
|
|
73
|
+
}
|
|
74
|
+
export const searchTargetingTool = {
|
|
75
|
+
name: TOOL_NAME,
|
|
76
|
+
title: TOOL_TITLE,
|
|
77
|
+
description: TOOL_DESCRIPTION,
|
|
78
|
+
inputSchema: SearchTargetingInputSchema,
|
|
79
|
+
outputSchema: SearchTargetingOutputSchema,
|
|
80
|
+
annotations: {
|
|
81
|
+
readOnlyHint: true,
|
|
82
|
+
openWorldHint: false,
|
|
83
|
+
idempotentHint: true,
|
|
84
|
+
destructiveHint: false,
|
|
85
|
+
},
|
|
86
|
+
inputExamples: [
|
|
87
|
+
{
|
|
88
|
+
label: "Search interest categories",
|
|
89
|
+
input: {
|
|
90
|
+
targetingType: "interests_slc",
|
|
91
|
+
countryCode: "us",
|
|
92
|
+
query: "gaming",
|
|
93
|
+
limit: 20,
|
|
94
|
+
},
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
label: "Browse UK metro targeting",
|
|
98
|
+
input: {
|
|
99
|
+
targetingType: "geo_metro",
|
|
100
|
+
countryCode: "gb",
|
|
101
|
+
limit: 30,
|
|
102
|
+
},
|
|
103
|
+
},
|
|
104
|
+
],
|
|
105
|
+
logic: searchTargetingLogic,
|
|
106
|
+
responseFormatter: searchTargetingResponseFormatter,
|
|
107
|
+
};
|
|
108
|
+
//# sourceMappingURL=search-targeting.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"search-targeting.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-targeting.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "@cesteral/shared";
|
|
4
|
+
export declare const SubmitReportInputSchema: z.ZodEffects<z.ZodObject<{
|
|
5
|
+
adAccountId: z.ZodString;
|
|
6
|
+
fields: z.ZodArray<z.ZodString, "many">;
|
|
7
|
+
datePreset: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
|
|
8
|
+
startTime: z.ZodOptional<z.ZodString>;
|
|
9
|
+
endTime: z.ZodOptional<z.ZodString>;
|
|
10
|
+
granularity: z.ZodDefault<z.ZodOptional<z.ZodEnum<["TOTAL", "DAY", "HOUR", "LIFETIME"]>>>;
|
|
11
|
+
dimensionType: z.ZodOptional<z.ZodEnum<["CAMPAIGN", "AD_SQUAD", "AD"]>>;
|
|
12
|
+
}, "strip", z.ZodTypeAny, {
|
|
13
|
+
adAccountId: string;
|
|
14
|
+
fields: string[];
|
|
15
|
+
granularity: "TOTAL" | "DAY" | "HOUR" | "LIFETIME";
|
|
16
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
17
|
+
startTime?: string | undefined;
|
|
18
|
+
endTime?: string | undefined;
|
|
19
|
+
dimensionType?: "CAMPAIGN" | "AD_SQUAD" | "AD" | undefined;
|
|
20
|
+
}, {
|
|
21
|
+
adAccountId: string;
|
|
22
|
+
fields: string[];
|
|
23
|
+
granularity?: "TOTAL" | "DAY" | "HOUR" | "LIFETIME" | undefined;
|
|
24
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
25
|
+
startTime?: string | undefined;
|
|
26
|
+
endTime?: string | undefined;
|
|
27
|
+
dimensionType?: "CAMPAIGN" | "AD_SQUAD" | "AD" | undefined;
|
|
28
|
+
}>, {
|
|
29
|
+
adAccountId: string;
|
|
30
|
+
fields: string[];
|
|
31
|
+
granularity: "TOTAL" | "DAY" | "HOUR" | "LIFETIME";
|
|
32
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
33
|
+
startTime?: string | undefined;
|
|
34
|
+
endTime?: string | undefined;
|
|
35
|
+
dimensionType?: "CAMPAIGN" | "AD_SQUAD" | "AD" | undefined;
|
|
36
|
+
}, {
|
|
37
|
+
adAccountId: string;
|
|
38
|
+
fields: string[];
|
|
39
|
+
granularity?: "TOTAL" | "DAY" | "HOUR" | "LIFETIME" | undefined;
|
|
40
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
41
|
+
startTime?: string | undefined;
|
|
42
|
+
endTime?: string | undefined;
|
|
43
|
+
dimensionType?: "CAMPAIGN" | "AD_SQUAD" | "AD" | undefined;
|
|
44
|
+
}>;
|
|
45
|
+
export declare const SubmitReportOutputSchema: z.ZodObject<{
|
|
46
|
+
taskId: z.ZodString;
|
|
47
|
+
timestamp: z.ZodString;
|
|
48
|
+
}, "strip", z.ZodTypeAny, {
|
|
49
|
+
taskId: string;
|
|
50
|
+
timestamp: string;
|
|
51
|
+
}, {
|
|
52
|
+
taskId: string;
|
|
53
|
+
timestamp: string;
|
|
54
|
+
}>;
|
|
55
|
+
type SubmitReportInput = z.infer<typeof SubmitReportInputSchema>;
|
|
56
|
+
type SubmitReportOutput = z.infer<typeof SubmitReportOutputSchema>;
|
|
57
|
+
export declare function submitReportLogic(input: SubmitReportInput, context: RequestContext, sdkContext?: SdkContext): Promise<SubmitReportOutput>;
|
|
58
|
+
export declare function submitReportResponseFormatter(result: SubmitReportOutput): McpTextContent[];
|
|
59
|
+
export declare const submitReportTool: {
|
|
60
|
+
name: string;
|
|
61
|
+
title: string;
|
|
62
|
+
description: string;
|
|
63
|
+
inputSchema: z.ZodEffects<z.ZodObject<{
|
|
64
|
+
adAccountId: z.ZodString;
|
|
65
|
+
fields: z.ZodArray<z.ZodString, "many">;
|
|
66
|
+
datePreset: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
|
|
67
|
+
startTime: z.ZodOptional<z.ZodString>;
|
|
68
|
+
endTime: z.ZodOptional<z.ZodString>;
|
|
69
|
+
granularity: z.ZodDefault<z.ZodOptional<z.ZodEnum<["TOTAL", "DAY", "HOUR", "LIFETIME"]>>>;
|
|
70
|
+
dimensionType: z.ZodOptional<z.ZodEnum<["CAMPAIGN", "AD_SQUAD", "AD"]>>;
|
|
71
|
+
}, "strip", z.ZodTypeAny, {
|
|
72
|
+
adAccountId: string;
|
|
73
|
+
fields: string[];
|
|
74
|
+
granularity: "TOTAL" | "DAY" | "HOUR" | "LIFETIME";
|
|
75
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
76
|
+
startTime?: string | undefined;
|
|
77
|
+
endTime?: string | undefined;
|
|
78
|
+
dimensionType?: "CAMPAIGN" | "AD_SQUAD" | "AD" | undefined;
|
|
79
|
+
}, {
|
|
80
|
+
adAccountId: string;
|
|
81
|
+
fields: string[];
|
|
82
|
+
granularity?: "TOTAL" | "DAY" | "HOUR" | "LIFETIME" | undefined;
|
|
83
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
84
|
+
startTime?: string | undefined;
|
|
85
|
+
endTime?: string | undefined;
|
|
86
|
+
dimensionType?: "CAMPAIGN" | "AD_SQUAD" | "AD" | undefined;
|
|
87
|
+
}>, {
|
|
88
|
+
adAccountId: string;
|
|
89
|
+
fields: string[];
|
|
90
|
+
granularity: "TOTAL" | "DAY" | "HOUR" | "LIFETIME";
|
|
91
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
92
|
+
startTime?: string | undefined;
|
|
93
|
+
endTime?: string | undefined;
|
|
94
|
+
dimensionType?: "CAMPAIGN" | "AD_SQUAD" | "AD" | undefined;
|
|
95
|
+
}, {
|
|
96
|
+
adAccountId: string;
|
|
97
|
+
fields: string[];
|
|
98
|
+
granularity?: "TOTAL" | "DAY" | "HOUR" | "LIFETIME" | undefined;
|
|
99
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
100
|
+
startTime?: string | undefined;
|
|
101
|
+
endTime?: string | undefined;
|
|
102
|
+
dimensionType?: "CAMPAIGN" | "AD_SQUAD" | "AD" | undefined;
|
|
103
|
+
}>;
|
|
104
|
+
outputSchema: z.ZodObject<{
|
|
105
|
+
taskId: z.ZodString;
|
|
106
|
+
timestamp: z.ZodString;
|
|
107
|
+
}, "strip", z.ZodTypeAny, {
|
|
108
|
+
taskId: string;
|
|
109
|
+
timestamp: string;
|
|
110
|
+
}, {
|
|
111
|
+
taskId: string;
|
|
112
|
+
timestamp: string;
|
|
113
|
+
}>;
|
|
114
|
+
annotations: {
|
|
115
|
+
readOnlyHint: boolean;
|
|
116
|
+
openWorldHint: boolean;
|
|
117
|
+
destructiveHint: boolean;
|
|
118
|
+
idempotentHint: boolean;
|
|
119
|
+
};
|
|
120
|
+
inputExamples: {
|
|
121
|
+
label: string;
|
|
122
|
+
input: {
|
|
123
|
+
adAccountId: string;
|
|
124
|
+
fields: string[];
|
|
125
|
+
datePreset: string;
|
|
126
|
+
granularity: string;
|
|
127
|
+
dimensionType: string;
|
|
128
|
+
};
|
|
129
|
+
}[];
|
|
130
|
+
logic: typeof submitReportLogic;
|
|
131
|
+
responseFormatter: typeof submitReportResponseFormatter;
|
|
132
|
+
};
|
|
133
|
+
export {};
|
|
134
|
+
//# sourceMappingURL=submit-report.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"submit-report.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/submit-report.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;AAgBnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwC0B,CAAC;AAE/D,eAAO,MAAM,wBAAwB;;;;;;;;;EAKE,CAAC;AAExC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CA0B7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B5B,CAAC"}
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { resolveDatePreset, DATE_PRESET_VALUES } from "@cesteral/shared";
|
|
4
|
+
const TOOL_NAME = "snapchat_submit_report";
|
|
5
|
+
const TOOL_TITLE = "Submit Snapchat Report";
|
|
6
|
+
const TOOL_DESCRIPTION = `Submit a Snapchat Ads report task without waiting for completion.
|
|
7
|
+
|
|
8
|
+
Returns a \`taskId\` immediately. This is Snapchat's \`report_run_id\`.
|
|
9
|
+
Use \`snapchat_check_report_status\` to poll for completion, then \`snapchat_download_report\` to fetch results.
|
|
10
|
+
|
|
11
|
+
**Non-blocking workflow:**
|
|
12
|
+
1. \`snapchat_submit_report\` → get \`taskId\`
|
|
13
|
+
2. \`snapchat_check_report_status\` (repeat every 10s) → wait for "COMPLETE"
|
|
14
|
+
3. \`snapchat_download_report\` with the \`downloadUrl\` → get parsed data
|
|
15
|
+
|
|
16
|
+
Use \`snapchat_get_report\` instead for a blocking convenience shortcut.`;
|
|
17
|
+
export const SubmitReportInputSchema = z
|
|
18
|
+
.object({
|
|
19
|
+
adAccountId: z.string().min(1).describe("Snapchat Ad Account ID"),
|
|
20
|
+
fields: z
|
|
21
|
+
.array(z.string())
|
|
22
|
+
.min(1)
|
|
23
|
+
.describe("Metric fields to include (e.g. ['impressions', 'swipes', 'spend'])"),
|
|
24
|
+
datePreset: z
|
|
25
|
+
.enum(DATE_PRESET_VALUES)
|
|
26
|
+
.optional()
|
|
27
|
+
.describe("Preset date range. Use this OR startTime+endTime (not both). Converted to ISO 8601 timestamps automatically"),
|
|
28
|
+
startTime: z
|
|
29
|
+
.string()
|
|
30
|
+
.optional()
|
|
31
|
+
.describe("Start time in ISO 8601 format (e.g. 2024-01-01T00:00:00Z, required if datePreset not provided)"),
|
|
32
|
+
endTime: z
|
|
33
|
+
.string()
|
|
34
|
+
.optional()
|
|
35
|
+
.describe("End time in ISO 8601 format (e.g. 2024-01-31T23:59:59Z, required if datePreset not provided)"),
|
|
36
|
+
granularity: z
|
|
37
|
+
.enum(["TOTAL", "DAY", "HOUR", "LIFETIME"])
|
|
38
|
+
.optional()
|
|
39
|
+
.default("DAY")
|
|
40
|
+
.describe("Time granularity (default: DAY)"),
|
|
41
|
+
dimensionType: z
|
|
42
|
+
.enum(["CAMPAIGN", "AD_SQUAD", "AD"])
|
|
43
|
+
.optional()
|
|
44
|
+
.describe("Entity level for stats breakdown (default: account-level aggregate)"),
|
|
45
|
+
})
|
|
46
|
+
.refine((data) => data.datePreset !== undefined || (data.startTime !== undefined && data.endTime !== undefined), { message: "Provide either datePreset or both startTime and endTime" })
|
|
47
|
+
.describe("Parameters for submitting a Snapchat Ads report");
|
|
48
|
+
export const SubmitReportOutputSchema = z
|
|
49
|
+
.object({
|
|
50
|
+
taskId: z.string().describe("Report task ID for status polling"),
|
|
51
|
+
timestamp: z.string().datetime(),
|
|
52
|
+
})
|
|
53
|
+
.describe("Report submission result");
|
|
54
|
+
export async function submitReportLogic(input, context, sdkContext) {
|
|
55
|
+
const { snapchatReportingService } = resolveSessionServices(sdkContext);
|
|
56
|
+
let resolvedStartTime = input.startTime;
|
|
57
|
+
let resolvedEndTime = input.endTime;
|
|
58
|
+
if (input.datePreset) {
|
|
59
|
+
const { startDate, endDate } = resolveDatePreset(input.datePreset);
|
|
60
|
+
resolvedStartTime = `${startDate}T00:00:00Z`;
|
|
61
|
+
resolvedEndTime = `${endDate}T23:59:59Z`;
|
|
62
|
+
}
|
|
63
|
+
const result = await snapchatReportingService.submitReport({
|
|
64
|
+
fields: input.fields,
|
|
65
|
+
granularity: input.granularity,
|
|
66
|
+
start_time: resolvedStartTime,
|
|
67
|
+
end_time: resolvedEndTime,
|
|
68
|
+
...(input.dimensionType ? { dimension_type: input.dimensionType } : {}),
|
|
69
|
+
}, context);
|
|
70
|
+
return {
|
|
71
|
+
taskId: result.task_id,
|
|
72
|
+
timestamp: new Date().toISOString(),
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
export function submitReportResponseFormatter(result) {
|
|
76
|
+
return [
|
|
77
|
+
{
|
|
78
|
+
type: "text",
|
|
79
|
+
text: `Report submitted: ${result.taskId}\n\nUse \`snapchat_check_report_status\` with this taskId to poll for completion.\n\nTimestamp: ${result.timestamp}`,
|
|
80
|
+
},
|
|
81
|
+
];
|
|
82
|
+
}
|
|
83
|
+
export const submitReportTool = {
|
|
84
|
+
name: TOOL_NAME,
|
|
85
|
+
title: TOOL_TITLE,
|
|
86
|
+
description: TOOL_DESCRIPTION,
|
|
87
|
+
inputSchema: SubmitReportInputSchema,
|
|
88
|
+
outputSchema: SubmitReportOutputSchema,
|
|
89
|
+
annotations: {
|
|
90
|
+
readOnlyHint: false,
|
|
91
|
+
openWorldHint: false,
|
|
92
|
+
destructiveHint: false,
|
|
93
|
+
idempotentHint: false,
|
|
94
|
+
},
|
|
95
|
+
inputExamples: [
|
|
96
|
+
{
|
|
97
|
+
label: "Submit campaign performance report",
|
|
98
|
+
input: {
|
|
99
|
+
adAccountId: "1234567890",
|
|
100
|
+
fields: ["impressions", "swipes", "spend"],
|
|
101
|
+
datePreset: "LAST_7_DAYS",
|
|
102
|
+
granularity: "DAY",
|
|
103
|
+
dimensionType: "CAMPAIGN",
|
|
104
|
+
},
|
|
105
|
+
},
|
|
106
|
+
],
|
|
107
|
+
logic: submitReportLogic,
|
|
108
|
+
responseFormatter: submitReportResponseFormatter,
|
|
109
|
+
};
|
|
110
|
+
//# sourceMappingURL=submit-report.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"submit-report.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/submit-report.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "@cesteral/shared";
|
|
4
|
+
export declare const UpdateEntityInputSchema: z.ZodEffects<z.ZodObject<{
|
|
5
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
6
|
+
adAccountId: z.ZodString;
|
|
7
|
+
campaignId: z.ZodOptional<z.ZodString>;
|
|
8
|
+
adSquadId: z.ZodOptional<z.ZodString>;
|
|
9
|
+
entityId: z.ZodString;
|
|
10
|
+
data: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
11
|
+
}, "strip", z.ZodTypeAny, {
|
|
12
|
+
adAccountId: string;
|
|
13
|
+
entityId: string;
|
|
14
|
+
entityType: string;
|
|
15
|
+
data: Record<string, any>;
|
|
16
|
+
campaignId?: string | undefined;
|
|
17
|
+
adSquadId?: string | undefined;
|
|
18
|
+
}, {
|
|
19
|
+
adAccountId: string;
|
|
20
|
+
entityId: string;
|
|
21
|
+
entityType: string;
|
|
22
|
+
data: Record<string, any>;
|
|
23
|
+
campaignId?: string | undefined;
|
|
24
|
+
adSquadId?: string | undefined;
|
|
25
|
+
}>, {
|
|
26
|
+
adAccountId: string;
|
|
27
|
+
entityId: string;
|
|
28
|
+
entityType: string;
|
|
29
|
+
data: Record<string, any>;
|
|
30
|
+
campaignId?: string | undefined;
|
|
31
|
+
adSquadId?: string | undefined;
|
|
32
|
+
}, {
|
|
33
|
+
adAccountId: string;
|
|
34
|
+
entityId: string;
|
|
35
|
+
entityType: string;
|
|
36
|
+
data: Record<string, any>;
|
|
37
|
+
campaignId?: string | undefined;
|
|
38
|
+
adSquadId?: string | undefined;
|
|
39
|
+
}>;
|
|
40
|
+
export declare const UpdateEntityOutputSchema: z.ZodObject<{
|
|
41
|
+
entityId: z.ZodString;
|
|
42
|
+
entityType: z.ZodString;
|
|
43
|
+
updated: z.ZodBoolean;
|
|
44
|
+
timestamp: z.ZodString;
|
|
45
|
+
}, "strip", z.ZodTypeAny, {
|
|
46
|
+
entityId: string;
|
|
47
|
+
entityType: string;
|
|
48
|
+
timestamp: string;
|
|
49
|
+
updated: boolean;
|
|
50
|
+
}, {
|
|
51
|
+
entityId: string;
|
|
52
|
+
entityType: string;
|
|
53
|
+
timestamp: string;
|
|
54
|
+
updated: boolean;
|
|
55
|
+
}>;
|
|
56
|
+
type UpdateEntityInput = z.infer<typeof UpdateEntityInputSchema>;
|
|
57
|
+
type UpdateEntityOutput = z.infer<typeof UpdateEntityOutputSchema>;
|
|
58
|
+
export declare function updateEntityLogic(input: UpdateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<UpdateEntityOutput>;
|
|
59
|
+
export declare function updateEntityResponseFormatter(result: UpdateEntityOutput): McpTextContent[];
|
|
60
|
+
export declare const updateEntityTool: {
|
|
61
|
+
name: string;
|
|
62
|
+
title: string;
|
|
63
|
+
description: string;
|
|
64
|
+
inputSchema: z.ZodEffects<z.ZodObject<{
|
|
65
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
66
|
+
adAccountId: z.ZodString;
|
|
67
|
+
campaignId: z.ZodOptional<z.ZodString>;
|
|
68
|
+
adSquadId: z.ZodOptional<z.ZodString>;
|
|
69
|
+
entityId: z.ZodString;
|
|
70
|
+
data: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
71
|
+
}, "strip", z.ZodTypeAny, {
|
|
72
|
+
adAccountId: string;
|
|
73
|
+
entityId: string;
|
|
74
|
+
entityType: string;
|
|
75
|
+
data: Record<string, any>;
|
|
76
|
+
campaignId?: string | undefined;
|
|
77
|
+
adSquadId?: string | undefined;
|
|
78
|
+
}, {
|
|
79
|
+
adAccountId: string;
|
|
80
|
+
entityId: string;
|
|
81
|
+
entityType: string;
|
|
82
|
+
data: Record<string, any>;
|
|
83
|
+
campaignId?: string | undefined;
|
|
84
|
+
adSquadId?: string | undefined;
|
|
85
|
+
}>, {
|
|
86
|
+
adAccountId: string;
|
|
87
|
+
entityId: string;
|
|
88
|
+
entityType: string;
|
|
89
|
+
data: Record<string, any>;
|
|
90
|
+
campaignId?: string | undefined;
|
|
91
|
+
adSquadId?: string | undefined;
|
|
92
|
+
}, {
|
|
93
|
+
adAccountId: string;
|
|
94
|
+
entityId: string;
|
|
95
|
+
entityType: string;
|
|
96
|
+
data: Record<string, any>;
|
|
97
|
+
campaignId?: string | undefined;
|
|
98
|
+
adSquadId?: string | undefined;
|
|
99
|
+
}>;
|
|
100
|
+
outputSchema: z.ZodObject<{
|
|
101
|
+
entityId: z.ZodString;
|
|
102
|
+
entityType: z.ZodString;
|
|
103
|
+
updated: z.ZodBoolean;
|
|
104
|
+
timestamp: z.ZodString;
|
|
105
|
+
}, "strip", z.ZodTypeAny, {
|
|
106
|
+
entityId: string;
|
|
107
|
+
entityType: string;
|
|
108
|
+
timestamp: string;
|
|
109
|
+
updated: boolean;
|
|
110
|
+
}, {
|
|
111
|
+
entityId: string;
|
|
112
|
+
entityType: string;
|
|
113
|
+
timestamp: string;
|
|
114
|
+
updated: boolean;
|
|
115
|
+
}>;
|
|
116
|
+
annotations: {
|
|
117
|
+
readOnlyHint: boolean;
|
|
118
|
+
openWorldHint: boolean;
|
|
119
|
+
idempotentHint: boolean;
|
|
120
|
+
destructiveHint: boolean;
|
|
121
|
+
};
|
|
122
|
+
inputExamples: ({
|
|
123
|
+
label: string;
|
|
124
|
+
input: {
|
|
125
|
+
entityType: string;
|
|
126
|
+
adAccountId: string;
|
|
127
|
+
entityId: string;
|
|
128
|
+
data: {
|
|
129
|
+
name: string;
|
|
130
|
+
daily_budget_micro: number;
|
|
131
|
+
bid_micro?: undefined;
|
|
132
|
+
status?: undefined;
|
|
133
|
+
};
|
|
134
|
+
campaignId?: undefined;
|
|
135
|
+
};
|
|
136
|
+
} | {
|
|
137
|
+
label: string;
|
|
138
|
+
input: {
|
|
139
|
+
entityType: string;
|
|
140
|
+
adAccountId: string;
|
|
141
|
+
campaignId: string;
|
|
142
|
+
entityId: string;
|
|
143
|
+
data: {
|
|
144
|
+
bid_micro: number;
|
|
145
|
+
status: string;
|
|
146
|
+
name?: undefined;
|
|
147
|
+
daily_budget_micro?: undefined;
|
|
148
|
+
};
|
|
149
|
+
};
|
|
150
|
+
})[];
|
|
151
|
+
logic: typeof updateEntityLogic;
|
|
152
|
+
responseFormatter: typeof updateEntityResponseFormatter;
|
|
153
|
+
};
|
|
154
|
+
export {};
|
|
155
|
+
//# sourceMappingURL=update-entity.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"update-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-entity.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;AAgBnD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBwB,CAAC;AAE7D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAOF,CAAC;AAEpC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAqB7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC5B,CAAC"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { getEntityTypeEnum } from "../utils/entity-mapping.js";
|
|
4
|
+
const TOOL_NAME = "snapchat_update_entity";
|
|
5
|
+
const TOOL_TITLE = "Update Snapchat Ads Entity";
|
|
6
|
+
const TOOL_DESCRIPTION = `Update a Snapchat Ads entity.
|
|
7
|
+
|
|
8
|
+
**Supported entity types:** ${getEntityTypeEnum().join(", ")}
|
|
9
|
+
|
|
10
|
+
Snapchat requires full-object PUT updates on the parent-scoped collection route.
|
|
11
|
+
This tool fetches the current entity, merges your changes, and sends the full payload.
|
|
12
|
+
|
|
13
|
+
**Gotchas:**
|
|
14
|
+
- Use \`snapchat_bulk_update_status\` for status-only changes
|
|
15
|
+
- \`campaignId\` is required for adGroup updates
|
|
16
|
+
- \`adSquadId\` is required for ad updates`;
|
|
17
|
+
export const UpdateEntityInputSchema = z
|
|
18
|
+
.object({
|
|
19
|
+
entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to update"),
|
|
20
|
+
adAccountId: z.string().min(1).describe("Snapchat Advertiser ID"),
|
|
21
|
+
campaignId: z.string().optional().describe("Campaign ID required when entityType is 'adGroup'"),
|
|
22
|
+
adSquadId: z.string().optional().describe("Ad Squad ID required when entityType is 'ad'"),
|
|
23
|
+
entityId: z.string().min(1).describe("The entity ID to update"),
|
|
24
|
+
data: z.record(z.any()).describe("Fields to update as key-value pairs"),
|
|
25
|
+
})
|
|
26
|
+
.superRefine((data, ctx) => {
|
|
27
|
+
if (data.entityType === "adGroup" && !data.campaignId) {
|
|
28
|
+
ctx.addIssue({
|
|
29
|
+
code: z.ZodIssueCode.custom,
|
|
30
|
+
path: ["campaignId"],
|
|
31
|
+
message: "campaignId is required for adGroup updates",
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
if (data.entityType === "ad" && !data.adSquadId) {
|
|
35
|
+
ctx.addIssue({
|
|
36
|
+
code: z.ZodIssueCode.custom,
|
|
37
|
+
path: ["adSquadId"],
|
|
38
|
+
message: "adSquadId is required for ad updates",
|
|
39
|
+
});
|
|
40
|
+
}
|
|
41
|
+
})
|
|
42
|
+
.describe("Parameters for updating a Snapchat Ads entity");
|
|
43
|
+
export const UpdateEntityOutputSchema = z
|
|
44
|
+
.object({
|
|
45
|
+
entityId: z.string(),
|
|
46
|
+
entityType: z.string(),
|
|
47
|
+
updated: z.boolean(),
|
|
48
|
+
timestamp: z.string().datetime(),
|
|
49
|
+
})
|
|
50
|
+
.describe("Entity update result");
|
|
51
|
+
export async function updateEntityLogic(input, context, sdkContext) {
|
|
52
|
+
const { snapchatService } = resolveSessionServices(sdkContext);
|
|
53
|
+
await snapchatService.updateEntity(input.entityType, input.entityId, {
|
|
54
|
+
adAccountId: input.adAccountId,
|
|
55
|
+
...(input.campaignId ? { campaignId: input.campaignId } : {}),
|
|
56
|
+
...(input.adSquadId ? { adSquadId: input.adSquadId } : {}),
|
|
57
|
+
}, input.data, context);
|
|
58
|
+
return {
|
|
59
|
+
entityId: input.entityId,
|
|
60
|
+
entityType: input.entityType,
|
|
61
|
+
updated: true,
|
|
62
|
+
timestamp: new Date().toISOString(),
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
export function updateEntityResponseFormatter(result) {
|
|
66
|
+
return [
|
|
67
|
+
{
|
|
68
|
+
type: "text",
|
|
69
|
+
text: `${result.entityType} ${result.entityId} updated successfully\n\nTimestamp: ${result.timestamp}`,
|
|
70
|
+
},
|
|
71
|
+
];
|
|
72
|
+
}
|
|
73
|
+
export const updateEntityTool = {
|
|
74
|
+
name: TOOL_NAME,
|
|
75
|
+
title: TOOL_TITLE,
|
|
76
|
+
description: TOOL_DESCRIPTION,
|
|
77
|
+
inputSchema: UpdateEntityInputSchema,
|
|
78
|
+
outputSchema: UpdateEntityOutputSchema,
|
|
79
|
+
annotations: {
|
|
80
|
+
readOnlyHint: false,
|
|
81
|
+
openWorldHint: false,
|
|
82
|
+
idempotentHint: true,
|
|
83
|
+
destructiveHint: false,
|
|
84
|
+
},
|
|
85
|
+
inputExamples: [
|
|
86
|
+
{
|
|
87
|
+
label: "Update campaign name and budget",
|
|
88
|
+
input: {
|
|
89
|
+
entityType: "campaign",
|
|
90
|
+
adAccountId: "1234567890",
|
|
91
|
+
entityId: "1800123456789",
|
|
92
|
+
data: {
|
|
93
|
+
name: "Updated Campaign Name",
|
|
94
|
+
daily_budget_micro: 200000000,
|
|
95
|
+
},
|
|
96
|
+
},
|
|
97
|
+
},
|
|
98
|
+
{
|
|
99
|
+
label: "Update ad group bid",
|
|
100
|
+
input: {
|
|
101
|
+
entityType: "adGroup",
|
|
102
|
+
adAccountId: "1234567890",
|
|
103
|
+
campaignId: "1800123400000",
|
|
104
|
+
entityId: "1700123456789",
|
|
105
|
+
data: {
|
|
106
|
+
bid_micro: 1500000,
|
|
107
|
+
status: "PAUSED",
|
|
108
|
+
},
|
|
109
|
+
},
|
|
110
|
+
},
|
|
111
|
+
],
|
|
112
|
+
logic: updateEntityLogic,
|
|
113
|
+
responseFormatter: updateEntityResponseFormatter,
|
|
114
|
+
};
|
|
115
|
+
//# sourceMappingURL=update-entity.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"update-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/update-entity.tool.ts"],"names":[],"mappings":"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"}
|