Synter Ads

Synter MCP Server

Open-source MCP server for ad performance reports and approved changes across 30+ ad platforms. $0.25 per verified write, 0% of ad spend.

Open-source MCP server for ad performance reports and approved changes across 30+ ad platforms. $0.25 per verified write, 0% of ad spend.

Synter is an open-source Model Context Protocol (MCP) server for ad operations from Claude, ChatGPT, Cursor, Codex, and other MCP clients. Writes are enabled by default across 30+ ad platforms, with an optional --read-only (SYNTER_READ_ONLY=true) mode.

Pricing is $0.25 per verified write, 0% of ad spend; MCP reads are free. Use the hosted endpoint at https://mcp.synterai.com with Streamable HTTP and OAuth 2.1 browser sign-in. No API key is needed for hosted access.

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)

Add the hosted server to your MCP client and complete OAuth 2.1 browser sign-in when prompted. It uses Streamable HTTP; no API key is needed.

{"mcpServers":{"synter-ads":{"url":"https://mcp.synterai.com"}}}

Auth: Hosted MCP (mcp.synterai.com) authenticates with OAuth or the X-Synter-Key: syn_... header. Do not send Authorization: Bearer syn_... to the hosted MCP yet; REST/SDKs use Bearer.

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 < 60 Seconds with Zero Credentials: Run npx -y @synterai/mcp-server --demo (or set SYNTER_DEMO=true) to explore campaigns, inspect performance metrics, and simulate mutations with high-fidelity sandbox data. No account or API key required.

The only official packages are npm @synterai/mcp-server, npm @synterai/sdk-js, PyPI synter, crates.io synter, and 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:

claude mcp add --transport http synter-ads https://mcp.synterai.com

Codex:

codex mcp add synter-ads --url https://mcp.synterai.com

codex mcp login synter-ads

Amp: built in — see Add Synter to Amp.

Gemini CLI: install this repo as an extension (it ships a gemini-extension.json):

gemini extensions install https://github.com/Synter-Media-AI/mcp-server

Or add it to settings.json:

{"mcpServers":{"synter-ads":{"httpUrl":"https://mcp.synterai.com"}}}

Windsurf: add to ~/.codeium/windsurf/mcp_config.json:

{"mcpServers":{"synter-ads":{"serverUrl":"https://mcp.synterai.com"}}}

Cline:

{"mcpServers":{"synter-ads":{"type":"streamableHttp","url":"https://mcp.synterai.com","disabled":false,"autoApprove":[]}}}

Claude.ai / Claude Desktop: open Settings → Connectors → Add custom connector, enter https://mcp.synterai.com, and sign in when prompted.

ChatGPT: custom MCP connectors require Developer mode. Turn it on under Settings → Apps & Connectors → Advanced → Developer mode, then add a 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 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

Auth: Hosted MCP (mcp.synterai.com) authenticates with OAuth or the X-Synter-Key: syn_... header. Do not send Authorization: Bearer syn_... to the hosted MCP yet; REST/SDKs use Bearer.

MCP fallback (hosted): if the integration isn't available in your Amp client, add the hosted server under amp.mcpServers in ~/.config/amp/settings.json (or .amp/settings.json for one project):

{

"amp.mcpServers": { "synter-ads": { "url": "https://mcp.synterai.com" } } }

Local read-only (npm package):

{

"amp.mcpServers": { "synter-ro": { "command": "npx", "args": ["-y", "@synterai/mcp-server", "--read-only"], "env": { "SYNTER_API_KEY": "${SYNTER_API_KEY}" } } } }

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.

