@cesteral/msads-mcp 1.3.0 → 2.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/README.md +44 -30
- package/dist/auth/msads-auth-adapter.d.ts.map +1 -1
- package/dist/auth/msads-auth-adapter.js +1 -1
- package/dist/auth/msads-auth-adapter.js.map +1 -1
- package/dist/cesteral-manifest.json +68 -16
- package/dist/config/index.d.ts +36 -67
- package/dist/config/index.d.ts.map +1 -1
- package/dist/index.js +13 -23
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +9 -3
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +5 -3
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +9 -6
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js.map +1 -1
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +1 -1
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -1
- package/dist/mcp-server/prompts/index.d.ts +1 -1
- package/dist/mcp-server/prompts/index.d.ts.map +1 -1
- package/dist/mcp-server/prompts/index.js +15 -0
- package/dist/mcp-server/prompts/index.js.map +1 -1
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js +16 -7
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -1
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/index.js +10 -9
- package/dist/mcp-server/resources/definitions/index.js.map +1 -1
- package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -1
- package/dist/mcp-server/resources/utils/field-rules.js +11 -11
- package/dist/mcp-server/resources/utils/field-rules.js.map +1 -1
- package/dist/mcp-server/server.d.ts +2 -1
- package/dist/mcp-server/server.d.ts.map +1 -1
- package/dist/mcp-server/server.js +29 -100
- package/dist/mcp-server/server.js.map +1 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +26 -132
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +73 -18
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +31 -65
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +44 -13
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +31 -72
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +40 -10
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +45 -118
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +30 -9
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +24 -62
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js +4 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +24 -57
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/create-entity.tool.js +21 -6
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +29 -119
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +28 -55
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +25 -78
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js +22 -20
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +12 -59
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +20 -37
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +84 -214
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/download-report.tool.js +7 -2
- package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -1
- 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 +171 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +12 -32
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +6 -2
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +24 -244
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-entity.tool.js +41 -67
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts +2 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js +20 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +104 -204
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +9 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +100 -188
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-report.tool.js +9 -1
- package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +57 -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 +97 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +27 -57
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js +40 -10
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/index.js +6 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -1
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +14 -90
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js +5 -1
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +18 -70
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-entities.tool.js +9 -2
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +5 -16
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +4 -3
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +24 -56
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +45 -6
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +36 -66
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +49 -8
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +17 -40
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js +12 -19
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +35 -112
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/submit-report.tool.js +2 -1
- package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +37 -323
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +72 -85
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +45 -116
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js +3 -2
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -1
- package/dist/mcp-server/tools/index.d.ts +4 -1
- package/dist/mcp-server/tools/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/index.js +7 -1
- package/dist/mcp-server/tools/index.js.map +1 -1
- package/dist/mcp-server/tools/utils/bulk-capacity.d.ts +9 -0
- package/dist/mcp-server/tools/utils/bulk-capacity.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/bulk-capacity.js +96 -0
- package/dist/mcp-server/tools/utils/bulk-capacity.js.map +1 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts +5 -2
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/capture-snapshot.js +38 -19
- package/dist/mcp-server/tools/utils/capture-snapshot.js.map +1 -1
- package/dist/mcp-server/tools/utils/dry-run.d.ts +12 -3
- package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/dry-run.js +46 -8
- package/dist/mcp-server/tools/utils/dry-run.js.map +1 -1
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts +27 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -1
- package/dist/mcp-server/tools/utils/entity-mapping.js +105 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -1
- package/dist/mcp-server/tools/utils/parent-ids.d.ts +16 -0
- package/dist/mcp-server/tools/utils/parent-ids.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/parent-ids.js +28 -0
- package/dist/mcp-server/tools/utils/parent-ids.js.map +1 -0
- package/dist/mcp-server/tools/utils/targeting-values.d.ts +9 -0
- package/dist/mcp-server/tools/utils/targeting-values.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/targeting-values.js +16 -0
- package/dist/mcp-server/tools/utils/targeting-values.js.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts +22 -20
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -1
- package/dist/mcp-server/transports/streamable-http-transport.js +15 -51
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -1
- package/dist/services/msads/msads-http-client.d.ts +5 -1
- package/dist/services/msads/msads-http-client.d.ts.map +1 -1
- package/dist/services/msads/msads-http-client.js +49 -2
- package/dist/services/msads/msads-http-client.js.map +1 -1
- package/dist/services/msads/msads-reporting-service.d.ts +3 -9
- package/dist/services/msads/msads-reporting-service.d.ts.map +1 -1
- package/dist/services/msads/msads-reporting-service.js +62 -27
- package/dist/services/msads/msads-reporting-service.js.map +1 -1
- package/dist/services/msads/msads-service.d.ts +53 -5
- package/dist/services/msads/msads-service.d.ts.map +1 -1
- package/dist/services/msads/msads-service.js +235 -35
- package/dist/services/msads/msads-service.js.map +1 -1
- package/dist/services/msads/partial-errors.d.ts +34 -0
- package/dist/services/msads/partial-errors.d.ts.map +1 -0
- package/dist/services/msads/partial-errors.js +149 -0
- package/dist/services/msads/partial-errors.js.map +1 -0
- package/dist/services/msads/rate-limit-keys.d.ts +8 -2
- package/dist/services/msads/rate-limit-keys.d.ts.map +1 -1
- package/dist/services/msads/rate-limit-keys.js +16 -2
- package/dist/services/msads/rate-limit-keys.js.map +1 -1
- package/dist/services/msads/types.d.ts +1 -2
- package/dist/services/msads/types.d.ts.map +1 -1
- package/dist/services/msads/types.js.map +1 -1
- package/dist/services/session-services.d.ts +2 -2
- package/dist/services/session-services.d.ts.map +1 -1
- package/dist/services/session-services.js +10 -10
- package/dist/services/session-services.js.map +1 -1
- package/dist/services/session-wiring.d.ts +7 -0
- package/dist/services/session-wiring.d.ts.map +1 -0
- package/dist/services/session-wiring.js +20 -0
- package/dist/services/session-wiring.js.map +1 -0
- package/dist/testkit/fixtures/index.d.ts.map +1 -1
- package/dist/testkit/fixtures/index.js +3 -3
- package/dist/testkit/fixtures/index.js.map +1 -1
- package/package.json +8 -8
package/README.md
CHANGED
|
@@ -14,7 +14,7 @@ through the Model Context Protocol.
|
|
|
14
14
|
## Features
|
|
15
15
|
|
|
16
16
|
- **Per-session Bearer token auth** via `MsAdsBearerAuthStrategy`
|
|
17
|
-
- **Streamable HTTP + stdio transports** via Hono +
|
|
17
|
+
- **Streamable HTTP + stdio transports** via Hono + the MCP SDK's web-standard transport
|
|
18
18
|
- **OpenTelemetry** instrumentation for traces and metrics
|
|
19
19
|
- **Rate limiting** via shared `RateLimiter` class
|
|
20
20
|
- **Structured logging** via Pino
|
|
@@ -24,14 +24,14 @@ through the Model Context Protocol.
|
|
|
24
24
|
|
|
25
25
|
### Core CRUD
|
|
26
26
|
|
|
27
|
-
| Tool | Description
|
|
28
|
-
| --------------------- |
|
|
29
|
-
| `msads_list_entities` | List
|
|
30
|
-
| `msads_get_entity` | Get a single entity by ID
|
|
31
|
-
| `msads_create_entity` | Create a new entity
|
|
32
|
-
| `msads_update_entity` | Update an existing entity
|
|
33
|
-
| `msads_delete_entity` | Delete an entity
|
|
34
|
-
| `msads_list_accounts` | List accessible ad accounts
|
|
27
|
+
| Tool | Description |
|
|
28
|
+
| --------------------- | -------------------------------------------------- |
|
|
29
|
+
| `msads_list_entities` | List entities by account or parent (no pagination) |
|
|
30
|
+
| `msads_get_entity` | Get a single entity by ID |
|
|
31
|
+
| `msads_create_entity` | Create a new entity |
|
|
32
|
+
| `msads_update_entity` | Update an existing entity |
|
|
33
|
+
| `msads_delete_entity` | Delete an entity |
|
|
34
|
+
| `msads_list_accounts` | List accessible ad accounts |
|
|
35
35
|
|
|
36
36
|
### Reporting
|
|
37
37
|
|
|
@@ -56,35 +56,49 @@ All reporting tools below accept the shared bounded report-view params: `mode` (
|
|
|
56
56
|
|
|
57
57
|
### Specialized
|
|
58
58
|
|
|
59
|
-
| Tool
|
|
60
|
-
|
|
|
61
|
-
| `msads_manage_ad_extensions`
|
|
62
|
-
| `msads_manage_criterions`
|
|
63
|
-
| `msads_search_targeting`
|
|
64
|
-
| `msads_get_ad_details`
|
|
65
|
-
| `msads_validate_entity`
|
|
66
|
-
| `msads_import_from_google`
|
|
59
|
+
| Tool | Description |
|
|
60
|
+
| ----------------------------- | ------------------------------------------------ |
|
|
61
|
+
| `msads_manage_ad_extensions` | Manage ad extensions (sitelinks, callouts, etc.) |
|
|
62
|
+
| `msads_manage_criterions` | Manage targeting criterions |
|
|
63
|
+
| `msads_search_targeting` | Search available targeting options |
|
|
64
|
+
| `msads_get_ad_details` | Get stored ad details (copy, URLs, status) |
|
|
65
|
+
| `msads_validate_entity` | Validate entity payload |
|
|
66
|
+
| `msads_import_from_google` | Import campaigns from Google Ads |
|
|
67
|
+
| `msads_duplicate_entity` | Copy a campaign (always created `Paused`) |
|
|
68
|
+
| `msads_get_targeting_options` | Static criterion values for `manage_criterions` |
|
|
69
|
+
| `msads_get_pacing_status` | Client-side pacing calculator (no API call) |
|
|
70
|
+
| `msads_search_tools` | Rank this server's tools against a query |
|
|
71
|
+
|
|
72
|
+
### Report Schedules (not supported by the platform)
|
|
73
|
+
|
|
74
|
+
The Reporting API v13 exposes only `GenerateReport/Submit` and `GenerateReport/Poll`; `ReportRequest` has no `Schedule` element. These tools stay registered so tool lists do not churn, but none of them schedules, lists or deletes anything.
|
|
75
|
+
|
|
76
|
+
| Tool | Behaviour |
|
|
77
|
+
| ------------------------------ | -------------------------------------------------- |
|
|
78
|
+
| `msads_create_report_schedule` | Always fails without calling Microsoft Advertising |
|
|
79
|
+
| `msads_list_report_schedules` | Returns guidance only |
|
|
80
|
+
| `msads_delete_report_schedule` | Always fails without calling Microsoft Advertising |
|
|
67
81
|
|
|
68
82
|
## Supported Entity Types
|
|
69
83
|
|
|
70
|
-
| Entity Type | API Service Path | Parent Entity | Batch Limit | Notes
|
|
71
|
-
| ------------- | ----------------- | ------------- | ----------- |
|
|
72
|
-
| `campaign` | `/Campaigns/*` | Account | 100 | Top-level entity;
|
|
73
|
-
| `adGroup` | `/AdGroups/*` | Campaign | 1000 | Requires parent `CampaignId`
|
|
74
|
-
| `ad` | `/Ads/*` | Ad Group | 50 | Requires parent `AdGroupId`
|
|
75
|
-
| `keyword` | `/Keywords/*` | Ad Group | 1000 | Requires parent `AdGroupId`
|
|
76
|
-
| `budget` | `/Budgets/*` | Account | 100 | Shared budgets; create before campaigns
|
|
77
|
-
| `adExtension` | `/AdExtensions/*` | Account | 100 | Sitelinks, callouts, structured snippets, etc.
|
|
78
|
-
| `audience` | `/Audiences/*` | Account | 100 | Remarketing lists, custom audiences
|
|
79
|
-
| `label` | `/Labels/*` | Account | 100 | For organizing and filtering entities
|
|
84
|
+
| Entity Type | API Service Path | Parent Entity | Batch Limit | Notes |
|
|
85
|
+
| ------------- | ----------------- | ------------- | ----------- | --------------------------------------------------------- |
|
|
86
|
+
| `campaign` | `/Campaigns/*` | Account | 100 | Top-level entity; inline `DailyBudget` or a shared budget |
|
|
87
|
+
| `adGroup` | `/AdGroups/*` | Campaign | 1000 | Requires parent `CampaignId` |
|
|
88
|
+
| `ad` | `/Ads/*` | Ad Group | 50 | Requires parent `AdGroupId` |
|
|
89
|
+
| `keyword` | `/Keywords/*` | Ad Group | 1000 | Requires parent `AdGroupId` |
|
|
90
|
+
| `budget` | `/Budgets/*` | Account | 100 | Shared budgets; create before campaigns |
|
|
91
|
+
| `adExtension` | `/AdExtensions/*` | Account | 100 | Sitelinks, callouts, structured snippets, etc. |
|
|
92
|
+
| `audience` | `/Audiences/*` | Account | 100 | Remarketing lists, custom audiences |
|
|
93
|
+
| `label` | `/Labels/*` | Account | 100 | For organizing and filtering entities |
|
|
80
94
|
|
|
81
95
|
**Entity Hierarchy:** Account > Budget > Campaign > Ad Group > Ad / Keyword
|
|
82
96
|
|
|
83
97
|
## Current Status
|
|
84
98
|
|
|
85
|
-
|
|
99
|
+
The tools call the Microsoft Advertising API v13 JSON endpoints. Request shapes are checked against the MicrosoftDocs/Advertising reference (see `tests/tools/msads-wire-requests.test.ts`), but no tool has been exercised against a live account, so every governed tool is at `declared` verification.
|
|
86
100
|
|
|
87
|
-
|
|
101
|
+
- The stdio transport takes a static `MSADS_ACCESS_TOKEN` and has no refresh-token flow; an access token expires after the `expires_in` seconds returned with it (MicrosoftDocs `authentication-oauth-get-tokens.md`), so long stdio sessions need a fresh token. Mint it with the `https://ads.microsoft.com/msads.manage` scope.
|
|
88
102
|
|
|
89
103
|
## Development
|
|
90
104
|
|
|
@@ -155,7 +169,7 @@ When running in stdio transport mode (e.g., Claude Desktop), set these environme
|
|
|
155
169
|
|
|
156
170
|
### Transport
|
|
157
171
|
|
|
158
|
-
- **Streamable HTTP**: MCP protocol via Hono +
|
|
172
|
+
- **Streamable HTTP**: MCP protocol via Hono + the MCP SDK's web-standard transport
|
|
159
173
|
- **Health check**: `/health` endpoint
|
|
160
174
|
|
|
161
175
|
## Contributing
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"msads-auth-adapter.d.ts","sourceRoot":"","sources":["../../src/auth/msads-auth-adapter.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,gBAAgB;IAC/B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;
|
|
1
|
+
{"version":3,"file":"msads-auth-adapter.d.ts","sourceRoot":"","sources":["../../src/auth/msads-auth-adapter.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,gBAAgB;IAC/B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAgBD,qBAAa,uBAAwB,YAAW,gBAAgB;IAK5D,OAAO,CAAC,QAAQ,CAAC,WAAW;aACZ,cAAc,EAAE,MAAM;aACtB,UAAU,EAAE,MAAM;aAClB,SAAS,EAAE,MAAM;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IARrC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAM;gBAGF,WAAW,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAChB,kBAAkB,GAAE,MAAgF;IAGvH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAEK,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAIjC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA+BhC;AAMD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,CAUR;AAKD,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,CAMR;AAKD,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,CAMR;AAKD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,CAMR;AAKD,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}
|
|
@@ -37,7 +37,7 @@ export class MsAdsAccessTokenAdapter {
|
|
|
37
37
|
throw new McpError(JsonRpcErrorCode.Unauthorized, `Microsoft Ads token validation failed: ${response.status} ${response.statusText}`, { body: errorBody.substring(0, 200) });
|
|
38
38
|
}
|
|
39
39
|
const data = (await response.json());
|
|
40
|
-
this._userId = String(data.
|
|
40
|
+
this._userId = String(data.User?.Id ?? "unknown");
|
|
41
41
|
this.validated = true;
|
|
42
42
|
}
|
|
43
43
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"msads-auth-adapter.js","sourceRoot":"","sources":["../../src/auth/msads-auth-adapter.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,QAAQ,GACT,MAAM,kBAAkB,CAAC;
|
|
1
|
+
{"version":3,"file":"msads-auth-adapter.js","sourceRoot":"","sources":["../../src/auth/msads-auth-adapter.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,106 +1,158 @@
|
|
|
1
1
|
{
|
|
2
2
|
"manifestVersion": 1,
|
|
3
3
|
"packageName": "@cesteral/msads-mcp",
|
|
4
|
-
"packageVersion": "
|
|
5
|
-
"generatedAt": "2026-
|
|
4
|
+
"packageVersion": "2.0.0",
|
|
5
|
+
"generatedAt": "2026-11-18T11:08:18.201Z",
|
|
6
6
|
"tools": [
|
|
7
7
|
{
|
|
8
8
|
"toolName": "msads_adjust_bids",
|
|
9
9
|
"contractPlatformSlug": "msads",
|
|
10
10
|
"contractToolSlug": "adjust_bids",
|
|
11
11
|
"schemaVersion": "1",
|
|
12
|
-
"definitionHash": "
|
|
12
|
+
"definitionHash": "9994b7f426a124474eeb450424256878d0a5c6eb2bbcb1b7a8092a97749b9768",
|
|
13
|
+
"verification": {
|
|
14
|
+
"status": "declared"
|
|
15
|
+
}
|
|
13
16
|
},
|
|
14
17
|
{
|
|
15
18
|
"toolName": "msads_bulk_create_entities",
|
|
16
19
|
"contractPlatformSlug": "msads",
|
|
17
20
|
"contractToolSlug": "bulk_create_entities",
|
|
18
21
|
"schemaVersion": "1",
|
|
19
|
-
"definitionHash": "
|
|
22
|
+
"definitionHash": "fb2bc547fed2c0049dc80f9542a29903e2776dd6ce9ef570380b18a0dd09a15b",
|
|
23
|
+
"verification": {
|
|
24
|
+
"status": "declared"
|
|
25
|
+
}
|
|
20
26
|
},
|
|
21
27
|
{
|
|
22
28
|
"toolName": "msads_bulk_update_entities",
|
|
23
29
|
"contractPlatformSlug": "msads",
|
|
24
30
|
"contractToolSlug": "bulk_update_entities",
|
|
25
31
|
"schemaVersion": "1",
|
|
26
|
-
"definitionHash": "
|
|
32
|
+
"definitionHash": "610837a3e1b57dbcc54e9629a48a6aabcfb0a21cf2ab3dc1a8035025c1ff99c2",
|
|
33
|
+
"verification": {
|
|
34
|
+
"status": "declared"
|
|
35
|
+
}
|
|
27
36
|
},
|
|
28
37
|
{
|
|
29
38
|
"toolName": "msads_bulk_update_status",
|
|
30
39
|
"contractPlatformSlug": "msads",
|
|
31
40
|
"contractToolSlug": "bulk_update_status",
|
|
32
41
|
"schemaVersion": "1",
|
|
33
|
-
"definitionHash": "
|
|
42
|
+
"definitionHash": "6d03159f0c59237c2c37d8a78ad0dfbd4c68532555ee82b0703ac56ac886073f",
|
|
43
|
+
"verification": {
|
|
44
|
+
"status": "declared"
|
|
45
|
+
}
|
|
34
46
|
},
|
|
35
47
|
{
|
|
36
48
|
"toolName": "msads_create_entity",
|
|
37
49
|
"contractPlatformSlug": "msads",
|
|
38
50
|
"contractToolSlug": "create_entity",
|
|
39
51
|
"schemaVersion": "1",
|
|
40
|
-
"definitionHash": "
|
|
52
|
+
"definitionHash": "0b8b9cbf6efaf8ce21ea9cb2c7a55ec17baf103b1a119fd337da38aa9c3fe63c",
|
|
53
|
+
"verification": {
|
|
54
|
+
"status": "declared"
|
|
55
|
+
}
|
|
41
56
|
},
|
|
42
57
|
{
|
|
43
58
|
"toolName": "msads_create_report_schedule",
|
|
44
59
|
"contractPlatformSlug": "msads",
|
|
45
60
|
"contractToolSlug": "create_report_schedule",
|
|
46
61
|
"schemaVersion": "1",
|
|
47
|
-
"definitionHash": "
|
|
62
|
+
"definitionHash": "e16949f58cc40a293708313bc61c6cb32b33c7aa169add723bdc64497b5fad8d",
|
|
63
|
+
"verification": {
|
|
64
|
+
"status": "declared"
|
|
65
|
+
}
|
|
48
66
|
},
|
|
49
67
|
{
|
|
50
68
|
"toolName": "msads_delete_entity",
|
|
51
69
|
"contractPlatformSlug": "msads",
|
|
52
70
|
"contractToolSlug": "delete_entity",
|
|
53
71
|
"schemaVersion": "1",
|
|
54
|
-
"definitionHash": "
|
|
72
|
+
"definitionHash": "8ef3e203481091805b13dbd8aaee73b6d927ef184282ff218dc0fdaeaa2d7000",
|
|
73
|
+
"verification": {
|
|
74
|
+
"status": "declared"
|
|
75
|
+
}
|
|
55
76
|
},
|
|
56
77
|
{
|
|
57
78
|
"toolName": "msads_delete_report_schedule",
|
|
58
79
|
"contractPlatformSlug": "msads",
|
|
59
80
|
"contractToolSlug": "delete_report_schedule",
|
|
60
81
|
"schemaVersion": "1",
|
|
61
|
-
"definitionHash": "
|
|
82
|
+
"definitionHash": "46603ef771e18b66b801db63da8b37bc70997972566ff60f257710a956c4e2fb",
|
|
83
|
+
"verification": {
|
|
84
|
+
"status": "declared"
|
|
85
|
+
}
|
|
86
|
+
},
|
|
87
|
+
{
|
|
88
|
+
"toolName": "msads_duplicate_entity",
|
|
89
|
+
"contractPlatformSlug": "msads",
|
|
90
|
+
"contractToolSlug": "duplicate_entity",
|
|
91
|
+
"schemaVersion": "1",
|
|
92
|
+
"definitionHash": "cdee51649feb3cded5cffdb3d87fe9ec58bba68b25e99543e57fe090e0a56e0e",
|
|
93
|
+
"verification": {
|
|
94
|
+
"status": "declared"
|
|
95
|
+
}
|
|
62
96
|
},
|
|
63
97
|
{
|
|
64
98
|
"toolName": "msads_get_entity",
|
|
65
99
|
"contractPlatformSlug": "msads",
|
|
66
100
|
"contractToolSlug": "get_entity",
|
|
67
101
|
"schemaVersion": "1",
|
|
68
|
-
"definitionHash": "
|
|
102
|
+
"definitionHash": "626e0e039d09c6d8e07882ad683e0a3604c881ea7a23241506b291e70ce0100c",
|
|
103
|
+
"verification": {
|
|
104
|
+
"status": "declared"
|
|
105
|
+
}
|
|
69
106
|
},
|
|
70
107
|
{
|
|
71
108
|
"toolName": "msads_import_from_google",
|
|
72
109
|
"contractPlatformSlug": "msads",
|
|
73
110
|
"contractToolSlug": "import_from_google",
|
|
74
111
|
"schemaVersion": "1",
|
|
75
|
-
"definitionHash": "
|
|
112
|
+
"definitionHash": "e5efe1181d5e73e8b0d80a5a3b9a6acd45aabbdcb38c18bee342defa57d8cba9",
|
|
113
|
+
"verification": {
|
|
114
|
+
"status": "declared"
|
|
115
|
+
}
|
|
76
116
|
},
|
|
77
117
|
{
|
|
78
118
|
"toolName": "msads_manage_ad_extensions",
|
|
79
119
|
"contractPlatformSlug": "msads",
|
|
80
120
|
"contractToolSlug": "manage_ad_extensions",
|
|
81
121
|
"schemaVersion": "1",
|
|
82
|
-
"definitionHash": "
|
|
122
|
+
"definitionHash": "51f7b0112d223290a6d8bb1c4270e3136126a97b5ee57e9870a9426f82323230",
|
|
123
|
+
"verification": {
|
|
124
|
+
"status": "declared"
|
|
125
|
+
}
|
|
83
126
|
},
|
|
84
127
|
{
|
|
85
128
|
"toolName": "msads_manage_criterions",
|
|
86
129
|
"contractPlatformSlug": "msads",
|
|
87
130
|
"contractToolSlug": "manage_criterions",
|
|
88
131
|
"schemaVersion": "1",
|
|
89
|
-
"definitionHash": "
|
|
132
|
+
"definitionHash": "195b9a1e18fa8474e5fcd62b0acb003a8757ed2a56e023ae49c84be5ae9a4ba6",
|
|
133
|
+
"verification": {
|
|
134
|
+
"status": "declared"
|
|
135
|
+
}
|
|
90
136
|
},
|
|
91
137
|
{
|
|
92
138
|
"toolName": "msads_submit_report",
|
|
93
139
|
"contractPlatformSlug": "msads",
|
|
94
140
|
"contractToolSlug": "submit_report",
|
|
95
141
|
"schemaVersion": "1",
|
|
96
|
-
"definitionHash": "
|
|
142
|
+
"definitionHash": "ef734d26aabe86363844df5656b565878b630da35d4c215043150f4bbab973a6",
|
|
143
|
+
"verification": {
|
|
144
|
+
"status": "declared"
|
|
145
|
+
}
|
|
97
146
|
},
|
|
98
147
|
{
|
|
99
148
|
"toolName": "msads_update_entity",
|
|
100
149
|
"contractPlatformSlug": "msads",
|
|
101
150
|
"contractToolSlug": "update_entity",
|
|
102
151
|
"schemaVersion": "1",
|
|
103
|
-
"definitionHash": "
|
|
152
|
+
"definitionHash": "4b95c98389efb2ffb6fdcbc88e6cc8b15fce345effc736d478b063a98d5e46e5",
|
|
153
|
+
"verification": {
|
|
154
|
+
"status": "declared"
|
|
155
|
+
}
|
|
104
156
|
}
|
|
105
157
|
]
|
|
106
158
|
}
|
package/dist/config/index.d.ts
CHANGED
|
@@ -1,21 +1,41 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
declare const ConfigSchema: z.ZodObject<{
|
|
3
3
|
host: z.ZodDefault<z.ZodString>;
|
|
4
|
-
nodeEnv: z.ZodDefault<z.ZodEnum<
|
|
4
|
+
nodeEnv: z.ZodDefault<z.ZodEnum<{
|
|
5
|
+
development: "development";
|
|
6
|
+
production: "production";
|
|
7
|
+
test: "test";
|
|
8
|
+
}>>;
|
|
5
9
|
mcpStatefulSessionTimeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
6
10
|
mcpAuthSecretKey: z.ZodOptional<z.ZodString>;
|
|
7
11
|
mcpAllowedOrigins: z.ZodOptional<z.ZodString>;
|
|
8
|
-
|
|
9
|
-
|
|
12
|
+
mcpAllowedHosts: z.ZodOptional<z.ZodString>;
|
|
13
|
+
logLevel: z.ZodDefault<z.ZodEnum<{
|
|
14
|
+
error: "error";
|
|
15
|
+
info: "info";
|
|
16
|
+
debug: "debug";
|
|
17
|
+
warning: "warning";
|
|
18
|
+
notice: "notice";
|
|
19
|
+
}>>;
|
|
20
|
+
mcpLogLevel: z.ZodDefault<z.ZodEnum<{
|
|
21
|
+
error: "error";
|
|
22
|
+
info: "info";
|
|
23
|
+
debug: "debug";
|
|
24
|
+
warning: "warning";
|
|
25
|
+
notice: "notice";
|
|
26
|
+
}>>;
|
|
10
27
|
otelEnabled: z.ZodDefault<z.ZodBoolean>;
|
|
11
28
|
otelExporterOtlpTracesEndpoint: z.ZodOptional<z.ZodString>;
|
|
12
29
|
otelExporterOtlpMetricsEndpoint: z.ZodOptional<z.ZodString>;
|
|
13
30
|
gcsBucketName: z.ZodOptional<z.ZodString>;
|
|
14
|
-
} & {
|
|
15
31
|
serviceName: z.ZodDefault<z.ZodString>;
|
|
16
32
|
port: z.ZodDefault<z.ZodNumber>;
|
|
17
33
|
otelServiceName: z.ZodDefault<z.ZodString>;
|
|
18
|
-
mcpAuthMode: z.ZodDefault<z.ZodEnum<
|
|
34
|
+
mcpAuthMode: z.ZodDefault<z.ZodEnum<{
|
|
35
|
+
"msads-bearer": "msads-bearer";
|
|
36
|
+
jwt: "jwt";
|
|
37
|
+
none: "none";
|
|
38
|
+
}>>;
|
|
19
39
|
msadsCampaignApiBaseUrl: z.ZodDefault<z.ZodString>;
|
|
20
40
|
msadsReportingApiBaseUrl: z.ZodDefault<z.ZodString>;
|
|
21
41
|
msadsCustomerApiBaseUrl: z.ZodDefault<z.ZodString>;
|
|
@@ -26,62 +46,16 @@ declare const ConfigSchema: z.ZodObject<{
|
|
|
26
46
|
msadsAccountId: z.ZodOptional<z.ZodString>;
|
|
27
47
|
msadsReportPollIntervalMs: z.ZodDefault<z.ZodNumber>;
|
|
28
48
|
msadsReportMaxPollAttempts: z.ZodDefault<z.ZodNumber>;
|
|
29
|
-
},
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
mcpAuthMode: "msads-bearer" | "jwt" | "none";
|
|
34
|
-
msadsCampaignApiBaseUrl: string;
|
|
35
|
-
msadsReportingApiBaseUrl: string;
|
|
36
|
-
msadsCustomerApiBaseUrl: string;
|
|
37
|
-
msadsRateLimitPerMinute: number;
|
|
38
|
-
msadsReportPollIntervalMs: number;
|
|
39
|
-
msadsReportMaxPollAttempts: number;
|
|
49
|
+
}, z.core.$strip>;
|
|
50
|
+
export type AppConfig = z.infer<typeof ConfigSchema>;
|
|
51
|
+
export declare function parseConfig(): AppConfig;
|
|
52
|
+
export declare const mcpConfig: {
|
|
40
53
|
host: string;
|
|
41
54
|
nodeEnv: "development" | "production" | "test";
|
|
42
55
|
mcpStatefulSessionTimeoutMs: number;
|
|
43
|
-
logLevel: "
|
|
44
|
-
mcpLogLevel: "
|
|
56
|
+
logLevel: "error" | "info" | "debug" | "warning" | "notice";
|
|
57
|
+
mcpLogLevel: "error" | "info" | "debug" | "warning" | "notice";
|
|
45
58
|
otelEnabled: boolean;
|
|
46
|
-
msadsAccessToken?: string | undefined;
|
|
47
|
-
msadsDeveloperToken?: string | undefined;
|
|
48
|
-
msadsCustomerId?: string | undefined;
|
|
49
|
-
msadsAccountId?: string | undefined;
|
|
50
|
-
mcpAuthSecretKey?: string | undefined;
|
|
51
|
-
mcpAllowedOrigins?: string | undefined;
|
|
52
|
-
otelExporterOtlpTracesEndpoint?: string | undefined;
|
|
53
|
-
otelExporterOtlpMetricsEndpoint?: string | undefined;
|
|
54
|
-
gcsBucketName?: string | undefined;
|
|
55
|
-
}, {
|
|
56
|
-
serviceName?: string | undefined;
|
|
57
|
-
port?: number | undefined;
|
|
58
|
-
otelServiceName?: string | undefined;
|
|
59
|
-
mcpAuthMode?: "msads-bearer" | "jwt" | "none" | undefined;
|
|
60
|
-
msadsCampaignApiBaseUrl?: string | undefined;
|
|
61
|
-
msadsReportingApiBaseUrl?: string | undefined;
|
|
62
|
-
msadsCustomerApiBaseUrl?: string | undefined;
|
|
63
|
-
msadsRateLimitPerMinute?: number | undefined;
|
|
64
|
-
msadsAccessToken?: string | undefined;
|
|
65
|
-
msadsDeveloperToken?: string | undefined;
|
|
66
|
-
msadsCustomerId?: string | undefined;
|
|
67
|
-
msadsAccountId?: string | undefined;
|
|
68
|
-
msadsReportPollIntervalMs?: number | undefined;
|
|
69
|
-
msadsReportMaxPollAttempts?: number | undefined;
|
|
70
|
-
host?: string | undefined;
|
|
71
|
-
nodeEnv?: "development" | "production" | "test" | undefined;
|
|
72
|
-
mcpStatefulSessionTimeoutMs?: number | undefined;
|
|
73
|
-
mcpAuthSecretKey?: string | undefined;
|
|
74
|
-
mcpAllowedOrigins?: string | undefined;
|
|
75
|
-
logLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
|
|
76
|
-
mcpLogLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
|
|
77
|
-
otelEnabled?: boolean | undefined;
|
|
78
|
-
otelExporterOtlpTracesEndpoint?: string | undefined;
|
|
79
|
-
otelExporterOtlpMetricsEndpoint?: string | undefined;
|
|
80
|
-
gcsBucketName?: string | undefined;
|
|
81
|
-
}>;
|
|
82
|
-
export type AppConfig = z.infer<typeof ConfigSchema>;
|
|
83
|
-
export declare function parseConfig(): AppConfig;
|
|
84
|
-
export declare const mcpConfig: {
|
|
85
59
|
serviceName: string;
|
|
86
60
|
port: number;
|
|
87
61
|
otelServiceName: string;
|
|
@@ -92,21 +66,16 @@ export declare const mcpConfig: {
|
|
|
92
66
|
msadsRateLimitPerMinute: number;
|
|
93
67
|
msadsReportPollIntervalMs: number;
|
|
94
68
|
msadsReportMaxPollAttempts: number;
|
|
95
|
-
host: string;
|
|
96
|
-
nodeEnv: "development" | "production" | "test";
|
|
97
|
-
mcpStatefulSessionTimeoutMs: number;
|
|
98
|
-
logLevel: "debug" | "info" | "notice" | "warning" | "error";
|
|
99
|
-
mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
|
|
100
|
-
otelEnabled: boolean;
|
|
101
|
-
msadsAccessToken?: string | undefined;
|
|
102
|
-
msadsDeveloperToken?: string | undefined;
|
|
103
|
-
msadsCustomerId?: string | undefined;
|
|
104
|
-
msadsAccountId?: string | undefined;
|
|
105
69
|
mcpAuthSecretKey?: string | undefined;
|
|
106
70
|
mcpAllowedOrigins?: string | undefined;
|
|
71
|
+
mcpAllowedHosts?: string | undefined;
|
|
107
72
|
otelExporterOtlpTracesEndpoint?: string | undefined;
|
|
108
73
|
otelExporterOtlpMetricsEndpoint?: string | undefined;
|
|
109
74
|
gcsBucketName?: string | undefined;
|
|
75
|
+
msadsAccessToken?: string | undefined;
|
|
76
|
+
msadsDeveloperToken?: string | undefined;
|
|
77
|
+
msadsCustomerId?: string | undefined;
|
|
78
|
+
msadsAccountId?: string | undefined;
|
|
110
79
|
};
|
|
111
80
|
export {};
|
|
112
81
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,QAAA,MAAM,YAAY
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmChB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAErD,wBAAgB,WAAW,IAAI,SAAS,CAkCvC;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAgB,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -3,33 +3,23 @@ import { mcpConfig } from "./config/index.js";
|
|
|
3
3
|
import { createMcpServer, runStdioServer } from "./mcp-server/server.js";
|
|
4
4
|
import { startHttpServer } from "./mcp-server/transports/streamable-http-transport.js";
|
|
5
5
|
import { initializeOpenTelemetry, otelLogMixin } from "@cesteral/shared";
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
8
|
-
import {
|
|
6
|
+
import { detectTransportMode, createServerLogger, bootstrapMcpServer, createStdioSessionSetup, } from "@cesteral/shared";
|
|
7
|
+
import { sessionServiceStore } from "./services/session-services.js";
|
|
8
|
+
import { buildEnvAuthAdapter, buildSessionServices } from "./services/session-wiring.js";
|
|
9
9
|
import { rateLimiter } from "./utils/platform.js";
|
|
10
|
+
import { allTools } from "./mcp-server/tools/index.js";
|
|
10
11
|
const transportMode = detectTransportMode();
|
|
11
12
|
const logger = createServerLogger("msads-mcp", transportMode, otelLogMixin());
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
await authAdapter.validate();
|
|
21
|
-
const services = createSessionServices(authAdapter, {
|
|
22
|
-
campaignApiBaseUrl: mcpConfig.msadsCampaignApiBaseUrl,
|
|
23
|
-
reportingApiBaseUrl: mcpConfig.msadsReportingApiBaseUrl,
|
|
24
|
-
customerApiBaseUrl: mcpConfig.msadsCustomerApiBaseUrl,
|
|
25
|
-
reportPollIntervalMs: mcpConfig.msadsReportPollIntervalMs,
|
|
26
|
-
reportMaxPollAttempts: mcpConfig.msadsReportMaxPollAttempts,
|
|
27
|
-
}, logger, rateLimiter);
|
|
28
|
-
sessionServiceStore.set(sessionId, services);
|
|
29
|
-
logger.info("Stdio session services created successfully");
|
|
30
|
-
return true;
|
|
31
|
-
}
|
|
13
|
+
const setupStdioCredentials = createStdioSessionSetup({
|
|
14
|
+
sessionServiceStore,
|
|
15
|
+
logger,
|
|
16
|
+
buildEnvAdapter: () => buildEnvAuthAdapter(mcpConfig),
|
|
17
|
+
buildServices: (adapter) => buildSessionServices(mcpConfig, adapter, logger),
|
|
18
|
+
missingCredentialsWarning: "No Microsoft Ads credentials found in env vars. " +
|
|
19
|
+
"Set MSADS_ACCESS_TOKEN, MSADS_DEVELOPER_TOKEN, MSADS_CUSTOMER_ID, and MSADS_ACCOUNT_ID for stdio mode.",
|
|
20
|
+
});
|
|
32
21
|
bootstrapMcpServer({
|
|
22
|
+
tools: allTools,
|
|
33
23
|
serviceName: "msads-mcp",
|
|
34
24
|
config: mcpConfig,
|
|
35
25
|
logger,
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;AAC5C,MAAM,MAAM,GAAG,kBAAkB,CAAC,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;AAG9E,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;IACpD,mBAAmB;IACnB,MAAM;IACN,eAAe,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC;IACrD,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;IAC5E,yBAAyB,EACvB,kDAAkD;QAClD,wGAAwG;CAC3G,CAAC,CAAC;AAEH,kBAAkB,CAAC;IAEjB,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE,WAAW;IACxB,MAAM,EAAE,SAAS;IACjB,MAAM;IACN,aAAa;IACb,QAAQ,EAAE,uBAAuB;IACjC,iBAAiB,EAAE,qBAAqB;IACxC,eAAe;IACf,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE;CACxC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACf,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,2BAA2B,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { Prompt } from "@modelcontextprotocol/
|
|
1
|
+
import type { Prompt } from "@modelcontextprotocol/server";
|
|
2
2
|
export declare const msadsBulkOperationsWorkflowPrompt: Prompt;
|
|
3
3
|
export declare function getMsAdsBulkOperationsWorkflowMessage(): string;
|
|
4
4
|
//# sourceMappingURL=bulk-operations-workflow.prompt.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bulk-operations-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,
|
|
1
|
+
{"version":3,"file":"bulk-operations-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,eAAO,MAAM,iCAAiC,EAAE,MAI/C,CAAC;AAEF,wBAAgB,qCAAqC,IAAI,MAAM,CAqD9D"}
|
|
@@ -10,17 +10,21 @@ export function getMsAdsBulkOperationsWorkflowMessage() {
|
|
|
10
10
|
\`\`\`json
|
|
11
11
|
msads_bulk_create_entities({
|
|
12
12
|
"entityType": "keyword",
|
|
13
|
+
"adGroupId": "123",
|
|
13
14
|
"items": [
|
|
14
|
-
{ "
|
|
15
|
-
{ "
|
|
15
|
+
{ "Text": "keyword 1", "MatchType": "Phrase", "Bid": { "Amount": 1.50 } },
|
|
16
|
+
{ "Text": "keyword 2", "MatchType": "Exact", "Bid": { "Amount": 2.00 } }
|
|
16
17
|
]
|
|
17
18
|
})
|
|
18
19
|
\`\`\`
|
|
20
|
+
Every item in one call belongs to one parent, passed as \`accountId\` (campaign, adExtension),
|
|
21
|
+
\`campaignId\` (adGroup) or \`adGroupId\` (ad, keyword) and sent as the request-body parent element.
|
|
19
22
|
|
|
20
23
|
## Bulk Update Status (Pause/Activate)
|
|
21
24
|
\`\`\`json
|
|
22
25
|
msads_bulk_update_status({
|
|
23
26
|
"entityType": "campaign",
|
|
27
|
+
"accountId": "789012",
|
|
24
28
|
"entityIds": ["111", "222", "333"],
|
|
25
29
|
"status": "Paused"
|
|
26
30
|
})
|
|
@@ -30,13 +34,15 @@ msads_bulk_update_status({
|
|
|
30
34
|
\`\`\`json
|
|
31
35
|
msads_adjust_bids({
|
|
32
36
|
"entityType": "keyword",
|
|
37
|
+
"scope": { "adGroupId": "123" },
|
|
33
38
|
"adjustments": [
|
|
34
39
|
{ "entityId": "111", "bidField": "Bid", "newBid": 1.75 },
|
|
35
40
|
{ "entityId": "222", "bidField": "Bid", "newBid": 2.25 }
|
|
36
41
|
]
|
|
37
42
|
})
|
|
38
43
|
\`\`\`
|
|
39
|
-
The adjust-bids tool
|
|
44
|
+
The adjust-bids tool reads the entities first, then sends a minimal Update with each bid as a
|
|
45
|
+
Bid object (\`{ "Amount": newBid }\`), so no other field is touched.
|
|
40
46
|
|
|
41
47
|
## Batch Limits
|
|
42
48
|
| Entity | Batch Limit |
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bulk-operations-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,iCAAiC,GAAW;IACvD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,+DAA+D;IAC5E,SAAS,EAAE,EAAE;CACd,CAAC;AAEF,MAAM,UAAU,qCAAqC;IACnD,OAAO
|
|
1
|
+
{"version":3,"file":"bulk-operations-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,iCAAiC,GAAW;IACvD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,+DAA+D;IAC5E,SAAS,EAAE,EAAE;CACd,CAAC;AAEF,MAAM,UAAU,qCAAqC;IACnD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDR,CAAC;AACF,CAAC"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { Prompt } from "@modelcontextprotocol/
|
|
1
|
+
import type { Prompt } from "@modelcontextprotocol/server";
|
|
2
2
|
export declare const campaignSetupWorkflowPrompt: Prompt;
|
|
3
3
|
export declare function getCampaignSetupWorkflowMessage(args?: Record<string, string>): string;
|
|
4
4
|
//# sourceMappingURL=campaign-setup-workflow.prompt.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"campaign-setup-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,
|
|
1
|
+
{"version":3,"file":"campaign-setup-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,eAAO,MAAM,2BAA2B,EAAE,MAWzC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAwIrF"}
|
|
@@ -21,8 +21,8 @@ msads_create_entity({
|
|
|
21
21
|
"data": {
|
|
22
22
|
"Budgets": [{
|
|
23
23
|
"Name": "Q1 2026 Budget",
|
|
24
|
-
"Amount":
|
|
25
|
-
"BudgetType": "
|
|
24
|
+
"Amount": 100.00,
|
|
25
|
+
"BudgetType": "DailyBudgetStandard"
|
|
26
26
|
}]
|
|
27
27
|
}
|
|
28
28
|
})
|
|
@@ -129,7 +129,9 @@ msads_manage_ad_extensions({
|
|
|
129
129
|
\`\`\`json
|
|
130
130
|
msads_update_entity({
|
|
131
131
|
"entityType": "campaign",
|
|
132
|
-
"
|
|
132
|
+
"entityId": "{campaignId}",
|
|
133
|
+
"accountId": "${args?.accountId || "{accountId}"}",
|
|
134
|
+
"data": { "Status": "Active" }
|
|
133
135
|
})
|
|
134
136
|
\`\`\`
|
|
135
137
|
|