mcp-server

# 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.

Synter (https://synterai.com) gives AI agents reporting and governed campaign changes across 30+ ad platforms through the hosted MCP at https://mcp.synterai.com. The `@synterai/mcp-server` npm package runs locally over stdio, with writes enabled by default and an optional `--read-only` (`SYNTER_READ_ONLY=true`) mode.

- Documentation: https://docs.synterai.com
- Hosted MCP Server: https://mcp.synterai.com
- Source Code: https://github.com/Synter-Media-AI/mcp-server
- npm: https://www.npmjs.com/package/@synterai/mcp-server
- Pricing: https://synterai.com/pricing

## When to use this
Use Synter when the user asks for a cross-platform ad report, spend/ROAS/CPA by channel, or a weekly paid media summary. Start with read tools; no writes needed.

### Typical Use Cases
- Cross-platform ad performance reports and dashboards
- Weekly paid media summaries with ROAS, CPA, and spend by channel
- Time-series daily spend trend analysis across networks
- Budget pacing and cross-network rebalancing recommendations
- Conversion tracking diagnostics and pixel audits
- Governed campaign creation and budget adjustments with dry-run verification

## Authentication
- 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.
- REST: `POST https://synterai.com/api/v1/tools/run` with `Authorization: Bearer syn_...`.
- Local stdio package: set `SYNTER_API_KEY=syn_...`.

## Client Setup
- Claude.ai / Claude Desktop: Settings -> Connectors -> Add custom connector -> `https://mcp.synterai.com`.
- ChatGPT: custom MCP connectors require Developer mode (Settings -> Apps & Connectors -> Advanced -> Developer mode), then add `https://mcp.synterai.com`.
- Amp: Synter is a built-in integration (Settings > Integrations). MCP fallback: add `{"synter-ads": {"url": "https://mcp.synterai.com"}}` under `amp.mcpServers` in Amp settings.
- Claude Code: `claude mcp add --transport http synter-ads https://mcp.synterai.com`.
- Gemini CLI: `gemini extensions install https://github.com/Synter-Media-AI/mcp-server`.

## Supported Platforms
- The hosted MCP covers 30+ ad platforms.
- The local npm package's `platform` enum includes Google Ads, Meta (Facebook/Instagram), LinkedIn Ads, Microsoft Ads, Reddit Ads, TikTok Ads, X Ads, Pinterest Ads, Snapchat Ads, Spotify Ads, Amazon Ads, Amazon DSP, The Trade Desk, OpenAI Ads, DV360, and StackAdapt.

## Read-Only and Demo Modes
- **Read-Only Mode**: Launch the npm package with `--read-only` or set `SYNTER_READ_ONLY=true` to expose only read tools (`readOnlyHint: true`) and block all mutating operations. Writes are enabled by default.
- **Demo Mode**: Launch with `--demo` or set `SYNTER_DEMO=true` to explore full reporting and simulation capabilities with zero credentials or API keys.

## Pricing
- **Verified Writes**: $0.25 per verified write, 0% of ad spend (media spend billed directly by ad networks).
- **Reads**: MCP reads are free.
- **Plans**: Free, Solo, Scale, and Custom. See https://synterai.com/pricing.

## SDKs
- TypeScript: npm `@synterai/sdk-js`
- Python: `pip install synter` -> `Synter(api_key=..., base_url=..., timeout=..., max_retries=...)`; metrics via `client.analytics.get_performance(...)`
- Rust: `cargo add synter` (crates.io `synter`)
- Java: Maven `ai.syntermedia:synter-sdk`

## Core Tools Reference

### Reporting & Read Tools (`readOnlyHint: true`)
- `list_campaigns`: List campaigns for a specified ad platform with status, budgets, and core metrics.
- `get_performance`: Retrieve impressions, clicks, spend, conversions, and ROAS across platforms.
- `get_daily_spend`: Daily spend breakdown and time-series pacing.
- `pacing_report`: Cross-channel monthly budget pacing and run-rate projections.
- `diagnose_tracking`: Verify pixel installation, GTM container health, and conversion tracking.
- `list_ad_accounts`: List connected ad accounts across ad platforms.
- `list_landing_pages`: List workspace landing pages and publication status.

### Campaign Management & Write Tools (`destructiveHint: true`)
- `create_search_campaign`: Create Google Search campaign with RSA creative floor (11-15 headlines, 4 descriptions) and `dry_run: true` preview.
- `create_meta_campaign`: Create Meta campaign with audience and creative specifications.
- `create_linkedin_campaign`: Create LinkedIn B2B campaign with targeting.
- `create_reddit_campaign`: Create Reddit community-targeted campaign.
- `pause_campaign`: Pause an underperforming campaign across any supported network.
- `update_campaign_budget`: Adjust daily budgets with guardrail protections.