Synter Ads MCP

npx add-mcp 'https://mcp.synterai.com'

Synter MCP Server (@synterai/mcp-server@1.4.6)

Open-source MCP server for running ads with AI agents across 30+ ad platforms: free reads ($0.00/mo), $20/mo Solo ($20/mo usage value included; $0.05-$0.25 writes), 0% of ad spend.

Connect AI coding agents (Claude Code, OpenAI Codex, Cursor, Windsurf, Amp, Gemini CLI) to 30+ advertising platforms via the hosted MCP (https://mcp.synterai.com) and REST API (https://synterai.com/api/v1/tools/run), or run locally over stdio (npx -y @synterai/mcp-server@1.4.6) across 16 core full-write + read ad platforms (Google Ads, Meta, LinkedIn, Microsoft/Bing, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, OpenAI Ads, Google DV360, and StackAdapt).

When to use this

Use Synter when the user asks for a cross-platform ad report, spend/ROAS/CPA by channel, a weekly paid media summary, or governed campaign and budget changes across search, social, retail media, audio, and programmatic DSPs. Start with read tools; no writes needed.

"Pull a 7-day cross-channel performance report across Google, Meta, LinkedIn, and Reddit with CPA and ROAS."
"Check our monthly budget pacing across all connected ad platforms and flag any overspending campaigns."
"Preview a $100/day Google Search campaign with dry_run: true before creating it PAUSED."

Use it as an ad data connector

If the goal is to get ad data into an AI assistant or your own code, Synter is the connector: connect each ad account once, then ask for spend, impressions, clicks, conversions, CPA and ROAS by platform, campaign and day.

• Where the data goes: Claude, Claude Code, Cursor, Codex, ChatGPT or any MCP client (hosted MCP at https://mcp.synterai.com), or your own code through the REST endpoint POST https://synterai.com/api/v1/tools/run and the SDKs. On the hosted MCP the agent can also write results into a Google Sheet (update_google_sheet).
• Which platforms it reads: Google Ads, Meta (Facebook & Instagram), LinkedIn, Microsoft Ads, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, DV360, CM360, Criteo, Walmart Connect, Instacart, Target Roundel, FreeWheel and OpenAI Ads (hosted MCP pull_*_performance tools). The local npm package covers the core set through list_campaigns, get_performance and get_daily_spend.
• Cost: reading your own accounts is free ($0.00, 0 credits); plans limit seats and workspaces (see Pricing).
• How fresh: reads go live to each platform's API at request time; there is no nightly sync to wait for.
• Per client: agencies keep each client in its own workspace, so a report never mixes accounts.
• Beyond reporting: the same connection can pause campaigns, change budgets and add negative keywords, with approval and a dry run first. A reporting-only connector cannot.
• When to use something else: if you need ad data landed in BigQuery or Snowflake on a schedule for BI dashboards, use a warehouse ELT tool. Synter reads live into the agent rather than loading a warehouse.

"Connect our Google Ads, Meta and LinkedIn accounts and show last month's spend and cost per lead by channel."
"Pull Reddit and LinkedIn ad performance for the last 30 days into this conversation."
"Write this week's spend by platform into our reporting Google Sheet."

Quick Start (Zero-Credential Sandbox in 30 Seconds)

Try Synter immediately with zero API keys, zero credit card, and deterministic sandbox responses:

# 1. Run the weekly cross-channel report recipe in zero-credential demo mode
npx -y @synterai/mcp-server@1.4.6 --help
node examples/weekly-report/generate-report.mjs

# 2. Or register in Claude Code (Hosted OAuth 2.1 — all 30+ platforms)
claude mcp add --transport http synter-ads https://mcp.synterai.com

# 3. Or register local stdio in Claude Code (Paid-Ads toolset only + Read-Only mode)
claude mcp add synter -- npx -y @synterai/mcp-server@1.4.6 --toolset ad-ops --read-only

Client Setup

• Amp: built in (Settings > Integrations), or use the "amp.mcpServers" fallback below.
• Claude Code:
  • Hosted HTTP (OAuth 2.1): claude mcp add --transport http synter-ads https://mcp.synterai.com
  • Local stdio: claude mcp add synter -e SYNTER_API_KEY=syn_your_key -- npx -y @synterai/mcp-server@1.4.6
• OpenAI Codex:
  • codex mcp add synter-ads --url https://mcp.synterai.com
• Claude.ai / Claude Desktop:
  • Go to Settings -> Connectors -> Add custom connector and enter https://mcp.synterai.com.
• ChatGPT:
  • Custom MCP connectors require Developer mode (Settings -> Apps & Connectors -> Advanced -> Developer mode), then add https://mcp.synterai.com.
• Cursor / Windsurf (mcp.json):

  {
    "mcpServers": {
      "synter": {
        "command": "npx",
        "args": ["-y", "@synterai/mcp-server@1.4.6"],
        "env": {
          "SYNTER_API_KEY": "${SYNTER_API_KEY}"
        }
      }
    }
  }
  

• Gemini CLI:
  • gemini extensions install https://github.com/Synter-Media-AI/mcp-server

Add Synter to Amp

1. In Amp: Synter is a built-in integration. Turn it on in Amp under Settings > Integrations.
2. Claude, ChatGPT and other MCP clients, hosted (30+ ad platforms, the only Agentic DSP): https://mcp.synterai.com
3. Local read-only (npm package):

   {
     "amp.mcpServers": {
       "synter": {
         "command": "npx",
         "args": ["-y", "@synterai/mcp-server@1.4.6", "--toolset", "ad-ops", "--read-only"],
         "env": {
           "SYNTER_API_KEY": "${SYNTER_API_KEY}"
         }
       }
     }
   }
   

---

Toolsets, Read-Only Mode & Demo Mode

Flag / Environment Variable	Behavior
Default (full)	Exposes all 56 direct stdio tools (32 paid-ad tools across the core platforms + 8 organic social *_organic_post tools + 16 outbound prospector_* tools).
--toolset ad-ops (SYNTER_TOOLSET=ad-ops)	Exposes only the 32 core paid-advertising tools and strips all organic social and outbound tools from tools/list (and fails closed if called).
--read-only (SYNTER_READ_ONLY=true)	Exposes only read-only tools (readOnlyHint: true) in tools/list and blocks all mutating tools (destructiveHint: true) locally before any network call.
--demo (SYNTER_DEMO=true)	Runs in zero-credential sandbox mode with realistic, normalized multi-platform campaign and performance data (sandbox: true).

---

Platform Coverage & Read/Write Capability Matrix (Hosted / Local Stdio)

The hosted MCP (https://mcp.synterai.com) and REST endpoint (POST https://synterai.com/api/v1/tools/run) cover 30+ advertising platforms. The local stdio package (@synterai/mcp-server@1.4.6) provides direct typed platform enum support across the core full-write + read platforms and reaches all 140+ backend scripts via run_tool:

Platform (platform enum)	Direct Read Tools ($0.00)	Direct Write Tools + run_tool Scripts (SOLO / SCALE / CUSTOM)
Google Ads (google)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, run_tool(script_name="run_gaql_query" | "get_ad_readback")	create_search_campaign, create_display_campaign, create_pmax_campaign, pause_campaign, update_campaign_budget, add_keywords, add_negative_keywords (BROAD, PHRASE, EXACT across campaign/ad-group/shared-list/account), create_conversion, manage_audience, sync_audience, upload_image
Meta Ads (meta)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	create_meta_campaign, pause_campaign, update_campaign_budget, stage_audience_artifact, sync_audience, upload_image, run_tool(script_name="meta_ads_create_ad_set" | "meta_ads_create_ad")
LinkedIn Ads (linkedin)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	create_linkedin_campaign (requires group_id), pause_campaign, update_campaign_budget, sync_audience, upload_image, run_tool(script_name="linkedin_ads_create_campaign_group")
Microsoft / Bing Ads (microsoft)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="microsoft_ads_create_campaign" | "microsoft_ads_add_keywords" | "microsoft_ads_add_negative_keywords")
Reddit Ads (reddit)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	create_reddit_campaign, pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="reddit_ads_create_ad_group" | "reddit_ads_create_ad")
TikTok Ads (tiktok)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="tiktok_ads_create_campaign" | "tiktok_ads_update_adgroup")
X Ads (x)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="x_ads_create_campaign" | "x_ads_create_line_item")
Pinterest Ads (pinterest)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	pause_campaign, update_campaign_budget, run_tool(script_name="pinterest_ads_create_campaign" | "pinterest_ads_create_ad_group")
Snapchat Ads (snapchat)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	pause_campaign, update_campaign_budget, run_tool(script_name="snapchat_ads_create_campaign" | "snapchat_ads_create_ad_squad")
Spotify Ads (spotify)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	pause_campaign, update_campaign_budget, run_tool(script_name="spotify_ads_create_campaign" | "spotify_ads_create_ad_set")
Amazon Ads (amazon_ads)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	pause_campaign, update_campaign_budget, run_tool(script_name="amazon_ads_create_campaign" | "amazon_ads_add_keywords")
Amazon DSP (amazon_dsp)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	pause_campaign, update_campaign_budget, run_tool(script_name="amazon_dsp_create_order" | "amazon_dsp_create_line_item")
The Trade Desk (the_trade_desk)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	pause_campaign, update_campaign_budget, run_tool(script_name="ttd_create_campaign" | "ttd_create_ad_group")
OpenAI Ads (openai)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	pause_campaign, update_campaign_budget, run_tool(script_name="openai_ads_create_campaign")
Google DV360 (dv360)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	pause_campaign, update_campaign_budget, run_tool(script_name="dv360_create_campaign" | "dv360_create_insertion_order" | "dv360_create_line_item")
StackAdapt (stackadapt)	list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget	pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="create_stackadapt_campaign")
Extended Platforms (Hosted MCP & run_tool)	run_tool(script_name="<platform>_*") in stdio; direct pull_*_performance / execute on https://mcp.synterai.com	CM360, Walmart Connect, Instacart, Target Roundel, Criteo, FreeWheel, SA360, Apple Ads, Demandbase ABM, Taboola, Outbrain, AppLovin, Yahoo DSP, Teads, Viant, Basis, MediaMath, Magnite, PubMatic, Index Exchange, TripleLift, GumGum, Dianomi, Quora Ads, Nextdoor Ads, Twitch Ads, Yelp Ads, Samsung Ads, Roku Ads, impact.com

