adlyse-ads
Endpoint: https://mcp.adlyse.com/mcp/ads/
Unified cross-platform reads and gated writes over campaigns and ads. Reads hit Adlyse’s platform-normalized data table, so the response shape is identical across every connected ad platform (Google Ads, Meta Ads, Microsoft Ads, ChatGPT Ads). Writes hit the live platform adapters and auto-register a DecisionLogEntry so get_impact_analysis can correlate future metric shifts with what you just did.
Tools#
Reads#
| Tool | Purpose |
|---|---|
list_campaigns | Distinct campaigns for an account |
get_performance | Aggregated metrics over a date range, optionally grouped |
list_ads | Distinct ads (creatives) — drill-down from campaign to ad |
get_ad_performance | Per-ad metric aggregation over a date range |
list_change_events | Campaign / ad-set / creative changes picked up by sync |
list_creative_library | The org’s persisted creatives — copy, media URLs, 30d rollups |
list_experiments | Autonomous creative experiments (A/B tests), newest first |
get_experiment | One experiment with arms + final report |
Writes (preview-safe)#
| Tool | Purpose |
|---|---|
update_campaign_status | Pause / resume / remove a campaign |
update_campaign_budget | Change daily budget (Google via automatic budget-resource lookup, Meta, Microsoft) |
update_ad_group_status | Pause / resume an ad group (Meta: ad set) |
update_ad_status | Pause / resume a single ad (Google / Meta) |
Experiment control (user-bound credential required)#
These writes must be attributable to a person: connect via OAuth or use a personal API key. Organization API keys get error_type: "user_credential_required".
| Tool | Purpose |
|---|---|
pause_experiment | Pause a running experiment |
resume_experiment | Resume a paused experiment (window extends by the pause) |
stop_experiment | Stop before conclusion (irreversible; restores source entity) |
Every write tool accepts preview: true for a local-only diff that doesn’t call the platform. Apply with preview: false; on success, Adlyse creates a DecisionLogEntry automatically.
Source tags#
adlyse.ads_campaigns@v1adlyse.ads_performance@v1adlyse.ads_ads@v1adlyse.ads_ad_performance@v1adlyse.ads_change_events@v1adlyse.ads_writes@v1
Common errors#
error_type | Typical cause |
|---|---|
auth_error | Missing / invalid API key |
not_found | Ad account / campaign / ad isn’t in your org or hasn’t been synced yet |
validation_error | Bad status enum, malformed dates, unsupported metric, empty inputs |
unsupported_for_platform | Platforms without a write adapter (e.g. TikTok) or operations a platform doesn’t support |
credentials_missing | Ad account has no linked OAuth credentials; reconnect the account |
platform_error | The platform API rejected the write — no decision is logged on failure |