
Open-source MCP server for AI agents: read across 43 ad platforms, with verified write and create
Open-source MCP server for AI agents: read across 43 ad platforms, with verified write and create across 16 core platforms (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, Amazon, TTD, DV360, StackAdapt & more). Free reads (zsh/mo), /mo Solo for writes, multi-tenant OAuth & REST/SDKs.
·
@synterai/[email protected])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/[email protected]) 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).
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."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.
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).pull_*_performance tools). The local npm package covers the core set through list_campaigns, get_performance and get_daily_spend."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."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/[email protected] --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/[email protected] --toolset ad-ops --read-only"amp.mcpServers" fallback below.claude mcp add --transport http synter-ads https://mcp.synterai.comclaude mcp add synter -e SYNTER_API_KEY=syn_your_key -- npx -y @synterai/[email protected]codex mcp add synter-ads --url https://mcp.synterai.comhttps://mcp.synterai.com.https://mcp.synterai.com.mcp.json):
{
"mcpServers": {
"synter": {
"command": "npx",
"args": ["-y", "@synterai/[email protected]"],
"env": {
"SYNTER_API_KEY": "${SYNTER_API_KEY}"
}
}
}
}gemini extensions install https://github.com/Synter-Media-AI/mcp-server{
"amp.mcpServers": {
"synter": {
"command": "npx",
"args": ["-y", "@synterai/[email protected]", "--toolset", "ad-ops", "--read-only"],
"env": {
"SYNTER_API_KEY": "${SYNTER_API_KEY}"
}
}
}
}| 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). |
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/[email protected]) 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 |
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. |
--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.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).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.@synterai/[email protected] 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.docs.synterai.com/api/multi-tenant-auth)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).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).get_workspaces and update_active_workspace.@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.).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.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"}.npm install @synterai/sdk-jspip install synter -> Synter(api_key=..., base_url=..., timeout=..., max_retries=...); metrics via client.analytics.get_performance(...)cargo add synter (crates.io/crates/synter)ai.syntermedia:synter-sdkMIT License — see LICENSE.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add synter -- npx -y @synterai/[email protected]{
"mcpServers": {
"synter": {
"env": {
"SYNTER_API_KEY": ""
},
"args": [
"-y",
"@synterai/[email protected]"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"synter","env":{"SYNTER_API_KEY":""},"args":["-y","@synterai/[email protected]"],"command":"npx"}'[mcp_servers.synter]
command = "npx"
args = ["-y", "@synterai/[email protected]"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/synter-mcp-server to learn what the "Synter MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx -y @synterai/[email protected] --helpclaude mcp add --transport http synter-ads https://mcp.synterai.com
claude mcp add synter -- npx -y @synterai/[email protected] --toolset ad-ops --read-only| Name | What it does |
|---|---|
list_campaigns | List campaigns for ONE ad platform across all 16 ad platforms. `platform` is required -- this tool does not aggregate across platforms. Returns campaign name, status, budget, and performance metrics. |
create_search_campaign | Create a Google Ads Search campaign with an ad group, responsive search ad, and keywords — all in one atomic request. Supports `dry_run: true` ($0.00 / 0 credits, zero credentials required) to preview |
create_display_campaign | Create a Google Ads Display campaign with responsive display ads. Supports image uploads from URLs, `dry_run: true` ($0.00 / 0 credits, zero credentials required), and server-side safety gates (daily |
create_pmax_campaign | Create a Google Ads Performance Max campaign. Requires images, headlines, descriptions, and a business name. Supports `dry_run: true` ($0.00 / 0 credits, zero credentials required) and server-side saf |
pause_campaign | Pause a campaign by ID across all 16 connected ad platforms. Supports `dry_run: true` ($0.00 / 0 credits, zero credentials required). Live execution is audited in the workspace audit log ($0.05 / 2 cr |
update_campaign_budget | Update the daily budget for a campaign across all 16 connected ad platforms. Supports `dry_run: true` ($0.00 / 0 credits, zero credentials required). Live execution passes the server-side Agent Shield |
get_performance | Get performance metrics (impressions, clicks, spend, conversions, ROAS) for campaigns across any of the 16 ad platforms. Free read-only tool ($0.00 / 0 credits). |
get_daily_spend | Get daily spend breakdown for ONE ad platform across any of the 16 ad platforms. `platform` is required -- this tool does not aggregate across platforms. Free read-only tool ($0.00 / 0 credits). |
pacing_report | Return a deterministic budget-pacing snapshot for the current workspace across every connected ad platform and the overall portfolio (month-to-date spend, today's spend, expected spend to date, pacing |
user_budget_pacing_report | Return a deterministic per-user/trader budget ownership and pacing snapshot from saved workspace assignments (target budget, actual spend, expected spend, projected spend, variance, and pacing status) |
optimize_budget | Recommend a cross-channel budget allocation across connected ad platforms using diminishing-returns modeling. Recommend-only (dry_run defaults to true); apply approved changes with update_campaign_bud |
add_keywords | Add keywords to a Google Ads campaign or ad group. |
add_negative_keywords | Manage negative keywords in Google Ads across campaign, ad-group, shared negative list (create, add/remove terms, attach/detach campaigns), and account levels, with full post-change readback. |
create_conversion | Create a conversion action in Google Ads. Returns the conversion ID and label for GTM setup. |
list_conversions | List all conversion actions configured in Google Ads. Free read-only tool ($0.00 / 0 credits). |
diagnose_tracking | Check if conversion tracking is properly set up on a website. Verifies gtag.js, GTM, and pixel installation. Free read-only tool ($0.00 / 0 credits). |
generate_image | Generate an AI image for ad creatives using Imagen 4, Flux, or Stable Diffusion. |
generate_video | Generate an AI video ad using Veo, Runway, or Luma. Great for YouTube and social ads. |
create_meta_campaign | Create a Meta (Facebook/Instagram) advertising campaign. |
create_linkedin_campaign | Create a LinkedIn Ads campaign for B2B advertising. |
create_reddit_campaign | Create a Reddit Ads campaign for community-based advertising. |
stage_audience_artifact | Stage a hashed-PII payload (newline-delimited identifiers — SHA-256 emails, phones, or raw MAIDs) in Synter's private artifact store and return an opaque artifact_id. Pass that id to sync_audience via |
sync_audience | Upload an audience to an ad platform (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt). Accepts inline hashed identifiers (hashed_emails, hashed_phones), raw mobile_ids (IDFA/GAID), c |
manage_audience | Create, upload to, or list first-party audiences in Google Ads via the Data Manager API. Supports Customer Match lists from emails, phone numbers, and company domains (B2B). Use action='create' to bui |
list_ad_accounts | List all connected ad accounts across platforms. |
upload_image | Upload an image as an asset for use in ads. |
run_tool | Run any Synter tool by name. Use this for advanced operations not covered by other tools. See docs.synterai.com for full tool list. |
list_landing_pages | List all landing pages for the authenticated workspace, including publish status, custom domain, and URLs. |
inspect_agent_shield | Inspect Synter Agent Shield security guardrails: spend velocity limits, circuit breaker status, and PII protection fences. Free read-only security audit tool. |
verify_angstrom_claim | Verify advertising claims, budget shifts, or campaign targets against Synter Ångström deterministic ground-truth verification model. Free claim verification tool. |
get_skill | Retrieve core advertising skill runbooks and playbooks (e.g. 'pmax-brand-cannibalization', 'search-hygiene-shield', 'marginal-cpa-budget-rebalancer', 'meta-asc-dark-pool-auditor', 'single-truth-attrib |
get_llm_visibility | Query AI model visibility, Answer Engine Optimization (AEO) ranking, and brand share of voice across ChatGPT, Claude, Perplexity, and Gemini. Free read-only intelligence tool. |
get_organic_publishing_readiness | Check organic social publishing readiness and connected OAuth accounts across LinkedIn (personal & organization pages), X, Reddit, Meta, TikTok, and YouTube. |
draft_organic_post | Create an organic social media post draft for LinkedIn, X, Reddit, Meta, TikTok, or YouTube with optional media attachments and first-comment link. |
validate_organic_post | Validate an organic social post draft against platform character limits, media requirements, and content policies. |
approve_organic_post | Approve a validated organic social post draft so it can be scheduled or published. |
schedule_organic_post | Schedule an approved organic social post for future publication. |
publish_organic_post | Immediately publish an approved organic social post to LinkedIn, X, Reddit, Meta, TikTok, or YouTube via Synter native OAuth. |
cancel_scheduled_post | Cancel a scheduled organic social post before it is published. |
list_scheduled_posts | List organic social posts across platforms filtered by lifecycle status. |
prospector_get_pipeline_summary | Get an overview of outbound outreach health: active campaigns, total leads, emails sent, replies, and inbox warmup status. |
prospector_get_campaigns | List outbound email outreach campaigns with status and volume metrics. |
prospector_get_campaign | Get full details and sequence configuration for a specific outbound outreach campaign. |
prospector_get_campaign_performance | Get performance metrics (sent, opened, replied, bounced, interested) for an outbound campaign. |
prospector_get_leads | Search or list prospects and leads in the outbound outreach database. |
prospector_get_inbox_health | Check sending email accounts, warmup scores, deliverability health, and daily send limits. |
prospector_get_pending_replies | List pending inbound prospect replies with AI classification and draft responses awaiting approval. |
prospector_get_intro_paths | Find warm introduction paths to a target company or domain through your 1st-degree LinkedIn connections. |
prospector_get_warm_intros | Discover ICP target prospects (CMOs, VPs Growth, CEOs, Hiring Managers) reachable via warm introductions from your 1st-degree LinkedIn network. |
prospector_create_campaign | Create a new outbound email outreach campaign. |
| Name | What it does |
|---|---|
Synter Agent Shield Active Guardrails | Active spend velocity limits, circuit breaker settings, and PII protection invariants. |
Synter Ångström Ground-Truth Verification Standard | Deterministic rubric and verification criteria for ad claims, platform APIs, and conversion tracking. |
Synter Agent Skills Catalog | Directory of core advertising playbooks (PMax cannibalization, search hygiene, marginal CPA rebalancing, Meta ASC dark pool, attribution). |
Verified Pricing and Platform Coverage Reference | Canonical pricing tiers ($0.00 free to read across all 16 ad platforms, then SOLO $20/mo with $20.00 claimable monthly credits, SCALE $500/mo, 0% ad spend fee) and 16-platform matrix. |
Read live from the server on November 5, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/synter-mcp-server)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "synter-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.