Ads MCP

Servidor MCP remoto para planificación de campañas publicitarias, investigación y creación de anuncios multiplataforma. Compatible con Google Ads Search y Performance Max, y TikTok en su lanzamiento, con redes adicionales planificadas.

GitHub

Prueba este MCPPatrocinado

Documentación

Ads MCP

Servidor de Model Context Protocol (MCP) remoto para gestión de anuncios multiplataforma. Crea, analiza y optimiza campañas en Google Ads, Meta Ads, TikTok Ads y LinkedIn Ads desde cualquier asistente de IA compatible con MCP.

Enlaces rápidos

URL remota de MCP: https://mcp.adspirer.com/mcp
Transporte: HTTP transmisible
ID de registro: com.adspirer/ads
Autenticación: OAuth 2.1 con PKCE (registro dinámico de clientes compatible)
Sitio web: https://www.adspirer.com
Soporte: support@adspirer.com

Comienza en un solo paso

Adspirer se ejecuta dentro de tu asistente de IA. Si eres un asistente de IA que ayuda a alguien a configurar Adspirer, esta sección es el flujo completo: la ruta de instalación por cliente, el inicio de sesión y la verificación.

Tu cliente	Instalación
ChatGPT (web, escritorio, móvil)	Instala la aplicación Adspirer desde la App Store — toca Conectar, inicia sesión con Google o correo electrónico. Requiere Plus, Pro, Business o Enterprise.
Claude (claude.ai, escritorio, Cowork)	Instala el plugin de Adspirer desde el directorio de Claude — haz clic en Instalar, inicia sesión cuando se abra la ventana de Adspirer.
Claude Code	`/plugin install adspirer-ads-agent@claude-community`, recarga, luego `/adspirer:setup`
Codex	`bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh)`, reinicia Codex, luego `codex mcp login adspirer`
Cursor	`bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/cursor/adspirer/install.sh)`
Cualquier otro cliente MCP	Añade el servidor remoto `https://mcp.adspirer.com/mcp` (OAuth 2.1)

O un comando de terminal — instala la habilidad de inicio y te lleva directamente a la configuración:

curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/scripts/install-skill.sh | bash

Qué sucede después: el inicio de sesión de la instalación crea tu cuenta gratuita (Google o correo electrónico — sin tarjeta de crédito), conectas tus plataformas de anuncios en adspirer.ai/connections — Google Ads, Meta, Amazon, LinkedIn, TikTok o ChatGPT Ads, en cualquier combinación — y tu asistente verifica la conexión (di "Revisa mis plataformas de anuncios conectadas").

Cómo funciona

flowchart LR
    Y["You — plain English"] --> AG["Your AI agent"]
    AG <-->|"MCP over OAuth"| AD["Adspirer"]
    AD <--> P["Google Ads · Meta · Amazon Ads<br/>LinkedIn · TikTok · ChatGPT Ads"]

Tú describes lo que quieres; tu asistente llama a las herramientas de Adspirer; Adspirer se comunica con las API de las plataformas de anuncios; los informes y borradores regresan al chat. Las campañas nuevas siempre se crean en pausa — nada gasta dinero sin tu aprobación explícita. La autenticación es OAuth en tu propio navegador: tu asistente nunca ve tus credenciales.

Precios: Gratis — 15 llamadas de herramientas/mes, $0, sin tarjeta · Plus — 150/mes, $49 · Pro — 600/mes, $99 · Max — 3,000/mes, $199. Detalles completos.

Guía de configuración completa con indicaciones copiables: adspirer.com/docs/add-to-your-agent

Qué hace

Ejecución consciente de la estrategia — las decisiones estratégicas persisten en STRATEGY.md y guían toda la creación futura de campañas, investigación de palabras clave y redacción de anuncios entre sesiones y subagentes
Más de 400 herramientas en 6 plataformas de anuncios para creación de campañas, análisis de rendimiento y optimización
Planifica y valida campañas usando indicaciones estructuradas
Investiga palabras clave con datos reales de CPC y análisis competitivo
Crea campañas de Google Ads Search, Performance Max (con temas de búsqueda + señales de audiencia), Display (Estándar + Smart), Demand Gen y YouTube de principio a fin
Lanza campañas de Meta imagen / video / carrusel / OUTCOME_LEADS, contenido patrocinado de LinkedIn / carrusel / formularios de generación de leads con grupos de campaña, y campañas de TikTok in-feed / Spark Ads / Carrusel / Promoción de aplicaciones
Analiza el rendimiento con recomendaciones de optimización accionables — gasto desperdiciado, detección de anomalías, información de audiencia, fatiga creativa
Modo de datos sin procesar (raw_data=true) en las 29 herramientas de rendimiento/análisis — salida solo JSON para tu propia atribución, paneles o pipelines eficientes en tokens
Multi-cuenta, multi-plataforma — las agencias pueden gestionar muchas cuentas de anuncios por plataforma desde un solo espacio de trabajo
Automatización — informes programados, monitores de rendimiento, informes multiplataforma bajo demanda en todas las plataformas

