Synter-Media-AI/mcp-server

An open-source MCP server for running ads with AI agents.
Run ads across 16 ad platforms from any MCP client: Google Ads, Microsoft Ads, Meta, LinkedIn, X, Reddit, TikTok, Snapchat, Pinterest, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, OpenAI Ads, Display & Video 360, and StackAdapt. Destructive tools are flagged so your MCP client asks before running them.
Create campaigns. Adjust budgets. Pause underperformers. Generate creatives. Pull performance data. All through natural conversation.
**An open-source Model Context Protocol (MCP) server that lets AI agents read and run your ad accounts, with write tools flagged so your MCP client asks before running them.**
> **Note:** Synter-Media-AI/plugin is the canonical installable Claude plugin repo. The .claude-plugin/ copy in this repo is not the install source.
---
Install (hosted, browser sign-in)
The hosted server lives at **https://mcp.synterai.com**. Add it to your client and sign in through your browser the first time you use it (OAuth with dynamic client registration and PKCE, per the MCP authorization spec). No API key to copy, nothing to install locally.
Signup is self-serve at synterai.com/sign-up. There is no access review: sign up, connect your ad accounts, and your MCP client can start working.
Synter's canonical domain is **synterai.com**; the hosted MCP endpoint is https://mcp.synterai.com.
> ⚡ **Try in The only official packages are @synterai/mcp-server, @synterai/sdk-js, PyPI synter, crates.io synter, Maven ai.syntermedia:synter-sdk. @iflow-mcp/* copies are unofficial and outdated.
**Cursor:** click the badge above, or open cursor://anysphere.cursor-deeplink/mcp/install?name=synter-ads&config=eyJ1cmwiOiJodHRwczovL21jcC5zeW50ZXJhaS5jb20ifQ==
**VS Code:** click the badge above, or open vscode:mcp/install?%7B%22name%22%3A%22synter-ads%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.synterai.com%22%7D
**Claude Code:**
**Codex:**
**Gemini CLI:** install this repo as an extension (it ships a gemini-extension.json):
Or add it to settings.json:
**Windsurf:** add to ~/.codeium/windsurf/mcp_config.json:
**Cline:**
**Claude.ai / ChatGPT:** add a custom connector with the URL https://mcp.synterai.com and sign in when prompted.
Then start chatting:
> "Show me all my Google Ads campaigns"
> "Create a search campaign for 'project management software' with a $50/day budget"
> "Pause the campaign that's overspending"
---
Add Synter to Your Repository
Show your team and collaborators that ad operations in this repo run through Synter.
1. Repository README Badge
Add this badge to your project's README.md. It names the tool and nothing else; it makes no claim about results.
2. Pull Request Notes
If your agent (Claude Code, Cursor, Windsurf) adds a Synter section to a pull request, it must fill every line from that run's own tool output, for example run_launch_preflight or angstrom_verify_output, and report failures and skipped checks as they are. Never paste a pre-filled result.
3. Cursor & Claude Code Agent Rules
Add this to your project's .cursor/rules/ads.mdc or CLAUDE.md:
---
How Synter Compares
The official Google Ads MCP server is read-only by design: per Google's documentation, it is "strictly read-only" and "cannot modify bids, pause campaigns, or create new assets." Most third-party ad MCP servers cover a single platform or provide raw schema protocols without an execution engine. We built Synter to do both halves of the job, across every major buying channel, with free read-only diagnostics and grounded verification.
| | Synter MCP | Official Google Ads MCP | AdCP (Ad Context Protocol) | Pipeboard |
|---|---|---|---|---|
| **Free Read Access** | ✅ **100% Free ($0.00 / 0 credits)** | ✅ Free (Google only) | Schema spec only | ❌ Paywalled after trial |
| **Write Mutations** | ✅ Managed paywall (SOLO, SCALE, CUSTOM) | ❌ Read-only | ❌ Spec only | ⚠️ Single-channel proxy |
| **Platform Coverage** | **16 ad platforms** (list below) | Google Ads only | Spec standard only | 6 platforms |
| **Grounded Verification** | ✅ **Synter Ångström** live readback | ❌ | ❌ | ❌ |
| **Pre-Approved OAuth** | ✅ 1-click self-serve | Custom cloud setup | None | Basic API keys |
| **AI Creative Generation**| ✅ Images, video, copy | ❌ | ❌ | ❌ |
| **Audience Sync** | ✅ Cross-channel custom audiences | ❌ | ❌ | ❌ |