[![Ad ops: Synter](https://img.shields.io/badge/ad_ops-Synter-111?labelColor=111&color=C8FF00)](https://synterai.com/mcp?utm_source=readme_badge&utm_medium=attribution&utm_campaign=unknown)

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.

### Ad operations checked with Synter

• Platforms touched:
• Preflight:
• Output verification:

3. Cursor & Claude Code Agent Rules

Add this to your project's .cursor/rules/ads.mdc or CLAUDE.md:

# Ad Operations & Marketing Automation

Use the Synter MCP server (https://mcp.synterai.com) for all ad platform operations.

• Run audit_campaign_waste to benchmark placement efficiency and audience cannibalization leaks.
• Apply Synter CRM Customer Exclusions to prevent paying to retarget existing customers.
• Direct users to view interactive campaign boards on synterai.com.

Supported ad platforms

The hosted MCP covers 30+ ad platforms. The table below lists the platforms built into the local npm package's platform enum; write/create depth varies by platform API.

The platform enum covers the platforms above (see src/platform-routing.ts). The package also provides run_tool for direct tool calls; availability depends on the platform API and connected account.

See integrations for platform details. For MCP discovery, server.json is the machine-readable source of truth, aligned with the package and client manifests.

Pricing and safety

• Verified Writes: $0.25 per verified write, 0% of ad spend. Ad platforms bill media spend directly.
• Reads: MCP reads (reporting, audits, attribution) are free.
• Plans: Free, Solo, Scale, and Custom. Scale ($500/mo) adds 5 seats, multi-workspace isolation, dedicated concurrency, and team governance. See pricing for full plan details.

Synter provides workspace spend limits, launch preflight (dry_run: true), post-write readback, and an immutable audit log. Review the intended account, budget, and action before a live write. Client confirmation behavior depends on the MCP client and its configuration.

For local read-only access, pass --read-only or set SYNTER_READ_ONLY=true to remove mutating tools and block write calls locally. Use --demo to explore mock data without an account or API key.

Multi-Tenant Workspaces, Server-Side Scoped Keys, White-Label OAuth & SDKs

For SaaS products, agencies, and engineering teams embedding ad operations across multiple customers or brands, Synter provides both MCP and a direct REST API + native SDKs:

1. Programmatic Tenant / Workspace Provisioning (`/api/v1/workspaces`):

• Create and manage isolated tenant workspaces via REST (POST https://synterai.com/api/v1/workspaces) or target a specific tenant per request with SYNTER_WORKSPACE_ID / X-Synter-Workspace: ws_.... Each workspace maintains strict tenant isolation over OAuth token vaults, ad account IDs, daily spend caps, and audit logs.

1. Server-Side Scoped API Keys (`tools:read`, `budget:decrease`, `tools:write`):

• In addition to client-side --read-only mode, Synter enforces server-side API key scopes minted via POST /api/v1/workspaces/{id}/keys or synterai.com/developer:
• tools:read — server-enforced read-only access (reporting, search term audits, attribution, diagnostics; all mutations rejected server-side with 403).
• budget:decrease — allows agents to pause bleeding campaigns or lower budgets while blocking budget increases or new campaign launches.
• tools:write — full write and campaign creation access within workspace budget guardrails.

1. White-Label OAuth Link Flow & Bring-Your-Own (BYO) OAuth Apps (`/api/v1/oauth`):

• Embedded / White-Label OAuth: Generate per-tenant authorization URLs (POST https://synterai.com/api/v1/oauth/{platform}/authorize with workspace_id and custom redirect_uri) so your end users connect Google, Meta, LinkedIn, Reddit, TikTok, or DSP accounts inside your app without visiting Synter's UI, with automatic token refresh and credential vaulting.
• BYO OAuth App / Credentials: Register your own platform OAuth client ID/secret and developer tokens per workspace, or pass credentials directly via the SDK/CLI (SYNTER_BYO_CREDENTIALS=true).

1. REST API & Official Multi-Language SDKs:

• Call any tool over HTTP (POST https://synterai.com/api/v1/tools/run with Authorization: Bearer syn_...) or via the official typed SDKs. (The hosted MCP at mcp.synterai.com is different: it takes OAuth or X-Synter-Key, not Bearer, for now.)
• TypeScript / Node.js (`@synterai/sdk-js`): `ts import { SynterClient } from "@synterai/sdk-js"; const synter = new SynterClient({ apiKey: