@cesteral/msads-mcp 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.md +201 -0
- package/README.md +179 -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/msads-auth-adapter.d.ts +27 -0
- package/dist/auth/msads-auth-adapter.d.ts.map +1 -0
- package/dist/auth/msads-auth-adapter.js +79 -0
- package/dist/auth/msads-auth-adapter.js.map +1 -0
- package/dist/auth/msads-auth-strategy.d.ts +8 -0
- package/dist/auth/msads-auth-strategy.d.ts.map +1 -0
- package/dist/auth/msads-auth-strategy.js +36 -0
- package/dist/auth/msads-auth-strategy.js.map +1 -0
- package/dist/config/index.d.ts +112 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +56 -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 +47 -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 +54 -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 +147 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +73 -0
- package/dist/mcp-server/prompts/definitions/google-import-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 +55 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.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 +47 -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 +49 -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 +84 -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 +54 -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 +54 -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/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 +79 -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 +64 -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/resources/utils/field-rules.d.ts +9 -0
- package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -0
- package/dist/mcp-server/resources/utils/field-rules.js +106 -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 +142 -0
- package/dist/mcp-server/server.js.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +175 -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 +124 -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 +83 -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 +68 -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 +95 -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 +102 -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 +151 -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 +111 -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 +73 -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 +81 -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 +74 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +160 -0
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +108 -0
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +98 -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 +94 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +79 -0
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +88 -0
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +287 -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 +85 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +68 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +85 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.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 +90 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +285 -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 +120 -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 +280 -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 +138 -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 +260 -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 +118 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +79 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js +88 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +3 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/index.js +53 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +135 -0
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js +88 -0
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +120 -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 +100 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +47 -0
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +57 -0
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +81 -0
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +81 -0
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +90 -0
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +92 -0
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +79 -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 +105 -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 +132 -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 +94 -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 +79 -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 +64 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +174 -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 +142 -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 +20 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js +118 -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 +55 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.js +86 -0
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
- package/dist/services/msads/msads-http-client.d.ts +16 -0
- package/dist/services/msads/msads-http-client.d.ts.map +1 -0
- package/dist/services/msads/msads-http-client.js +89 -0
- package/dist/services/msads/msads-http-client.js.map +1 -0
- package/dist/services/msads/msads-reporting-service.d.ts +58 -0
- package/dist/services/msads/msads-reporting-service.d.ts.map +1 -0
- package/dist/services/msads/msads-reporting-service.js +153 -0
- package/dist/services/msads/msads-reporting-service.js.map +1 -0
- package/dist/services/msads/msads-service.d.ts +54 -0
- package/dist/services/msads/msads-service.d.ts.map +1 -0
- package/dist/services/msads/msads-service.js +179 -0
- package/dist/services/msads/msads-service.js.map +1 -0
- package/dist/services/msads/rate-limit-keys.d.ts +3 -0
- package/dist/services/msads/rate-limit-keys.d.ts.map +1 -0
- package/dist/services/msads/rate-limit-keys.js +3 -0
- package/dist/services/msads/rate-limit-keys.js.map +1 -0
- package/dist/services/msads/types.d.ts +196 -0
- package/dist/services/msads/types.d.ts.map +1 -0
- package/dist/services/msads/types.js +47 -0
- package/dist/services/msads/types.js.map +1 -0
- package/dist/services/session-services.d.ts +22 -0
- package/dist/services/session-services.d.ts.map +1 -0
- package/dist/services/session-services.js +22 -0
- package/dist/services/session-services.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 +56 -0
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
|
|
4
|
+
const TOOL_NAME = "msads_manage_ad_extensions";
|
|
5
|
+
const TOOL_TITLE = "Manage Microsoft Ads Ad Extensions";
|
|
6
|
+
const TOOL_DESCRIPTION = `Manage ad extensions in Microsoft Advertising — associate/disassociate extensions with campaigns or ad groups.
|
|
7
|
+
|
|
8
|
+
Operations:
|
|
9
|
+
- setAssociations: Link ad extensions to campaigns or ad groups
|
|
10
|
+
- deleteAssociations: Remove ad extension associations
|
|
11
|
+
- getAssociations: Query ad extension associations for campaigns or ad groups`;
|
|
12
|
+
export const ManageAdExtensionsInputSchema = z
|
|
13
|
+
.object({
|
|
14
|
+
operation: z
|
|
15
|
+
.enum(["setAssociations", "deleteAssociations", "getAssociations"])
|
|
16
|
+
.describe("Operation to perform"),
|
|
17
|
+
data: z.record(z.unknown()).describe("Operation data (varies by operation)"),
|
|
18
|
+
})
|
|
19
|
+
.describe("Parameters for managing ad extensions");
|
|
20
|
+
export const ManageAdExtensionsOutputSchema = z
|
|
21
|
+
.object({
|
|
22
|
+
result: z.record(z.any()),
|
|
23
|
+
operation: z.string(),
|
|
24
|
+
timestamp: z.string().datetime(),
|
|
25
|
+
})
|
|
26
|
+
.describe("Ad extension management result");
|
|
27
|
+
const OPERATION_PATHS = {
|
|
28
|
+
setAssociations: { path: "/AdExtensionsAssociations", method: "POST" },
|
|
29
|
+
deleteAssociations: { path: "/AdExtensionsAssociations", method: "DELETE" },
|
|
30
|
+
getAssociations: { path: "/AdExtensionsAssociations/Query", method: "POST" },
|
|
31
|
+
};
|
|
32
|
+
export async function manageAdExtensionsLogic(input, context, sdkContext) {
|
|
33
|
+
const { msadsService } = resolveSessionServices(sdkContext);
|
|
34
|
+
const op = OPERATION_PATHS[input.operation];
|
|
35
|
+
if (!op) {
|
|
36
|
+
throw new McpError(JsonRpcErrorCode.InvalidParams, `Unknown ad extension operation: ${input.operation}`);
|
|
37
|
+
}
|
|
38
|
+
const result = (await msadsService.executeOperation(op.path, input.data, context, op.method));
|
|
39
|
+
return {
|
|
40
|
+
result,
|
|
41
|
+
operation: input.operation,
|
|
42
|
+
timestamp: new Date().toISOString(),
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
export function manageAdExtensionsResponseFormatter(result) {
|
|
46
|
+
return [
|
|
47
|
+
{
|
|
48
|
+
type: "text",
|
|
49
|
+
text: `Ad extension ${result.operation} completed\n\nResult:\n${JSON.stringify(result.result, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
50
|
+
},
|
|
51
|
+
];
|
|
52
|
+
}
|
|
53
|
+
export const manageAdExtensionsTool = {
|
|
54
|
+
name: TOOL_NAME,
|
|
55
|
+
title: TOOL_TITLE,
|
|
56
|
+
description: TOOL_DESCRIPTION,
|
|
57
|
+
inputSchema: ManageAdExtensionsInputSchema,
|
|
58
|
+
outputSchema: ManageAdExtensionsOutputSchema,
|
|
59
|
+
annotations: {
|
|
60
|
+
readOnlyHint: false,
|
|
61
|
+
openWorldHint: false,
|
|
62
|
+
idempotentHint: false,
|
|
63
|
+
destructiveHint: true,
|
|
64
|
+
},
|
|
65
|
+
inputExamples: [
|
|
66
|
+
{
|
|
67
|
+
label: "Associate sitelink extensions with a campaign",
|
|
68
|
+
input: {
|
|
69
|
+
operation: "setAssociations",
|
|
70
|
+
data: {
|
|
71
|
+
AccountId: 123456,
|
|
72
|
+
AdExtensionIdToEntityIdAssociations: [{ AdExtensionId: 111, EntityId: 222 }],
|
|
73
|
+
AssociationType: "Campaign",
|
|
74
|
+
},
|
|
75
|
+
},
|
|
76
|
+
},
|
|
77
|
+
],
|
|
78
|
+
logic: manageAdExtensionsLogic,
|
|
79
|
+
responseFormatter: manageAdExtensionsResponseFormatter,
|
|
80
|
+
};
|
|
81
|
+
//# sourceMappingURL=manage-ad-extensions.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"manage-ad-extensions.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/manage-ad-extensions.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
|
|
3
|
+
export declare const ManageCriterionsInputSchema: z.ZodObject<{
|
|
4
|
+
operation: z.ZodEnum<["add", "update", "delete", "getByCampaign", "getByAdGroup"]>;
|
|
5
|
+
entityLevel: z.ZodEnum<["campaign", "adGroup"]>;
|
|
6
|
+
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
7
|
+
}, "strip", z.ZodTypeAny, {
|
|
8
|
+
data: Record<string, unknown>;
|
|
9
|
+
operation: "add" | "update" | "delete" | "getByCampaign" | "getByAdGroup";
|
|
10
|
+
entityLevel: "campaign" | "adGroup";
|
|
11
|
+
}, {
|
|
12
|
+
data: Record<string, unknown>;
|
|
13
|
+
operation: "add" | "update" | "delete" | "getByCampaign" | "getByAdGroup";
|
|
14
|
+
entityLevel: "campaign" | "adGroup";
|
|
15
|
+
}>;
|
|
16
|
+
export declare const ManageCriterionsOutputSchema: z.ZodObject<{
|
|
17
|
+
result: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
18
|
+
operation: z.ZodString;
|
|
19
|
+
entityLevel: z.ZodString;
|
|
20
|
+
timestamp: z.ZodString;
|
|
21
|
+
}, "strip", z.ZodTypeAny, {
|
|
22
|
+
timestamp: string;
|
|
23
|
+
result: Record<string, any>;
|
|
24
|
+
operation: string;
|
|
25
|
+
entityLevel: string;
|
|
26
|
+
}, {
|
|
27
|
+
timestamp: string;
|
|
28
|
+
result: Record<string, any>;
|
|
29
|
+
operation: string;
|
|
30
|
+
entityLevel: string;
|
|
31
|
+
}>;
|
|
32
|
+
type ManageCriterionsInput = z.infer<typeof ManageCriterionsInputSchema>;
|
|
33
|
+
type ManageCriterionsOutput = z.infer<typeof ManageCriterionsOutputSchema>;
|
|
34
|
+
export declare function manageCriterionsLogic(input: ManageCriterionsInput, context: RequestContext, sdkContext?: SdkContext): Promise<ManageCriterionsOutput>;
|
|
35
|
+
export declare function manageCriterionsResponseFormatter(result: ManageCriterionsOutput): McpTextContent[];
|
|
36
|
+
export declare const manageCriterionsTool: {
|
|
37
|
+
name: string;
|
|
38
|
+
title: string;
|
|
39
|
+
description: string;
|
|
40
|
+
inputSchema: z.ZodObject<{
|
|
41
|
+
operation: z.ZodEnum<["add", "update", "delete", "getByCampaign", "getByAdGroup"]>;
|
|
42
|
+
entityLevel: z.ZodEnum<["campaign", "adGroup"]>;
|
|
43
|
+
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
44
|
+
}, "strip", z.ZodTypeAny, {
|
|
45
|
+
data: Record<string, unknown>;
|
|
46
|
+
operation: "add" | "update" | "delete" | "getByCampaign" | "getByAdGroup";
|
|
47
|
+
entityLevel: "campaign" | "adGroup";
|
|
48
|
+
}, {
|
|
49
|
+
data: Record<string, unknown>;
|
|
50
|
+
operation: "add" | "update" | "delete" | "getByCampaign" | "getByAdGroup";
|
|
51
|
+
entityLevel: "campaign" | "adGroup";
|
|
52
|
+
}>;
|
|
53
|
+
outputSchema: z.ZodObject<{
|
|
54
|
+
result: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
55
|
+
operation: z.ZodString;
|
|
56
|
+
entityLevel: z.ZodString;
|
|
57
|
+
timestamp: z.ZodString;
|
|
58
|
+
}, "strip", z.ZodTypeAny, {
|
|
59
|
+
timestamp: string;
|
|
60
|
+
result: Record<string, any>;
|
|
61
|
+
operation: string;
|
|
62
|
+
entityLevel: string;
|
|
63
|
+
}, {
|
|
64
|
+
timestamp: string;
|
|
65
|
+
result: Record<string, any>;
|
|
66
|
+
operation: string;
|
|
67
|
+
entityLevel: string;
|
|
68
|
+
}>;
|
|
69
|
+
annotations: {
|
|
70
|
+
readOnlyHint: boolean;
|
|
71
|
+
openWorldHint: boolean;
|
|
72
|
+
idempotentHint: boolean;
|
|
73
|
+
destructiveHint: boolean;
|
|
74
|
+
};
|
|
75
|
+
inputExamples: {
|
|
76
|
+
label: string;
|
|
77
|
+
input: {
|
|
78
|
+
operation: string;
|
|
79
|
+
entityLevel: string;
|
|
80
|
+
data: {
|
|
81
|
+
CampaignId: number;
|
|
82
|
+
CriterionType: string;
|
|
83
|
+
};
|
|
84
|
+
};
|
|
85
|
+
}[];
|
|
86
|
+
logic: typeof manageCriterionsLogic;
|
|
87
|
+
responseFormatter: typeof manageCriterionsResponseFormatter;
|
|
88
|
+
};
|
|
89
|
+
export {};
|
|
90
|
+
//# sourceMappingURL=manage-criterions.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"manage-criterions.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/manage-criterions.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAanF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;EAUmB,CAAC;AAE5D,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;EAOC,CAAC;AAE3C,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AACzE,KAAK,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAqB3E,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,sBAAsB,CAAC,CAkBjC;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,sBAAsB,GAC7B,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBhC,CAAC"}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
|
|
4
|
+
const TOOL_NAME = "msads_manage_criterions";
|
|
5
|
+
const TOOL_TITLE = "Manage Microsoft Ads Targeting Criterions";
|
|
6
|
+
const TOOL_DESCRIPTION = `Manage targeting criterions for Microsoft Advertising campaigns and ad groups.
|
|
7
|
+
|
|
8
|
+
Operations:
|
|
9
|
+
- add: Add targeting criterions (location, age, gender, device, etc.)
|
|
10
|
+
- update: Update existing criterions (e.g., bid adjustments)
|
|
11
|
+
- delete: Remove criterions
|
|
12
|
+
- getByCampaign: Get criterions for a campaign
|
|
13
|
+
- getByAdGroup: Get criterions for an ad group`;
|
|
14
|
+
export const ManageCriterionsInputSchema = z
|
|
15
|
+
.object({
|
|
16
|
+
operation: z
|
|
17
|
+
.enum(["add", "update", "delete", "getByCampaign", "getByAdGroup"])
|
|
18
|
+
.describe("Operation to perform"),
|
|
19
|
+
entityLevel: z
|
|
20
|
+
.enum(["campaign", "adGroup"])
|
|
21
|
+
.describe("Whether targeting is at campaign or ad group level"),
|
|
22
|
+
data: z.record(z.unknown()).describe("Operation data (varies by operation)"),
|
|
23
|
+
})
|
|
24
|
+
.describe("Parameters for managing targeting criterions");
|
|
25
|
+
export const ManageCriterionsOutputSchema = z
|
|
26
|
+
.object({
|
|
27
|
+
result: z.record(z.any()),
|
|
28
|
+
operation: z.string(),
|
|
29
|
+
entityLevel: z.string(),
|
|
30
|
+
timestamp: z.string().datetime(),
|
|
31
|
+
})
|
|
32
|
+
.describe("Criterion management result");
|
|
33
|
+
function getOperation(operation, entityLevel) {
|
|
34
|
+
const level = entityLevel === "campaign" ? "Campaign" : "AdGroup";
|
|
35
|
+
const ops = {
|
|
36
|
+
add: { path: `/${level}Criterions`, method: "POST" },
|
|
37
|
+
update: { path: `/${level}Criterions`, method: "PUT" },
|
|
38
|
+
delete: { path: `/${level}Criterions`, method: "DELETE" },
|
|
39
|
+
getByCampaign: { path: "/CampaignCriterions/QueryByIds", method: "POST" },
|
|
40
|
+
getByAdGroup: { path: "/AdGroupCriterions/QueryByIds", method: "POST" },
|
|
41
|
+
};
|
|
42
|
+
const op = ops[operation];
|
|
43
|
+
if (!op) {
|
|
44
|
+
throw new McpError(JsonRpcErrorCode.InvalidParams, `Unknown criterion operation: ${operation}`);
|
|
45
|
+
}
|
|
46
|
+
return op;
|
|
47
|
+
}
|
|
48
|
+
export async function manageCriterionsLogic(input, context, sdkContext) {
|
|
49
|
+
const { msadsService } = resolveSessionServices(sdkContext);
|
|
50
|
+
const op = getOperation(input.operation, input.entityLevel);
|
|
51
|
+
const result = (await msadsService.executeOperation(op.path, input.data, context, op.method));
|
|
52
|
+
return {
|
|
53
|
+
result,
|
|
54
|
+
operation: input.operation,
|
|
55
|
+
entityLevel: input.entityLevel,
|
|
56
|
+
timestamp: new Date().toISOString(),
|
|
57
|
+
};
|
|
58
|
+
}
|
|
59
|
+
export function manageCriterionsResponseFormatter(result) {
|
|
60
|
+
return [
|
|
61
|
+
{
|
|
62
|
+
type: "text",
|
|
63
|
+
text: `${result.entityLevel} criterion ${result.operation} completed\n\nResult:\n${JSON.stringify(result.result, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
64
|
+
},
|
|
65
|
+
];
|
|
66
|
+
}
|
|
67
|
+
export const manageCriterionsTool = {
|
|
68
|
+
name: TOOL_NAME,
|
|
69
|
+
title: TOOL_TITLE,
|
|
70
|
+
description: TOOL_DESCRIPTION,
|
|
71
|
+
inputSchema: ManageCriterionsInputSchema,
|
|
72
|
+
outputSchema: ManageCriterionsOutputSchema,
|
|
73
|
+
annotations: {
|
|
74
|
+
readOnlyHint: false,
|
|
75
|
+
openWorldHint: false,
|
|
76
|
+
idempotentHint: false,
|
|
77
|
+
destructiveHint: true,
|
|
78
|
+
},
|
|
79
|
+
inputExamples: [
|
|
80
|
+
{
|
|
81
|
+
label: "Get campaign targeting criterions",
|
|
82
|
+
input: {
|
|
83
|
+
operation: "getByCampaign",
|
|
84
|
+
entityLevel: "campaign",
|
|
85
|
+
data: { CampaignId: 123456, CriterionType: "Targets" },
|
|
86
|
+
},
|
|
87
|
+
},
|
|
88
|
+
],
|
|
89
|
+
logic: manageCriterionsLogic,
|
|
90
|
+
responseFormatter: manageCriterionsResponseFormatter,
|
|
91
|
+
};
|
|
92
|
+
//# sourceMappingURL=manage-criterions.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"manage-criterions.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/manage-criterions.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
|
|
3
|
+
export declare const SearchTargetingInputSchema: z.ZodObject<{
|
|
4
|
+
targetingType: z.ZodEnum<["age", "gender", "device"]>;
|
|
5
|
+
maxResults: z.ZodDefault<z.ZodNumber>;
|
|
6
|
+
}, "strip", z.ZodTypeAny, {
|
|
7
|
+
targetingType: "age" | "gender" | "device";
|
|
8
|
+
maxResults: number;
|
|
9
|
+
}, {
|
|
10
|
+
targetingType: "age" | "gender" | "device";
|
|
11
|
+
maxResults?: number | undefined;
|
|
12
|
+
}>;
|
|
13
|
+
export declare const SearchTargetingOutputSchema: z.ZodObject<{
|
|
14
|
+
targetingType: z.ZodString;
|
|
15
|
+
results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
|
|
16
|
+
totalResults: z.ZodNumber;
|
|
17
|
+
timestamp: z.ZodString;
|
|
18
|
+
}, "strip", z.ZodTypeAny, {
|
|
19
|
+
results: Record<string, any>[];
|
|
20
|
+
timestamp: string;
|
|
21
|
+
targetingType: string;
|
|
22
|
+
totalResults: number;
|
|
23
|
+
}, {
|
|
24
|
+
results: Record<string, any>[];
|
|
25
|
+
timestamp: string;
|
|
26
|
+
targetingType: string;
|
|
27
|
+
totalResults: number;
|
|
28
|
+
}>;
|
|
29
|
+
type SearchTargetingInput = z.infer<typeof SearchTargetingInputSchema>;
|
|
30
|
+
type SearchTargetingOutput = z.infer<typeof SearchTargetingOutputSchema>;
|
|
31
|
+
export declare function searchTargetingLogic(input: SearchTargetingInput, _context: RequestContext, _sdkContext?: SdkContext): Promise<SearchTargetingOutput>;
|
|
32
|
+
export declare function searchTargetingResponseFormatter(result: SearchTargetingOutput): McpTextContent[];
|
|
33
|
+
export declare const searchTargetingTool: {
|
|
34
|
+
name: string;
|
|
35
|
+
title: string;
|
|
36
|
+
description: string;
|
|
37
|
+
inputSchema: z.ZodObject<{
|
|
38
|
+
targetingType: z.ZodEnum<["age", "gender", "device"]>;
|
|
39
|
+
maxResults: z.ZodDefault<z.ZodNumber>;
|
|
40
|
+
}, "strip", z.ZodTypeAny, {
|
|
41
|
+
targetingType: "age" | "gender" | "device";
|
|
42
|
+
maxResults: number;
|
|
43
|
+
}, {
|
|
44
|
+
targetingType: "age" | "gender" | "device";
|
|
45
|
+
maxResults?: number | undefined;
|
|
46
|
+
}>;
|
|
47
|
+
outputSchema: z.ZodObject<{
|
|
48
|
+
targetingType: z.ZodString;
|
|
49
|
+
results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
|
|
50
|
+
totalResults: z.ZodNumber;
|
|
51
|
+
timestamp: z.ZodString;
|
|
52
|
+
}, "strip", z.ZodTypeAny, {
|
|
53
|
+
results: Record<string, any>[];
|
|
54
|
+
timestamp: string;
|
|
55
|
+
targetingType: string;
|
|
56
|
+
totalResults: number;
|
|
57
|
+
}, {
|
|
58
|
+
results: Record<string, any>[];
|
|
59
|
+
timestamp: string;
|
|
60
|
+
targetingType: string;
|
|
61
|
+
totalResults: number;
|
|
62
|
+
}>;
|
|
63
|
+
annotations: {
|
|
64
|
+
readOnlyHint: boolean;
|
|
65
|
+
openWorldHint: boolean;
|
|
66
|
+
idempotentHint: boolean;
|
|
67
|
+
destructiveHint: boolean;
|
|
68
|
+
};
|
|
69
|
+
inputExamples: {
|
|
70
|
+
label: string;
|
|
71
|
+
input: {
|
|
72
|
+
targetingType: string;
|
|
73
|
+
};
|
|
74
|
+
}[];
|
|
75
|
+
logic: typeof searchTargetingLogic;
|
|
76
|
+
responseFormatter: typeof searchTargetingResponseFormatter;
|
|
77
|
+
};
|
|
78
|
+
export {};
|
|
79
|
+
//# sourceMappingURL=search-targeting.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"search-targeting.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-targeting.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAcnF,eAAO,MAAM,0BAA0B;;;;;;;;;EAWgB,CAAC;AAExD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAOD,CAAC;AAExC,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AACvE,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAqBzE,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,UAAU,GACvB,OAAO,CAAC,qBAAqB,CAAC,CA0BhC;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,EAAE,CAQhG;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwB/B,CAAC"}
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
|
|
3
|
+
const TOOL_NAME = "msads_search_targeting";
|
|
4
|
+
const TOOL_TITLE = "List Microsoft Ads Targeting Options";
|
|
5
|
+
const TOOL_DESCRIPTION = `List the enumerated targeting option values supported by Microsoft Advertising.
|
|
6
|
+
|
|
7
|
+
Supported targeting types:
|
|
8
|
+
- age: List available age range targets
|
|
9
|
+
- gender: List available gender targets
|
|
10
|
+
- device: List available device targets
|
|
11
|
+
|
|
12
|
+
Note: location targets are not searchable via the Microsoft Advertising REST API. Use the Campaign Management GetGeoLocationsFileUrl operation to download the full geo-location reference file.`;
|
|
13
|
+
export const SearchTargetingInputSchema = z
|
|
14
|
+
.object({
|
|
15
|
+
targetingType: z.enum(["age", "gender", "device"]).describe("Type of targeting to list"),
|
|
16
|
+
maxResults: z
|
|
17
|
+
.number()
|
|
18
|
+
.int()
|
|
19
|
+
.min(1)
|
|
20
|
+
.max(100)
|
|
21
|
+
.default(25)
|
|
22
|
+
.describe("Maximum number of results to return"),
|
|
23
|
+
})
|
|
24
|
+
.describe("Parameters for listing targeting options");
|
|
25
|
+
export const SearchTargetingOutputSchema = z
|
|
26
|
+
.object({
|
|
27
|
+
targetingType: z.string(),
|
|
28
|
+
results: z.array(z.record(z.any())),
|
|
29
|
+
totalResults: z.number(),
|
|
30
|
+
timestamp: z.string().datetime(),
|
|
31
|
+
})
|
|
32
|
+
.describe("Targeting options result");
|
|
33
|
+
const AGE_RANGES = [
|
|
34
|
+
{ Id: "EighteenToTwentyFour", Name: "18-24" },
|
|
35
|
+
{ Id: "TwentyFiveToThirtyFour", Name: "25-34" },
|
|
36
|
+
{ Id: "ThirtyFiveToFortyNine", Name: "35-49" },
|
|
37
|
+
{ Id: "FiftyToSixtyFour", Name: "50-64" },
|
|
38
|
+
{ Id: "SixtyFiveAndAbove", Name: "65+" },
|
|
39
|
+
];
|
|
40
|
+
const GENDERS = [
|
|
41
|
+
{ Id: "Male", Name: "Male" },
|
|
42
|
+
{ Id: "Female", Name: "Female" },
|
|
43
|
+
];
|
|
44
|
+
const DEVICE_TYPES = [
|
|
45
|
+
{ Id: "Computers", Name: "Computers" },
|
|
46
|
+
{ Id: "Smartphones", Name: "Smartphones" },
|
|
47
|
+
{ Id: "Tablets", Name: "Tablets" },
|
|
48
|
+
];
|
|
49
|
+
export async function searchTargetingLogic(input, _context, _sdkContext) {
|
|
50
|
+
let results;
|
|
51
|
+
switch (input.targetingType) {
|
|
52
|
+
case "age":
|
|
53
|
+
results = AGE_RANGES;
|
|
54
|
+
break;
|
|
55
|
+
case "gender":
|
|
56
|
+
results = GENDERS;
|
|
57
|
+
break;
|
|
58
|
+
case "device":
|
|
59
|
+
results = DEVICE_TYPES;
|
|
60
|
+
break;
|
|
61
|
+
default:
|
|
62
|
+
throw new McpError(JsonRpcErrorCode.InvalidParams, `Unsupported targeting type: ${input.targetingType}`);
|
|
63
|
+
}
|
|
64
|
+
return {
|
|
65
|
+
targetingType: input.targetingType,
|
|
66
|
+
results: results.slice(0, input.maxResults),
|
|
67
|
+
totalResults: results.length,
|
|
68
|
+
timestamp: new Date().toISOString(),
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
export function searchTargetingResponseFormatter(result) {
|
|
72
|
+
const header = `Available ${result.targetingType} targeting options (${result.totalResults})`;
|
|
73
|
+
return [
|
|
74
|
+
{
|
|
75
|
+
type: "text",
|
|
76
|
+
text: `${header}\n\n${JSON.stringify(result.results, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
77
|
+
},
|
|
78
|
+
];
|
|
79
|
+
}
|
|
80
|
+
export const searchTargetingTool = {
|
|
81
|
+
name: TOOL_NAME,
|
|
82
|
+
title: TOOL_TITLE,
|
|
83
|
+
description: TOOL_DESCRIPTION,
|
|
84
|
+
inputSchema: SearchTargetingInputSchema,
|
|
85
|
+
outputSchema: SearchTargetingOutputSchema,
|
|
86
|
+
annotations: {
|
|
87
|
+
readOnlyHint: true,
|
|
88
|
+
openWorldHint: false,
|
|
89
|
+
idempotentHint: true,
|
|
90
|
+
destructiveHint: false,
|
|
91
|
+
},
|
|
92
|
+
inputExamples: [
|
|
93
|
+
{
|
|
94
|
+
label: "List available age range targets",
|
|
95
|
+
input: { targetingType: "age" },
|
|
96
|
+
},
|
|
97
|
+
{
|
|
98
|
+
label: "List available device targets",
|
|
99
|
+
input: { targetingType: "device" },
|
|
100
|
+
},
|
|
101
|
+
],
|
|
102
|
+
logic: searchTargetingLogic,
|
|
103
|
+
responseFormatter: searchTargetingResponseFormatter,
|
|
104
|
+
};
|
|
105
|
+
//# 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,132 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
|
|
3
|
+
export declare const SubmitReportInputSchema: z.ZodEffects<z.ZodObject<{
|
|
4
|
+
reportType: z.ZodString;
|
|
5
|
+
accountId: z.ZodString;
|
|
6
|
+
columns: z.ZodArray<z.ZodString, "many">;
|
|
7
|
+
datePreset: z.ZodOptional<z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>>;
|
|
8
|
+
startDate: z.ZodOptional<z.ZodString>;
|
|
9
|
+
endDate: z.ZodOptional<z.ZodString>;
|
|
10
|
+
aggregation: z.ZodOptional<z.ZodString>;
|
|
11
|
+
}, "strip", z.ZodTypeAny, {
|
|
12
|
+
accountId: string;
|
|
13
|
+
reportType: string;
|
|
14
|
+
columns: string[];
|
|
15
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
16
|
+
startDate?: string | undefined;
|
|
17
|
+
endDate?: string | undefined;
|
|
18
|
+
aggregation?: string | undefined;
|
|
19
|
+
}, {
|
|
20
|
+
accountId: string;
|
|
21
|
+
reportType: string;
|
|
22
|
+
columns: string[];
|
|
23
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
24
|
+
startDate?: string | undefined;
|
|
25
|
+
endDate?: string | undefined;
|
|
26
|
+
aggregation?: string | undefined;
|
|
27
|
+
}>, {
|
|
28
|
+
accountId: string;
|
|
29
|
+
reportType: string;
|
|
30
|
+
columns: string[];
|
|
31
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
32
|
+
startDate?: string | undefined;
|
|
33
|
+
endDate?: string | undefined;
|
|
34
|
+
aggregation?: string | undefined;
|
|
35
|
+
}, {
|
|
36
|
+
accountId: string;
|
|
37
|
+
reportType: string;
|
|
38
|
+
columns: string[];
|
|
39
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
40
|
+
startDate?: string | undefined;
|
|
41
|
+
endDate?: string | undefined;
|
|
42
|
+
aggregation?: string | undefined;
|
|
43
|
+
}>;
|
|
44
|
+
export declare const SubmitReportOutputSchema: z.ZodObject<{
|
|
45
|
+
reportRequestId: z.ZodString;
|
|
46
|
+
timestamp: z.ZodString;
|
|
47
|
+
}, "strip", z.ZodTypeAny, {
|
|
48
|
+
reportRequestId: string;
|
|
49
|
+
timestamp: string;
|
|
50
|
+
}, {
|
|
51
|
+
reportRequestId: string;
|
|
52
|
+
timestamp: string;
|
|
53
|
+
}>;
|
|
54
|
+
type SubmitReportInput = z.infer<typeof SubmitReportInputSchema>;
|
|
55
|
+
type SubmitReportOutput = z.infer<typeof SubmitReportOutputSchema>;
|
|
56
|
+
export declare function submitReportLogic(input: SubmitReportInput, context: RequestContext, sdkContext?: SdkContext): Promise<SubmitReportOutput>;
|
|
57
|
+
export declare function submitReportResponseFormatter(result: SubmitReportOutput): McpTextContent[];
|
|
58
|
+
export declare const submitReportTool: {
|
|
59
|
+
name: string;
|
|
60
|
+
title: string;
|
|
61
|
+
description: string;
|
|
62
|
+
inputSchema: z.ZodEffects<z.ZodObject<{
|
|
63
|
+
reportType: z.ZodString;
|
|
64
|
+
accountId: z.ZodString;
|
|
65
|
+
columns: 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
|
+
startDate: z.ZodOptional<z.ZodString>;
|
|
68
|
+
endDate: z.ZodOptional<z.ZodString>;
|
|
69
|
+
aggregation: z.ZodOptional<z.ZodString>;
|
|
70
|
+
}, "strip", z.ZodTypeAny, {
|
|
71
|
+
accountId: string;
|
|
72
|
+
reportType: string;
|
|
73
|
+
columns: string[];
|
|
74
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
75
|
+
startDate?: string | undefined;
|
|
76
|
+
endDate?: string | undefined;
|
|
77
|
+
aggregation?: string | undefined;
|
|
78
|
+
}, {
|
|
79
|
+
accountId: string;
|
|
80
|
+
reportType: string;
|
|
81
|
+
columns: string[];
|
|
82
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
83
|
+
startDate?: string | undefined;
|
|
84
|
+
endDate?: string | undefined;
|
|
85
|
+
aggregation?: string | undefined;
|
|
86
|
+
}>, {
|
|
87
|
+
accountId: string;
|
|
88
|
+
reportType: string;
|
|
89
|
+
columns: string[];
|
|
90
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
91
|
+
startDate?: string | undefined;
|
|
92
|
+
endDate?: string | undefined;
|
|
93
|
+
aggregation?: string | undefined;
|
|
94
|
+
}, {
|
|
95
|
+
accountId: string;
|
|
96
|
+
reportType: string;
|
|
97
|
+
columns: string[];
|
|
98
|
+
datePreset?: "TODAY" | "YESTERDAY" | "LAST_7_DAYS" | "LAST_14_DAYS" | "LAST_30_DAYS" | "THIS_MONTH" | "LAST_MONTH" | "LAST_90_DAYS" | undefined;
|
|
99
|
+
startDate?: string | undefined;
|
|
100
|
+
endDate?: string | undefined;
|
|
101
|
+
aggregation?: string | undefined;
|
|
102
|
+
}>;
|
|
103
|
+
outputSchema: z.ZodObject<{
|
|
104
|
+
reportRequestId: z.ZodString;
|
|
105
|
+
timestamp: z.ZodString;
|
|
106
|
+
}, "strip", z.ZodTypeAny, {
|
|
107
|
+
reportRequestId: string;
|
|
108
|
+
timestamp: string;
|
|
109
|
+
}, {
|
|
110
|
+
reportRequestId: string;
|
|
111
|
+
timestamp: string;
|
|
112
|
+
}>;
|
|
113
|
+
annotations: {
|
|
114
|
+
readOnlyHint: boolean;
|
|
115
|
+
openWorldHint: boolean;
|
|
116
|
+
idempotentHint: boolean;
|
|
117
|
+
destructiveHint: boolean;
|
|
118
|
+
};
|
|
119
|
+
inputExamples: {
|
|
120
|
+
label: string;
|
|
121
|
+
input: {
|
|
122
|
+
reportType: string;
|
|
123
|
+
accountId: string;
|
|
124
|
+
columns: string[];
|
|
125
|
+
datePreset: string;
|
|
126
|
+
};
|
|
127
|
+
}[];
|
|
128
|
+
logic: typeof submitReportLogic;
|
|
129
|
+
responseFormatter: typeof submitReportResponseFormatter;
|
|
130
|
+
};
|
|
131
|
+
export {};
|
|
132
|
+
//# 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,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2B2B,CAAC;AAEhE,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyB5B,CAAC"}
|