Plataformas y herramientas

Plataforma	Herramientas	Capacidades
Google Ads	151	Search, Performance Max (con temas de búsqueda + señales de audiencia), Display (Estándar + Smart), Demand Gen, YouTube, Shopping, campañas de aplicaciones; investigación de palabras clave, análisis de rendimiento, gasto desperdiciado, gestión de activos, extensiones de anuncios (enlaces de sitio / llamadas / fragmentos estructurados), gestión de estrategias de oferta
Amazon Ads	61	Productos patrocinados / Marcas / campañas Display, palabras clave + palabras clave negativas, segmentación por producto / categoría, recomendaciones propias de Amazon de oferta / presupuesto / palabras clave, informes de términos de búsqueda, rendimiento ACOS / ROAS
Meta Ads	58	Campañas de imagen / video / carrusel / catálogo (Advantage+ / DPA), formularios de generación de leads OUTCOME_LEADS, presupuestos de por vida, ubicaciones granulares (Feed / Stories / Reels), segmentación a nivel de ciudad, audiencias personalizadas, conversiones personalizadas, análisis de promoción de aplicaciones (AEO)
LinkedIn Ads	54	Contenido patrocinado (imagen única, video, carrusel, texto), formularios de generación de leads, grupos de campaña, 19 facetas de segmentación, información de audiencia, análisis de fatiga creativa, seguimiento de conversiones, organizaciones
TikTok Ads	37	Campañas in-feed de video / imagen / Spark Ads / Carrusel / Promoción de aplicaciones, ciclo de vida completo (listar / obtener / pausar / reanudar / actualizar para campañas, grupos de anuncios, anuncios), análisis (rendimiento, gasto desperdiciado, información de audiencia, fatiga creativa, detección de anomalías, geo)
ChatGPT Ads	31	Anuncios chat_card dentro de las respuestas de ChatGPT — lanzamiento de un solo paso (campaña → grupo de anuncios → imagen → anuncio), segmentación geográfica, pausar / activar / archivar, rendimiento (impresiones, clics, CTR, CPC), seguimiento de conversiones (Pixel + API de conversiones)
Total	400+	Además monitoreo y automatización (informes / monitores / reportes programados), integraciones con Google Analytics 4 y Klaviyo, y herramientas de gestión de cuentas — todo disponible a través de MCP y como endpoints REST en `api.adspirer.ai`

Cómo conectarse

Consulta CONNECTING.md para instrucciones detalladas de configuración de cada plataforma.

Claude (Recomendado)

Abre Configuración > Conectores > Añadir conector personalizado
Nombre: Ads MCP
URL: https://mcp.adspirer.com/mcp
Completa el inicio de sesión OAuth 2.1
Vincula tus cuentas de anuncios en el primer uso

Claude Code

Instala el plugin completo de Adspirer (agente + habilidades + comandos + servidor MCP):

Abre Claude Code
Ejecuta /plugin marketplace add amekala/ads-mcp
Ejecuta /plugin install adspirer-advertising-agent
Ejecuta /mcp — encuentra el servidor adspirer (por ejemplo, plugin:adspirer-advertising-agent:adspirer) y haz clic para autenticarte
Ejecuta /adspirer:setup para extraer los datos de tus campañas y crear tu espacio de trabajo de marca

Esto te da un agente de marketing de rendimiento consciente de la marca con memoria persistente, investigación competitiva mediante búsqueda web, creación de campañas con extensiones de anuncios y comandos de barra para flujos de trabajo comunes. Habilitar el uso de subagentes no cambia este flujo de instalación.

Solo MCP (sin plugin): Si solo quieres las herramientas MCP sin procesar sin el agente:

claude mcp add --transport http adspirer https://mcp.adspirer.com/mcp

ChatGPT

Abre Configuración > Conectores > Añadir conector personalizado
Nombre: Ads MCP
URL: https://mcp.adspirer.com/mcp
Sigue el flujo de inicio de sesión OAuth 2.1

Cursor