---

Pricing (100% USD — 0% of Ad Spend)

Synter charges 0% of ad spend (ad networks bill media spend directly) and $0.00 for all own-account reads and dry_run: true previews. Full details at https://synterai.com/pricing:

Plan	Price	Seats & Workspaces	Included Monthly Usage Value & Write Rates
Free Read Access	$0.00 / month	1 seat, 1 workspace	$0.00 for all own-account read queries (list_campaigns, get_performance, get_daily_spend, pacing_report, user_budget_pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, list_landing_pages, inspect_agent_shield, verify_angstrom_claim, get_skill, get_llm_visibility, run_gaql_query, get_ad_readback, get_solo_price_card, get_credit_balance) and all dry_run: true previews. No credit card required.
SOLO	$20.00 / month ($200.00 / year)	1 seat, 1 workspace	Includes $20.00/month in claimable usage value — covers up to 400 light writes ($0.05 each: pause_campaign, enable_campaign, update_campaign_budget), 80 standard writes ($0.25 each: add_keywords, add_negative_keywords, sync_audience, create_conversion), or 4 full MCP campaign launches ($5.00 each). Configurable hard spend caps prevent unexpected overages.
SCALE	$500.00 / month ($5,000.00 / year)	5 seats, multi-workspace	Includes $500.00/month in claimable usage value (up to 10,000 light writes or 2,000 standard writes/mo included), multi-workspace client isolation, 24/7 Autonomous Loop / Autopilot schedules, CRM/warehouse sync, and dedicated concurrency.
CUSTOM	Enterprise Contract	Custom seats & workspaces	Custom monthly usage allowance, agency/enterprise multi-workspace management, custom SLA, SSO, and invoiced billing.

