Synter Ads
oficialGestión de campañas publicitarias multiplataforma para agentes de IA en Google, Meta, LinkedIn, Reddit, TikTok y más. Más de 140 herramientas con acceso de lectura/escritura.
¿Qué puedes hacer con Synter Ads MCP?
- Informes de rendimiento multiplataforma — Consulta el gasto, las impresiones, los clics, las conversiones, el CPA y el ROAS por plataforma, campaña y día en las cuentas publicitarias conectadas.
- Revisiones del ritmo del presupuesto — Revisa el ritmo mensual del presupuesto en las plataformas conectadas y señala las campañas que están gastando de más.
- Cambios en campañas con ejecución de prueba — Previsualiza una nueva campaña o un cambio de presupuesto con
dry_run: trueantes de crearla en estado PAUSED. - Pausas y actualizaciones de presupuesto — Pausa campañas o cambia sus presupuestos en Google, Meta, LinkedIn, Microsoft, Reddit y otras plataformas principales.
- Gestión de palabras clave negativas — Añade palabras clave negativas a nivel de campaña, grupo de anuncios, lista compartida o cuenta en Google Ads.
- Escribir resultados en una hoja de Google — Haz que el agente escriba el gasto semanal por plataforma en una hoja de Google para informes.
Documentación
Servidor MCP de Synter (@synterai/mcp-server@1.4.6)
Servidor MCP de código abierto para publicar anuncios con agentes de IA en más de 30 plataformas publicitarias: consultas gratuitas ($0.00/mes), Solo por $20/mes (incluye $20/mes de valor de uso; escrituras de $0.05 a $0.25), 0 % de la inversión publicitaria.
Conecta agentes de programación con IA (Claude Code, OpenAI Codex, Cursor, Windsurf, Amp, Gemini CLI) a más de 30 plataformas publicitarias mediante el MCP alojado (https://mcp.synterai.com) y la API REST (https://synterai.com/api/v1/tools/run), o ejecútalos localmente mediante stdio (npx -y @synterai/mcp-server@1.4.6) en 16 plataformas publicitarias principales con lectura y escritura completas (Google Ads, Meta, LinkedIn, Microsoft/Bing, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, OpenAI Ads, Google DV360 y StackAdapt).
Cuándo usarlo
Usa Synter cuando el usuario solicite un informe publicitario multiplataforma, gasto/ROAS/CPA por canal, un resumen semanal de medios de pago o cambios controlados en campañas y presupuestos de búsqueda, redes sociales, medios minoristas, audio y DSP programáticas. Empieza con las herramientas de lectura; no hace falta escribir.
"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."
Úsalo como conector de datos publicitarios
Si el objetivo es incorporar datos publicitarios a un asistente de IA o a tu propio código, Synter es el conector: conecta cada cuenta publicitaria una sola vez y luego solicita gasto, impresiones, clics, conversiones, CPA y ROAS por plataforma, campaña y día.
- Dónde van los datos: Claude, Claude Code, Cursor, Codex, ChatGPT o cualquier cliente MCP (MCP alojado en
https://mcp.synterai.com), o tu propio código mediante el endpoint RESTPOST https://synterai.com/api/v1/tools/runy los SDK. En el MCP alojado, el agente también puede escribir los resultados en una hoja de cálculo de Google (update_google_sheet). - Qué plataformas lee: Google Ads, Meta (Facebook e Instagram), LinkedIn, Microsoft Ads, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, DV360, CM360, Criteo, Walmart Connect, Instacart, Target Roundel, FreeWheel y OpenAI Ads (herramientas del MCP alojado
pull_*_performance). El paquete npm local cubre el conjunto principal mediantelist_campaigns,get_performanceyget_daily_spend. - Costo: leer tus propias cuentas es gratis ($0.00, 0 créditos); los planes limitan los puestos y los espacios de trabajo (consulta Precios).
- Actualización de los datos: las consultas acceden a la API de cada plataforma en el momento de la solicitud; no hay que esperar a una sincronización nocturna.
- Por cliente: las agencias mantienen a cada cliente en su propio espacio de trabajo, para que los informes nunca mezclen cuentas.
- Más allá de los informes: la misma conexión puede pausar campañas, cambiar presupuestos y añadir palabras clave negativas, con aprobación y una ejecución de prueba primero. Un conector de solo informes no puede hacerlo.
- Cuándo usar otra herramienta: si necesitas cargar datos publicitarios en BigQuery o Snowflake según un calendario para paneles de BI, usa una herramienta ELT de almacén de datos. Synter lee los datos en tiempo real y los entrega al agente, en lugar de cargarlos en un almacén.
"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."
Inicio rápido (entorno de pruebas sin credenciales en 30 segundos)
Prueba Synter de inmediato, sin claves de API ni tarjeta de crédito, con respuestas deterministas del entorno de pruebas:
# 1. Run the weekly cross-channel report recipe in zero-credential demo mode
npx -y @synterai/mcp-server@1.4.6 --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/mcp-server@1.4.6 --toolset ad-ops --read-only
Configuración del cliente
- Amp: integración integrada (Settings > Integrations) o usa la alternativa
"amp.mcpServers"que aparece a continuación. - Claude Code:
- HTTP alojado (OAuth 2.1):
claude mcp add --transport http synter-ads https://mcp.synterai.com - stdio local:
claude mcp add synter -e SYNTER_API_KEY=syn_your_key -- npx -y @synterai/mcp-server@1.4.6
- HTTP alojado (OAuth 2.1):
- OpenAI Codex:
codex mcp add synter-ads --url https://mcp.synterai.com
- Claude.ai / Claude Desktop:
- Ve a Settings -> Connectors -> Add custom connector e introduce
https://mcp.synterai.com.
- Ve a Settings -> Connectors -> Add custom connector e introduce
- ChatGPT:
- Los conectores MCP personalizados requieren el modo de desarrollador (Settings -> Apps & Connectors -> Advanced -> Developer mode); después, añade
https://mcp.synterai.com.
- Los conectores MCP personalizados requieren el modo de desarrollador (Settings -> Apps & Connectors -> Advanced -> Developer mode); después, añade
- Cursor / Windsurf (
mcp.json):{ "mcpServers": { "synter": { "command": "npx", "args": ["-y", "@synterai/mcp-server@1.4.6"], "env": { "SYNTER_API_KEY": "${SYNTER_API_KEY}" } } } } - Gemini CLI:
gemini extensions install https://github.com/Synter-Media-AI/mcp-server
Añadir Synter a Amp
- En Amp: Synter es una integración integrada. Actívala en Amp desde Settings > Integrations.
- Claude, ChatGPT y otros clientes MCP, alojado (más de 30 plataformas publicitarias, el único DSP agéntico): https://mcp.synterai.com
- Local de solo lectura (paquete npm):
{ "amp.mcpServers": { "synter": { "command": "npx", "args": ["-y", "@synterai/mcp-server@1.4.6", "--toolset", "ad-ops", "--read-only"], "env": { "SYNTER_API_KEY": "${SYNTER_API_KEY}" } } } }
Conjuntos de herramientas, modo de solo lectura y modo de demostración
| Indicador / Variable de entorno | Comportamiento |
|---|---|
Predeterminado (full) | Expone las 56 herramientas directas de stdio (32 herramientas de publicidad de pago en las plataformas principales + 8 herramientas de redes sociales orgánicas *_organic_post + 16 herramientas salientes prospector_*). |
--toolset ad-ops (SYNTER_TOOLSET=ad-ops) | Expone solo las 32 herramientas principales de publicidad de pago y elimina todas las herramientas de redes sociales orgánicas y salientes de tools/list (y rechaza las llamadas si se invocan). |
--read-only (SYNTER_READ_ONLY=true) | Expone solo herramientas de lectura (readOnlyHint: true) en tools/list y bloquea localmente todas las herramientas que modifican datos (destructiveHint: true) antes de cualquier llamada de red. |
--demo (SYNTER_DEMO=true) | Se ejecuta en modo de entorno de pruebas sin credenciales, con datos realistas y normalizados de campañas y rendimiento multiplataforma (sandbox: true). |
Cobertura de plataformas y matriz de capacidades de lectura/escritura (MCP alojado / stdio local)
El MCP alojado (https://mcp.synterai.com) y el endpoint REST (POST https://synterai.com/api/v1/tools/run) cubren más de 30 plataformas publicitarias. El paquete local de stdio (@synterai/mcp-server@1.4.6) ofrece compatibilidad directa y tipada con el enum platform en las plataformas principales con lectura y escritura completas, y permite acceder a los más de 140 scripts del backend mediante run_tool:
Plataforma (enum platform) | Herramientas directas de lectura ($0.00) | Herramientas directas de escritura + scripts run_tool (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 en campañas/grupos de anuncios/listas compartidas/cuenta), 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 (requiere 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") |
Plataformas ampliadas (MCP alojado y run_tool) | run_tool(script_name="<platform>_*") en stdio; pull_*_performance / execute directos en 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 |
Precios (100 % en USD — 0 % de la inversión publicitaria)
Synter cobra 0 % de la inversión publicitaria (las redes publicitarias facturan directamente el gasto en medios) y $0.00 por todas las consultas de lectura de cuentas propias y las vistas previas de dry_run: true. Consulta todos los detalles en https://synterai.com/pricing:
| Plan | Precio | Puestos y espacios de trabajo | Valor de uso mensual incluido y tarifas de escritura |
|---|---|---|---|
| Acceso gratuito de lectura | $0.00 / mes | 1 puesto, 1 espacio de trabajo | $0.00 por todas las consultas de lectura de cuentas propias (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) y todas las vistas previas de dry_run: true. No se requiere tarjeta de crédito. |
| SOLO | $20.00 / mes ($200.00 / year) | 1 puesto, 1 espacio de trabajo | Incluye $20.00/mes de valor de uso canjeable: cubre hasta 400 escrituras ligeras ($0.05 cada una: pause_campaign, enable_campaign, update_campaign_budget), 80 escrituras estándar ($0.25 cada una: add_keywords, add_negative_keywords, sync_audience, create_conversion) o 4 lanzamientos completos de campañas MCP ($5.00 cada uno). Los límites máximos de gasto configurables evitan cargos inesperados por exceso de uso. |
| SCALE | $500.00 / mes ($5,000.00 / year) | 5 puestos, varios espacios de trabajo | Incluye $500.00/mes de valor de uso canjeable (incluye hasta 10 000 escrituras ligeras o 2 000 escrituras estándar al mes), aislamiento de clientes en varios espacios de trabajo, programaciones de Autopilot / Autonomous Loop las 24 horas, sincronización con CRM/almacén de datos y concurrencia dedicada. |
| CUSTOM | Contrato empresarial | Puestos y espacios de trabajo personalizados | Asignación mensual de uso personalizada, gestión de varios espacios de trabajo para agencias/empresas, SLA personalizado, SSO y facturación mediante factura. |
Seguridad, protecciones de escritura y arquitectura multiinquilino
Defensa de escritura en cuatro capas
- Modo local de solo lectura estricta (
--read-only/SYNTER_READ_ONLY=true): Elimina todas las herramientasdestructiveHint: truedetools/listy bloquea las modificaciones localmente antes de que cualquier solicitud de red pueda salir de tu máquina. - Claves de API con alcance limitado y aplicación en el servidor (
POST /api/v1/keys): Genera claves de solo lectura (reporting:read,campaigns:read,intel:read) o claves de seguridad direccionales (budget:decrease— permiten pausar campañas de emergencia y reducir presupuestos, pero rechazan los aumentos de presupuesto con HTTP403). - Control de políticas del lado del servidor de Agent Shield: Aplica
PAUSED-on-create como valor predeterminado para cada campaña nueva, un límite máximo de aumento de presupuesto de2.0xpor llamada, un disyuntor de velocidad del espacio de trabajo de$5,000/day, vistas previas dedry_run: true($0.00), lectura obligatoria del estado del proveedor después de cada escritura (get_ad_readback) y un registro de auditoría inmutable del espacio de trabajo. - Ejecución autohospedada con credenciales propias y código abierto bajo MIT: Ejecuta
@synterai/mcp-server@1.4.6dentro de tu propia VPC o tus propios contenedores y pasa directamente tus propios tokens OAuth de la plataforma mediante variables de entorno, para que la nube alojada de Synter no custodie las credenciales de tu cuenta publicitaria.
Patrones multiinquilino y de SaaS integrado (docs.synterai.com/api/multi-tenant-auth)
- Patrón 1 — Claves alojadas aisladas por espacio de trabajo y enlaces de conexión:
- Genera claves de API secundarias con alcance limitado y vinculadas a un espacio de trabajo mediante
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). - Genera URL de transferencia OAuth de autoservicio para anunciantes mediante
POST https://synterai.com/api/v1/connections/start(devuelve unauthUrlde una sola plataforma) oPOST https://synterai.com/api/v1/connections/request(envía al cliente un enlace de conexión multiplataforma válido durante 7 días). - Cambia los espacios de trabajo activos en claves para varios espacios de trabajo mediante
get_workspacesyupdate_active_workspace.
- Genera claves de API secundarias con alcance limitado y vinculadas a un espacio de trabajo mediante
- Patrón 2 — Modo autohospedado con credenciales propias (código abierto bajo MIT):
- Las aplicaciones SaaS multiinquilino que gestionan sus propias aplicaciones OAuth y almacenan los tokens de los clientes en su propio KMS o bóveda pueden invocar la CLI
@synterai/mcp-serverosynteren procesos de trabajo aislados, pasando los tokens de plataforma de cada inquilino mediante variables de entorno (GOOGLE_ADS_REFRESH_TOKEN,GOOGLE_ADS_CLIENT_ID,GOOGLE_ADS_CLIENT_SECRET,GOOGLE_ADS_DEVELOPER_TOKEN,META_ACCESS_TOKEN,LINKEDIN_ACCESS_TOKEN, etc.).
- Las aplicaciones SaaS multiinquilino que gestionan sus propias aplicaciones OAuth y almacenan los tokens de los clientes en su propio KMS o bóveda pueden invocar la CLI
API REST y SDK oficiales para varios lenguajes
- MCP alojado (HTTP transmisible):
https://mcp.synterai.com— autentícate mediante el inicio de sesión en el navegador con OAuth 2.1 o el encabezadoX-Synter-Key: syn_.... Todavía no envíesAuthorization: Bearer syn_...al MCP alojado; REST y los SDK usan Bearer. - Endpoint REST:
POST https://synterai.com/api/v1/tools/runconAuthorization: Bearer syn_...(oX-Synter-Key: syn_...) y el cuerpo JSON{"script_name": "<tool_or_script>", "args": ["--flag", "value"], "platform": "google"}. - SDK de TypeScript / JavaScript:
npm install @synterai/sdk-js - SDK de Python:
pip install synter->Synter(api_key=..., base_url=..., timeout=..., max_retries=...); métricas medianteclient.analytics.get_performance(...) - SDK de Rust:
cargo add synter(crates.io/crates/synter) - SDK de Java: Maven
ai.syntermedia:synter-sdk
Licencia
Licencia MIT — consulta LICENSE.