Skip to main content
Glama

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.

npm version License: MIT Add Synter to Amp

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."

Related MCP server: flour-ads

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.

Available Tools

21 tools
add_keywordsB
Destructive

Add keywords to a Google Ads campaign or ad group.

Inputs: ad_group_id (required), keywords (required), match_type.

add_negative_keywordsB
Destructive

Add negative keywords to block unwanted search terms.

Inputs: campaign_id (required), keywords (required), level.

create_conversionA
Destructive

Create a conversion action in Google Ads. Returns the conversion ID and label for GTM setup.

Inputs: name (required), value, category.

create_display_campaignB
Destructive

Create a Google Ads Display campaign with responsive display ads. Supports image uploads from URLs.

Inputs: campaign_name (required), daily_budget (required), headlines (required), descriptions (required), +5 more.

create_linkedin_campaignC
Destructive

Create a LinkedIn Ads campaign for B2B advertising.

Inputs: name (required), objective (required), daily_budget (required), target_company_sizes, +2 more.

create_meta_campaignC
Destructive

Create a Meta (Facebook/Instagram) advertising campaign.

Inputs: name (required), objective (required), daily_budget (required).

create_pmax_campaignB
Destructive

Create a Google Ads Performance Max campaign. Requires images, headlines, descriptions, and a business name.

Inputs: campaign_name (required), daily_budget (required), headlines (required), long_headline (required), +8 more.

create_reddit_campaignA
Destructive

Create a Reddit Ads campaign for community-based advertising.

Inputs: name (required), objective (required), daily_budget (required), subreddits, +1 more.

create_search_campaignA
Destructive

Create a Google Ads Search campaign with keywords. Sets up campaign, ad group, keywords, and responsive search ads.

Inputs: campaign_name (required), daily_budget (required), keywords (required), headlines (required), +3 more.

diagnose_trackingA
Read-only

Check if conversion tracking is properly set up on a website. Verifies gtag.js, GTM, and pixel installation.

Inputs: url (required).

generate_imageB
Destructive

Generate an AI image for ad creatives using Imagen 4, Flux, or Stable Diffusion.

Inputs: prompt (required), size, provider, name.

generate_videoB
Destructive

Generate an AI video ad using Veo, Runway, or Luma. Great for YouTube and social ads.

Inputs: product_name (required), key_benefit (required), concept, target_audience, +2 more.

get_daily_spendA
Read-only

Get daily spend breakdown across all connected ad accounts.

Inputs: days, platform.

get_performanceB
Read-only

Get performance metrics (impressions, clicks, spend, conversions, ROAS) for campaigns.

Inputs: platform, campaign_id, date_range.

list_ad_accountsA
Read-only

List all connected ad accounts across platforms.

Inputs: no named parameters.

list_campaignsA
Read-only

List all campaigns across connected ad platforms. Returns campaign name, status, budget, and performance metrics.

Inputs: platform, status, limit.

list_conversionsA
Read-only

List all conversion actions configured in Google Ads.

Inputs: no named parameters.

pause_campaignB
Destructive

Pause a campaign by ID. Works across all connected platforms.

Inputs: campaign_id (required), platform (required).

run_toolA
Destructive

Run any Synter tool by name. Use this for advanced operations not covered by other tools. See docs.syntermedia.ai for full tool list.

Inputs: script_name (required), args, platform.

update_campaign_budgetA
Destructive

Update the daily budget for a campaign.

Inputs: campaign_id (required), platform (required), daily_budget (required).

upload_imageB
Destructive

Upload an image as an asset for use in ads.

Inputs: image_url (required), asset_name (required), platform.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 21 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific ad platform operations (e.g., create_search_campaign vs. create_display_campaign), but 'run_tool' introduces ambiguity as it overlaps with other tools by allowing execution of unspecified operations. The other 20 tools are well-differentiated by platform and action.

    Naming Consistency5/5

    Tool names follow a consistent verb_noun pattern throughout (e.g., create_search_campaign, list_campaigns, update_campaign_budget), with clear and predictable naming conventions. There are no deviations in style or structure across the set.

    Tool Count4/5

    With 21 tools, the count is slightly high but reasonable for a multi-platform ad management server, covering operations across Google Ads, Meta, LinkedIn, and Reddit. It feels comprehensive without being overly bloated, though it borders on the upper limit of typical scope.

    Completeness4/5

    The tool set provides strong coverage for ad campaign creation, management, and performance tracking across multiple platforms, with clear CRUD-like operations (e.g., create, list, pause, update). Minor gaps exist, such as no explicit tools for deleting campaigns or editing ad creatives, but agents can likely work around these using available tools like 'run_tool' or platform-specific updates.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for managing ad campaigns across Google Ads, Meta, and more. Enables deploying campaigns, checking performance, and managing budgets from terminal or AI assistants.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server that enables AI agents (Claude Code) to manage Criteo campaigns, ad sets, creatives, audiences, and reports via natural language.
      -