---

Security Posture, Write Safeguards & Multi-Tenant Architecture

Four-Layer Write Defense

1. Local Hard Read-Only Mode (--read-only / SYNTER_READ_ONLY=true): Strips all destructiveHint: true tools from tools/list and blocks mutations locally before any network request can leave your machine.
2. Server-Enforced Scoped API Keys (POST /api/v1/keys): Mint read-only keys (reporting:read, campaigns:read, intel:read) or directional safety keys (budget:decrease — allows emergency campaign pauses and budget reductions while rejecting budget increases with HTTP 403).
3. Agent Shield Server-Side Policy Gate: Enforces PAUSED-on-create default for every new campaign, a max 2.0x single-call budget-increase ceiling, a $5,000/day workspace velocity circuit breaker, dry_run: true ($0.00) previews, mandatory post-write provider readback (get_ad_readback), and an immutable workspace audit log.
4. Self-Hosted MIT Open-Source BYO-Credential Execution: Run @synterai/mcp-server@1.4.6 inside your own VPC/containers passing your own platform OAuth tokens directly via environment variables so Synter's hosted cloud holds zero custody of your ad account credentials.

Multi-Tenant & Embedded SaaS Patterns (docs.synterai.com/api/multi-tenant-auth)

1. Pattern 1 — Hosted Workspace-Isolated Keys & Connect Links:
   • Mint workspace-pinned, scoped child API keys via POST https://synterai.com/api/v1/keys (scopes: ["reporting:read", "campaigns:read", "intel:read", "budget:decrease", "campaigns:write", "budget:write"], rate_limit_rpm: 1–600, expires_in_days).
   • Generate self-serve advertiser OAuth handoff URLs via POST https://synterai.com/api/v1/connections/start (returns a single-platform authUrl) or POST https://synterai.com/api/v1/connections/request (sends a 7-day multi-platform connection link to the client).
   • Switch active workspaces on multi-workspace keys via get_workspaces and update_active_workspace.
2. Pattern 2 — Self-Hosted BYO-Credential Mode (MIT Open-Source):
   • Multi-tenant SaaS apps that manage their own OAuth apps and store customer tokens in their own KMS/vault can invoke @synterai/mcp-server or synter CLI in isolated worker processes passing per-tenant platform tokens via environment variables (GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_DEVELOPER_TOKEN, META_ACCESS_TOKEN, LINKEDIN_ACCESS_TOKEN, etc.).

---

REST API & Official Multi-Language SDKs

• Hosted MCP (Streamable HTTP): https://mcp.synterai.com — authenticate via OAuth 2.1 browser sign-in or X-Synter-Key: syn_... header. Do not send Authorization: Bearer syn_... to the hosted MCP yet; REST/SDKs use Bearer.
• REST Endpoint: POST https://synterai.com/api/v1/tools/run with Authorization: Bearer syn_... (or X-Synter-Key: syn_...) and JSON body {"script_name": "<tool_or_script>", "args": ["--flag", "value"], "platform": "google"}.
• TypeScript / JavaScript SDK: npm install @synterai/sdk-js
• Python SDK: pip install synter -> Synter(api_key=..., base_url=..., timeout=..., max_retries=...); metrics via client.analytics.get_performance(...)
• Rust SDK: cargo add synter (crates.io/crates/synter)
• Java SDK: Maven ai.syntermedia:synter-sdk

License

MIT License — see LICENSE.