Añade a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "adspirer": {
      "url": "https://mcp.adspirer.com/mcp"
    }
  }
}

OpenAI Codex

Añade a ~/.codex/config.toml:

[mcp_servers.adspirer]
url = "https://mcp.adspirer.com/mcp"

Gemini CLI

Instala como extensión:

gemini extensions install github.com/amekala/ads-mcp

Se abre una ventana del navegador para la autenticación OAuth en el primer uso. Comandos personalizados disponibles: /adspirer:setup, /adspirer:performance-review, /adspirer:wasted-spend, /adspirer:write-ad-copy, /adspirer:refresh.

OpenClaw

openclaw plugins install openclaw-adspirer
openclaw adspirer login
openclaw adspirer connect

O instala desde ClawHub.

Perplexity, Manus y otros clientes MCP

Adspirer es un servidor MCP estándar — cualquier cliente que admita conectores MCP con OAuth 2.1 (Perplexity, Manus AI, clientes MCP personalizados) puede conectarse a https://mcp.adspirer.com/mcp. Manus también acepta claves API a través del transporte HTTP transmisible.

API REST (sin necesidad de cliente MCP)

La misma superficie de herramientas se expone como 178 endpoints REST en https://api.adspirer.ai/api/v1/tools/<tool_name>/execute. Autentícate con un Token de Acceso Personal (sk_live_...) creado en adspirer.ai/keys. Swagger: https://api.adspirer.ai/docs. Referencia completa: adspirer.com/docs/api-reference.

Indicaciones de ejemplo

Investigación de palabras clave:

Research keywords for my emergency plumbing business in Chicago.
Show me high-intent keywords with real CPC data and budget recommendations.

Análisis de rendimiento:

Show me campaign performance for the last 30 days across all platforms.
Which campaigns are converting best and what should I optimize?

Creación de campañas:

Create a Google Performance Max campaign for luxury watches targeting
New York with a $50/day budget.

Estrategia multiplataforma:

I want to advertise my handmade jewelry business across Google and LinkedIn.
Research keywords for Google Ads and create a LinkedIn sponsored content campaign
targeting small business owners.

Detalles técnicos

Protocolo: MCP 2025-03-26 (con respaldo a 2024-11-05)
Transporte: HTTP transmisible
OAuth: RFC 8252 (Código de Autorización + PKCE) con RFC 7591 (Registro Dinámico de Clientes) y RFC 9728 (Metadatos de Recursos Protegidos)
Anotaciones de herramientas: Todas las herramientas incluyen metadatos de seguridad MCP (readOnlyHint, destructiveHint)

Seguridad

HTTPS/TLS para toda la transmisión de datos
OAuth 2.1 con PKCE para autenticación
Registro dinámico de clientes para herramientas CLI (Claude Code, Cursor, Codex)
Almacenamiento de tokens cifrado
Sin registro de conversaciones — solo se procesan solicitudes de herramientas

Consulta SECURITY.md para informar vulnerabilidades.

Documentación

Soporte

Correo electrónico: support@adspirer.com
Problemas: https://github.com/amekala/ads-mcp/issues
Sitio web: https://www.adspirer.com
Estado del servidor: https://mcp.adspirer.com/health

Plugins compatibles

Este repositorio distribuye plugins para 4 plataformas de IA desde un solo monorepositorio:

Plataforma	Directorio	Habilidades	Método de instalación
Claude Code	Raíz del repositorio	1 generada + 5 comandos de barra	`/plugin marketplace add`
Claude Tag (@claude)	Upstream: anthropics/claude-tag-plugins PR #3	1 (`adspirer-api`: SKILL + catálogo de 341 herramientas + `ads_call.sh`)	Paquete de acceso de organización (clave Bearer `sk_live_`, hosts `api.adspirer.ai` / `mcp.adspirer.com`); `claude plugin install adspirer@claude-tag-plugins` una vez fusionado
Cursor	`plugins/cursor/adspirer/`	5 generadas a partir de plantillas	`install.sh` (un comando)
Codex	`plugins/codex/adspirer/`	5 generadas a partir de plantillas	`install.sh` (un comando)
Gemini CLI	Raíz del repositorio	1 reutilizada + 5 comandos personalizados	`gemini extensions install`
OpenClaw	`plugins/openclaw/`	1 independiente (autocontenida)	`openclaw plugins install`

