Synter Ads MCP Server

Synter MCP Server

The MCP extension Claude doesn't want you to use.

Because once you install it, your AI agent can spend real money.

Create campaigns. Adjust budgets. Pause underperformers. Generate creatives. Pull performance data. All through natural conversation—across Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, and more.

This is the first Model Context Protocol (MCP) server that gives AI agents a credit card.

---

Why Synter?

Most advertising MCP servers are read-only and single-platform. Synter is the only cross-platform ad management MCP server with full read + write capabilities:

One MCP server. Every ad platform. Read and write.

---

⚠️ Fair Warning

Your AI agent will be able to:

• Create campaigns that immediately start spending your budget
• Adjust bids that affect how much you pay per click
• Pause campaigns (sometimes that's a good thing)
• Add keywords that change who sees your ads
• Generate creatives and upload them to your accounts

We built in confirmations for destructive actions. But still—maybe don't give this to an agent you just met.

---

Quick Start

1. Get Your API Key

Sign up at syntermedia.ai and create an API key in the Developer Settings.

2. Configure Your AI Client

For Claude Desktop — Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

For Cursor — Add to .cursor/mcp.json in your project:

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

For Amp — Add to .amp/settings.json:

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

Remote (Streamable HTTP) — For ChatGPT, n8n, Zapier, or any MCP client that supports HTTP transport:

URL: https://mcp.syntermedia.ai/mcp/
Header: X-Synter-Key: syn_your_api_key_here

No local install needed. Works with any MCP client that supports Streamable HTTP transport.

3. Start Using It

Restart your AI client and 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"

---

Prefer a full plugin? (Claude Code / Claude Desktop)

This package is the raw MCP server. If you use Claude Code or Claude Desktop, the Synter plugin wraps this same server with ready-made skills (/synter:launch, /synter:audience, /synter:optimize, …), specialized agents, and an approval-before-spend safety hook:

/plugin marketplace add Synter-Media-AI/plugin
/plugin install synter@synter

It also ships a headless Claude Agent SDK runner for automation. See the plugin repo or the Claude Plugin guide. Use this MCP package directly when you want just the tools, or are wiring another client.

---

What Can Your Agent Do?

📊 Campaign Management

📈 Performance & Analytics

🎯 Keywords & Targeting

🔄 Conversion Tracking

🎨 Creative Generation

🔧 Utility

---

No Ads Experience? No Problem.

If you've never run ads before, here's what you need to know:

What is a Campaign?

A campaign is like a project folder. It contains your ads, who sees them, and how much you spend.

Campaign: "Q1 Lead Generation"
├── Budget: $50/day
├── Targeting: USA, people searching "project management"
└── Ads: Headlines, descriptions, images

What Platforms Can I Use?

Campaign Types Explained

Search Campaigns — Your ad shows when someone Googles specific keywords.

• Example: Someone searches "best CRM software" → Your ad appears

Display Campaigns — Image ads shown across websites and apps.

• Example: Banner ad on a news site

Performance Max (PMax) — Google's AI shows your ads everywhere (Search, YouTube, Display, Gmail, Maps).

• Example: Google figures out the best placements for you

Video Campaigns — Video ads on YouTube and partner sites.

• Example: 15-second ad before a YouTube video

Common Terms

First Campaign Checklist

Before creating your first campaign, you'll need:

1. ✅ A landing page URL where people will go when they click
2. ✅ An idea of who you want to reach (location, interests)
3. ✅ A daily budget you're comfortable with ($10-50 to start)
4. ✅ Some headlines and descriptions for your ad

Pro tip: Start with a Search campaign on Google. It's the easiest to understand and shows ads to people already looking for what you offer.

---

Example Conversations

Create Your First Campaign

You: Create a Google Search campaign for my SaaS product. Target people searching for "team collaboration software" and "project management tools". Budget is $25/day. Landing page is https://myapp.com/signup

Agent: I'll create a Search campaign with those keywords. What headlines should I use? Here are some suggestions:

• "Team Collaboration Made Simple"
• "Project Management for Modern Teams"
• "Start Free - No Credit Card"

Check Performance

You: How are my campaigns doing this week?

Agent: Here's your performance for the last 7 days:

Campaign	Spend	Clicks	Conversions	ROAS
Brand Search	$142	89	12	4.2x
Competitor Keywords	$98	45	3	1.5x
Display Retargeting	$67	234	8	2.8x

The "Competitor Keywords" campaign is underperforming. Want me to pause it or adjust the targeting?

Add Negative Keywords

You: I'm getting clicks for "free project management" but we don't have a free tier. Block those.

Agent: Added "free" as a negative keyword to your campaign. This will stop your ads from showing for any search containing "free".

Generate Ad Creative

You: I need a display ad image for a marketing automation product. Dark theme, professional, 1200x628.

Agent: Generating your image with Imagen 4...

Created: "Marketing automation dashboard with data visualization on dark background" Asset saved and ready to use in your next Display campaign.

---

Connect Your Ad Accounts

To manage ads on each platform, you'll need to connect your accounts in Synter:

1. Go to syntermedia.ai/settings/credentials
2. Click "Connect" next to each platform
3. Complete the OAuth flow
4. Your agent can now manage that platform

Supported Platforms:

• Google Ads ✅
• Meta (Facebook/Instagram) ✅
• LinkedIn Ads ✅
• Microsoft Ads (Bing) ✅
• Reddit Ads ✅
• TikTok Ads ✅
• X (Twitter) Ads ✅
• StackAdapt ✅
• The Trade Desk ✅

---

Advanced: Direct Tool Access

For power users, you can call any of 140+ Synter tools directly:

> Use run_tool to call google_ads_list_audiences

See the full tool list at docs.syntermedia.ai/tools or ask your agent:

> What tools are available for LinkedIn Ads?

---

Environment Variables

---

Local Development

# Clone and install
git clone https://github.com/Synter-Media-AI/mcp-server.git
cd mcp-server
npm install

# Build
npm run build

# Run locally
SYNTER_API_KEY=syn_your_key_here node dist/index.js

---

Troubleshooting

"SYNTER_API_KEY not set"

Make sure your API key is in the env section of your MCP config. The key should start with syn_.

"Invalid or expired API key"

1. Check that you copied the full key (they're long!)
2. Verify the key is active at syntermedia.ai/developer
3. Make sure the key has tools:write scope

"No ad accounts connected"

You need to connect at least one ad platform:

1. Go to syntermedia.ai/settings/credentials
2. Click "Connect" next to Google Ads (or another platform)
3. Complete the OAuth authorization

Tools aren't showing in Claude/Cursor

1. Restart your AI client completely (not just refresh)
2. Check the MCP server logs for errors
3. Verify the config file path and JSON syntax

---

Resources

• Synter Manual: syntermedia.ai/manual
• API Documentation: docs.syntermedia.ai
• Claude Plugin: github.com/Synter-Media-AI/plugin — skills, agents & this MCP for Claude Code / Desktop
• Tool Reference: docs.syntermedia.ai/tools
• MCP Server Comparison: syntermedia.ai/blog/best-ad-platform-mcp-servers
• Free Agent Skills (47 open-source): github.com/Synter-Media-AI/free-skills — also on skills.sh
• Support: hello@syntermedia.ai

---

License

MIT License - see LICENSE for details.

---