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 Google Ads, Meta Ads, and TikTok 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 |
Writes (preview-safe)#
| Tool | Purpose |
|---|---|
update_campaign_status | Pause / resume / remove a campaign |
update_campaign_budget | Change daily budget (Meta only in this release) |
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 | TikTok mutations (not yet implemented) or Google budget updates (not wired yet) |
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 |