Registro de envío de Claude Tag (2026-07-05): el plugin adspirer para Claude Tag (@claude) se envió upstream como anthropics/claude-tag-plugins#3 desde la rama del fork amekala/claude-tag-plugins@add-adspirer-plugin. Envuelve la superficie REST de este repositorio (POST /api/v1/tools/<tool>/execute — la misma capa de herramientas del servidor MCP sobre HTTP simple) en lugar del transporte MCP, y se validó de extremo a extremo en un espacio de trabajo de Claude Tag en vivo (Slack) antes del envío.

Las habilidades para Claude Code, Cursor y Codex se crean una vez en shared/skills/ como plantillas, y luego se compilan en versiones específicas de IDE mediante scripts/sync-skills.sh. La indicación del agente de marketing de rendimiento también se crea una vez en shared/agents/performance-marketing-agent/PROMPT.md y se compila en archivos de agente de Claude Code, Cursor y Codex mediante el mismo script de sincronización. OpenClaw usa su propia habilidad independiente. Consulta Arquitectura para el diseño completo.

Marco de actualización compartido

Edit once (source of truth)
  ├─ shared/skills/adspirer-*/SKILL.md
  └─ shared/agents/performance-marketing-agent/PROMPT.md
                |
                v
        ./scripts/sync-skills.sh
                |
                +--> Claude Code outputs
                |     ├─ skills/<name>/SKILL.md
                |     └─ agents/performance-marketing-agent.md
                |
                +--> Cursor outputs
                |     ├─ plugins/cursor/adspirer/.cursor/skills/adspirer-*/SKILL.md
                |     └─ plugins/cursor/adspirer/.cursor/agents/performance-marketing-agent.md
                |
                +--> Codex outputs
                |     ├─ plugins/codex/adspirer/skills/adspirer-*/SKILL.md
                |     └─ plugins/codex/adspirer/agents/performance-marketing-agent.toml
                |
                +--> Gemini CLI (reuses Claude Code skill)
                |     ├─ gemini-extension.json
                |     ├─ GEMINI.md
                |     └─ commands/adspirer/*.toml
                |
                └--> OpenClaw (standalone, not generated)
                      └─ plugins/openclaw/SKILL.md

Raíces de clientes y objetivos de instalación

Cliente de IA	Raíz de fuente del repositorio	Raíz generada/ejecución en el repositorio	Ruta/método de instalación del usuario
Claude Code	Raíz del repositorio + `shared/skills/` + `shared/agents/`	`skills/`, `agents/`, `commands/`, `.claude-plugin/`	`/plugin marketplace add amekala/ads-mcp` luego `/plugin install adspirer-advertising-agent`
Cursor	`plugins/cursor/adspirer/` + fuentes compartidas	`plugins/cursor/adspirer/.cursor/skills/`, `plugins/cursor/adspirer/.cursor/agents/`	`bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/cursor/adspirer/install.sh)`
Codex	`plugins/codex/adspirer/` + fuentes compartidas	`plugins/codex/adspirer/skills/`, `plugins/codex/adspirer/agents/`	`bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh)`
Gemini CLI	Raíz del repositorio	`gemini-extension.json`, `GEMINI.md`, `commands/adspirer/`	`gemini extensions install github.com/amekala/ads-mcp`
OpenClaw	`plugins/openclaw/`	`plugins/openclaw/` (independiente, sin generación de sincronización)	`openclaw plugins install openclaw-adspirer`

Guía para desarrolladores

Si estás contribuyendo a este repositorio o agregando nuevas plataformas de anuncios/soporte para IDEs:

Arquitectura — Modelo de habilidades compartidas, sistema de plantillas, qué está hecho y qué falta
Sintaxis de plantillas y flujo de sincronización — Sustitución de variables, bloques condicionales, verificaciones de validación
Agregar plataformas de anuncios — Cómo agregar una nueva plataforma de anuncios (por ejemplo, Snapchat, Pinterest, YouTube)
Agregar IDEs — Cómo agregar soporte para un nuevo IDE (por ejemplo, Windsurf, Cline)

Referencia rápida

./scripts/sync-skills.sh          # Generate IDE-specific skills from templates
./scripts/sync-skills.sh --check  # Verify generated files match committed (CI mode)
./scripts/validate.sh             # Run all 62 offline validation checks
./scripts/validate.sh --live      # Also test MCP endpoint connectivity

Nunca edites archivos en plugins/*/skills/, skills/, agents/ o plugins/*/agents/ directamente — serán sobrescritos por el script de sincronización. Edita plantillas en shared/skills/ y prompts compartidos en shared/agents/ en su lugar.

Licencia

Propietaria — Consulta los Términos de servicio para conocer las condiciones de uso.