MCP Ads

El servidor MCP de marketing open-soruce. Ejecuta Google Ads, Meta Ads, GA4, Search Console, Tag Manager, WordPress y más desde Claude, ChatGPT, Cursor o cualquier cliente MCP: consulta el rendimiento, audita el gasto desaprovechado, genera informes y lanza campañas (creadas en pausa hasta que digas lo contrario).

Unas 3.100 acciones registradas en más de 12 plataformas, expuestas a través de 17 despachadores de categoría para que tu agente cargue unas 20 definiciones de herramientas en lugar de miles.

Elige tu camino

☁️ Cloud: conectado en 2 minutos, plan gratuito

Ve a MCP-Ads, inicia sesión, haz OAuth de tus cuentas de publicidad en el navegador y pega una URL en tu cliente. Listo.

• Sin aplicaciones de API, sin tokens de desarrollador, sin revisiones de apps: las aprobaciones de las plataformas (token de desarrollador de Google Ads, Meta App Review, etc.) ya están presentadas.

• Plan gratuito: 30 llamadas de herramientas/mes en todas las plataformas. Planes de pago para uso ilimitado.

• Tus credenciales se guardan cifradas y puedes revocarlas en cualquier momento desde el panel.

Es la opción correcta para casi todo el que quiera usar las herramientas en lugar de alojarlas.

🔧 Autoalojado: gratis para siempre, tus claves, tu máquina

Clona este repositorio y ejecútalo con tus propias credenciales de plataforma. Licencia MIT, sin ataduras, sin llamadas a casa. Tus tokens nunca salen de tu máquina.

El coste honesto: varias de las plataformas publicitarias te obligan a solicitar acceso a su API (ver tabla). Si ya tienes esas credenciales — eres una agencia con token de desarrollador de Google Ads, un dev con una app revisada de Meta —, el autoalojado se resuelve en minutos. Si no, presupuesta días o semanas de colas de aprobación de las propias plataformas, o ve directo a la nube.

El mismo código, las mismas acciones, en ambos casos. El producto alojado es exactamente este servidor más la autenticación multiusuario y las aprobaciones ya hechas.

Related MCP server: Google Ads - AdLoop

Guía rápida autoalojado

git clone https://github.com/RoyAzran/mcp-ads.git
cd mcp-ads
pip install -r requirements.txt
cp .env.example .env      # fill in the platforms you use
python server.py doctor   # shows what's connected

Añade esto a Claude Desktop (claude_desktop_config.json) o a Claude Code (.mcp.json):

{
  "mcpServers": {
    "mcp-ads": {
      "command": "python",
      "args": ["/absolute/path/to/mcp-ads/server.py"]
    }
  }
}

Eso es toda la instalación. Pregunta a tu agente "audita mi gasto desperdiciado en Google Ads" y observa cómo se hace.

¿Docker?:

cp .env.example .env
docker compose up -d      # HTTP server on 127.0.0.1:8000, MCP endpoint at /mcp

Modo HTTP sin Docker: python server.py serve --transport http

Helper de OAuth para plataformas con token de tipo bearer (abre un navegador, guarda y renueva el token automáticamente):

python server.py auth snapchat_ads

Qué funciona bien, honestamente

Autoalojarse significa tener tus propias credenciales para cada plataforma. Algunas te las dan en cuestión de minutos; otras te piden solicitudes. Esta es la verdad:

Que la nota te haya cansa ya es exactamente para lo que está la versión cloud — las aprobaciones hechas, solo conecta tus cuentas.

Cómo funciona el acceso a herramientas

Tu agente ve una "entry point" por plataforma más list_actions:

1. list_actions(category="meta_ads_action", search="budget")
2. meta_ads_action(action="<name from step 1>", params={...})

• Las acciones de escritura crean todo en pausa salvo que se diga explícitamente que lo lance

• El "role gating" (permissions.py) separa las herramientas de lectura y escritura por nombre

• --surface full registra cada acción como herramienta MCP propia — útil para clientes programáticos, pero demasiadas tools para un chat

La CLI de NPX

¿Sin Python en la máquina cliente? La CLI es un proxy stdio de ~300 líneas (cli/) que reenvía a cualquier servidor MCP:

# against your self-hosted server
MCP_ADS_BASE_URL=http://127.0.0.1:8000 npx -y @marketingmcp/cli

# against the cloud (API key from mcp-ads.com/manage)
MCP_ADS_API_KEY=mcp_live_xxx npx -y @marketingmcp/cli

Datos sobre Google Ads Transparency

tools/google_ads_transparency.py leeel Centro de Transparencia de Google usando los mismos endpoints que usa la propia web. Google no documenta ninguna API específica para esos datos; los endpoints pueden cambiar o empezar a rechazarte sin previo aviso, y el acceso automatizado no está aprobado.Ia instrumentación viene de fábrica apagada por defecto — activa GOOGLE_ADS_TRANSPARENCY_ENABLED=true solo después de leer el docstring de ese módulo. Las herramientas Meta Ad Library usan la API oficial de Meta y no tienen esa misma limitación.

Seguridad

• Las credenciales salen de tu .env y de un almacén local opcional cifrado con Fernet (MCP_ADS_SECRET_KEY). Nada se va tu casa: telemetría, solo opt-in y apagada por defecto.

• El modo HTTP no tiene autenticación a propósito (se está tú, en loopback). El servidor se niega a servirse en una interfaz pública a menos que pongas MCP_ADS_ALLOW_PUBLIC_BIND=true, porque tiene credenciales a los que gastar dinero real.

• CI tiene una compuerta de límites (tests/test_no_private_imports.py) que falla si algo similar a un secreto intenta entrar en la vitrina o árbol.

Más en SECURITY.md.

Contribuciones

Issues y PRs bienxuenidos — consulta CONTRIBUTING.md. Los scripts de comprobación en scripts/ son el benchmark: cada uno clava un fallo que de verdad pasó en producción, y python scripts/check_tools_execute.py antes de un PR detecta la mayoría de lo que un revisor vería.

Una cosa con lo que no podemos ayudarte es a conseguir el acceso vía API de las plataformas; esas colas de aprobación están en Google, Meta, LinkedIn, TikTok y Microsoft.

Licencia

MIT.