synter-mcp-server
Synter MCP server connects AI agents to ad platforms for reporting and governed campaign operations.
Read campaigns, ad accounts, performance, daily spend, conversions, and tracking diagnostics across connected platforms.
Create Google Search, Display, and Performance Max campaigns plus Meta, LinkedIn, and Reddit campaigns.
Pause campaigns and update daily budgets.
Add keywords and negative keywords.
Create/list conversion actions and diagnose website tracking (gtag/GTM/pixel).
Generate AI images/videos and upload images as ad assets.
Use
run_toolto execute advanced Synter scripts and broader platform operations.Supports read-only, demo, and ad-ops toolset modes with dry-run/guardrail workflows.
Allows managing advertising campaigns on Amazon Ads and Amazon DSP, including creation, performance monitoring, and budget management.
Provides tools for creating and managing Facebook ad campaigns, generating creative assets, and tracking performance metrics.
Enables creation and management of ads across Google Search and Google Display networks.
Comprehensive integration for managing Search, Display, and Performance Max campaigns, including keyword targeting, bidding adjustments, and conversion tracking.
Supports creating and managing Instagram ad campaigns and creative assets as part of the Meta advertising ecosystem.
Allows agents to manage advertising across Facebook and Instagram, including campaign creation, budget management, and ROAS analysis.
Provides tools for creating and managing Reddit ad campaigns, targeting niche communities, and monitoring daily spend.
Enables management of TikTok advertising campaigns, including campaign creation and performance analytics.
Supports the creation and management of YouTube video ad campaigns and tracking placement performance.
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 endpointPOST https://synterai.com/api/v1/tools/runand 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_*_performancetools). The local npm package covers the core set throughlist_campaigns,get_performanceandget_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-onlyClient 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.comLocal 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
In Amp: Synter is a built-in integration. Turn it on in Amp under Settings > Integrations.
Claude, ChatGPT and other MCP clients, hosted (30+ ad platforms, the only Agentic DSP): https://mcp.synterai.com
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 ( | Exposes all 56 direct stdio tools (32 paid-ad tools across the core platforms + 8 organic social |
| Exposes only the 32 core paid-advertising tools and strips all organic social and outbound tools from |
| Exposes only read-only tools ( |
| Runs in zero-credential sandbox mode with realistic, normalized multi-platform campaign and performance data ( |
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 ( | Direct Read Tools ( | Direct Write Tools + |
Google Ads ( |
|
|
Meta Ads ( |
|
|
LinkedIn Ads ( |
|
|
Microsoft / Bing Ads ( |
|
|
Reddit Ads ( |
|
|
TikTok Ads ( |
|
|
X Ads ( |
|
|
Pinterest Ads ( |
|
|
Snapchat Ads ( |
|
|
Spotify Ads ( |
|
|
Amazon Ads ( |
|
|
Amazon DSP ( |
|
|
The Trade Desk ( |
|
|
OpenAI Ads ( |
|
|
Google DV360 ( |
|
|
StackAdapt ( |
|
|
Extended Platforms (Hosted MCP & |
| 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 ( |
SOLO | $20.00 / month ( | 1 seat, 1 workspace | Includes $20.00/month in claimable usage value — covers up to 400 light writes ( |
SCALE | $500.00 / month ( | 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
Local Hard Read-Only Mode (
--read-only/SYNTER_READ_ONLY=true): Strips alldestructiveHint: truetools fromtools/listand blocks mutations locally before any network request can leave your machine.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 HTTP403).Agent Shield Server-Side Policy Gate: Enforces
PAUSED-on-create default for every new campaign, a max2.0xsingle-call budget-increase ceiling, a$5,000/dayworkspace velocity circuit breaker,dry_run: true($0.00) previews, mandatory post-write provider readback (get_ad_readback), and an immutable workspace audit log.Self-Hosted MIT Open-Source BYO-Credential Execution: Run
@synterai/mcp-server@1.4.6inside 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)
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-platformauthUrl) orPOST 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_workspacesandupdate_active_workspace.
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-serverorsynterCLI 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 orX-Synter-Key: syn_...header. Do not sendAuthorization: Bearer syn_...to the hosted MCP yet; REST/SDKs use Bearer.REST Endpoint:
POST https://synterai.com/api/v1/tools/runwithAuthorization: Bearer syn_...(orX-Synter-Key: syn_...) and JSON body{"script_name": "<tool_or_script>", "args": ["--flag", "value"], "platform": "google"}.TypeScript / JavaScript SDK:
npm install @synterai/sdk-jsPython SDK:
pip install synter->Synter(api_key=..., base_url=..., timeout=..., max_retries=...); metrics viaclient.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 toolsadd_keywordsBDestructive
Add keywords to a Google Ads campaign or ad group.
Inputs: ad_group_id (required), keywords (required), match_type.
add_negative_keywordsBDestructive
Add negative keywords to block unwanted search terms.
Inputs: campaign_id (required), keywords (required), level.
create_conversionADestructive
Create a conversion action in Google Ads. Returns the conversion ID and label for GTM setup.
Inputs: name (required), value, category.
create_display_campaignBDestructive
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_campaignCDestructive
Create a LinkedIn Ads campaign for B2B advertising.
Inputs: name (required), objective (required), daily_budget (required), target_company_sizes, +2 more.
create_meta_campaignCDestructive
Create a Meta (Facebook/Instagram) advertising campaign.
Inputs: name (required), objective (required), daily_budget (required).
create_pmax_campaignBDestructive
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_campaignADestructive
Create a Reddit Ads campaign for community-based advertising.
Inputs: name (required), objective (required), daily_budget (required), subreddits, +1 more.
create_search_campaignADestructive
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_trackingARead-only
Check if conversion tracking is properly set up on a website. Verifies gtag.js, GTM, and pixel installation.
Inputs: url (required).
generate_imageBDestructive
Generate an AI image for ad creatives using Imagen 4, Flux, or Stable Diffusion.
Inputs: prompt (required), size, provider, name.
generate_videoBDestructive
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_spendARead-only
Get daily spend breakdown across all connected ad accounts.
Inputs: days, platform.
get_performanceBRead-only
Get performance metrics (impressions, clicks, spend, conversions, ROAS) for campaigns.
Inputs: platform, campaign_id, date_range.
list_ad_accountsARead-only
List all connected ad accounts across platforms.
Inputs: no named parameters.
list_campaignsARead-only
List all campaigns across connected ad platforms. Returns campaign name, status, budget, and performance metrics.
Inputs: platform, status, limit.
list_conversionsARead-only
List all conversion actions configured in Google Ads.
Inputs: no named parameters.
pause_campaignBDestructive
Pause a campaign by ID. Works across all connected platforms.
Inputs: campaign_id (required), platform (required).
run_toolADestructive
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_budgetADestructive
Update the daily budget for a campaign.
Inputs: campaign_id (required), platform (required), daily_budget (required).
upload_imageBDestructive
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
Scored across 21 tools
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.
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.
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.
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
Related MCP Connectors
Google Ads MCP server: run Search, Display, Demand Gen and PMax campaigns from AI.
Meta Ads MCP server: run Facebook and Instagram campaigns, ad sets, ads and reports from AI.
Hosted MCP server for marketing agencies: connect Google Ads, GA4, Search Console, Meta, LinkedIn and more to Claude or ChatGPT. Pull reports and make changes via OAuth login, no setup.
X Ads (Twitter Ads) MCP server: run X campaigns, ad groups, ads and reports from AI.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server that lets AI agents launch and manage Meta + TikTok ad campaigns autonomously. 1 call 30 seconds to launch.158 npm3MIT
- AlicenseNot gradedqualityDmaintenanceMCP 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
- AlicenseAqualityDmaintenanceMCP server that wraps the Meta Marketing API (Graph API v25.0) as semantic tools for LLM agents.181MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that enables AI agents (Claude Code) to manage Criteo campaigns, ad sets, creatives, audiences, and reports via natural language.-