Agency AI

---

📋 Tabla de Contenidos

• Resumen
• Lo Que Puedes Hacer
• Referencia de Herramientas
• Gestión de Anuncios y Autopiloto
• Plataformas
• Requisitos
• Inicio Rápido
• Ejemplos de Prompts
• Preguntas Frecuentes
• Enlaces

---

🎯 Resumen

Agency AI MCP convierte a Claude y ChatGPT en un gestor de anuncios completo para tus cuentas publicitarias de Meta (Facebook, Instagram) y Google. Haz preguntas, obtén estrategia y realiza cambios reales en tus campañas sin salir del chat:

✨ Análisis de Rendimiento – datos de campañas, desgloses, NCROAS y KPIs avanzados 🎯 Estrategia – recomendaciones de presupuesto, sugerencias creativas, planes de escalado ⚡ Creación y Edición de Anuncios – crea anuncios optimizados para conversiones, actualiza presupuestos, pausa o lanza campañas 🤖 Autopiloto – programa la gestión recurrente de anuncios con las tareas programadas de Claude y ChatGPT ⏱️ Rápido y Eficiente – respuestas más rápidas con menor gasto de tokens que los MCPs directos a plataformas publicitarias

---

🎨 Lo Que Puedes Hacer

📊 Analista

Obtén datos de campañas, desgloses de rendimiento, NCROAS y KPIs avanzados en Meta y Google. Comprende qué funciona y qué no.

💡 Example: "Compare my top 5 campaigns by ROAS last month"

🎯 Estratega

Recibe recomendaciones de presupuesto, sugerencias creativas, planes de escalado y estrategias de planificación de campañas multicanal.

💡 Example: "Which campaigns should I scale and why?"

⚡ Gestor de Anuncios

Crea nuevos anuncios, pausa los de bajo rendimiento, ajusta presupuestos y lanza campañas en Meta y Google en segundos, sin salir del chat. Ponlo en un horario y tu cuenta se gestiona sola.

💡 Example: "Pause all campaigns with ROAS below 2:1"

---

🧰 Referencia de Herramientas

15 herramientas: 10 herramientas de lectura para análisis y 5 herramientas de escritura para la gestión de anuncios.

📖 Herramientas de lectura

Herramienta	Lo que devuelve
get_brand_info	Perfil de la marca y economía: qué vende la tienda, su audiencia y el ROAS de equilibrio
get_campaigns	Campañas de Meta + Google con gasto, ingresos, ROAS, impresiones, clics, conversiones y objetivo
get_adsets	Conjuntos de anuncios de Meta (con presupuesto diario y rendimiento) o grupos de activos de Google
get_ads	Anuncios de Meta con rendimiento para el rango de fechas, ordenados por gasto; también el selector de anuncios fuente para create_ad
get_ad_creative	El creativo de un anuncio de Meta: tipo, texto principal, titular, descripción, CTA, página de destino, URLs de medios
get_performance_timeseries	Gasto diario, ingresos y ROAS por plataforma conectada
get_pacing	Gasto del mes hasta la fecha frente al presupuesto mensual que estableciste, por plataforma
get_anomalies	Días de gasto/ROAS estadísticamente inusuales en los últimos 30 días
get_recommendations	Recomendaciones de optimización con IA, con razonamiento y confianza
get_operation_status	Progreso, resultado o error de una creación de anuncio en cola

✍️ Herramientas de gestión de anuncios (escritura)

Herramienta	Lo que cambia
create_ad	Crea una nueva campaña, conjunto de anuncios o anuncio de Meta, con creativo nuevo optimizado para conversiones o el creativo de un anuncio existente
update_campaign	Nombre de campaña, presupuesto diario y/o estado: Meta y Google
update_adset	Nombre del conjunto de anuncios de Meta, presupuesto diario y/o estado; nombre y/o estado del grupo de activos de Google
update_ad	Nombre y/o estado del anuncio de Meta
set_campaign_status	Inicia o pausa hasta 25 campañas en una sola llamada, en ambas plataformas

---

⚡ Gestión de Anuncios y Autopiloto (herramientas de escritura)

Cinco herramientas de escritura permiten a Claude o ChatGPT crear anuncios, editar campañas y actuar directamente en tu cuenta publicitaria. Nada se ejecuta sin ti: tu asistente confirma cada escritura contigo antes de ejecutarla; consulta las Salvaguardas a continuación.

🛠️ Qué hace cada herramienta de escritura

create_ad – Crea una nueva campaña, conjunto de anuncios o anuncio de Meta. El creativo proviene de uno de dos lugares: creativo nuevo optimizado para conversiones y texto generado por Agency AI, o un anuncio existente que señales (se reutiliza su creativo). placement decide cuánta estructura se crea:

placement	Lo que se crea
new-campaign	Campaña + conjunto de anuncios + anuncio (necesita un presupuesto diario)
new-adset	Conjunto de anuncios + anuncio dentro de una campaña existente
existing-adset	Solo anuncio, dentro de un conjunto de anuncios existente

La creación se ejecuta en segundo plano y devuelve un operation_id; pide a tu asistente que lo revise y llamará a get_operation_status. El horario de un conjunto de anuncios fuente no se hereda: el nuevo conjunto de anuncios se ejecuta sin fecha de finalización a menos que proporciones una futura.

update_campaign – Renombra una campaña, cambia su presupuesto diario y/o la inicia/pausa, en Meta o Google. Cada campo informa su propio resultado, por lo que un resultado parcial ("renombrada, pero el presupuesto fue rechazado") se devuelve honestamente en lugar de como un fallo general.

update_adset – Los mismos tres campos para un conjunto de anuncios de Meta. Los grupos de activos de Google solo admiten nombre y estado; su presupuesto vive en la campaña.

update_ad – Renombra o inicia/pausa un anuncio de Meta. Solo Meta: Google Performance Max no tiene un nivel de anuncio separado.

set_campaign_status – Inicio/pausa masivo de hasta 25 campañas en una sola llamada, mezclando Meta y Google. Cada campaña tiene éxito o falla de forma independiente y el resultado enumera cada resultado, por lo que un ID malo nunca bloquea al resto.

🤖 Autopiloto

Combina las herramientas de escritura con las tareas programadas integradas de Claude y ChatGPT y la gestión rutinaria de anuncios se ejecuta sola. Establece la regla una vez en inglés sencillo; tu asistente la ejecuta según el horario:

• Una revisión diaria a las 9 a.m. que pausa cualquier cosa por debajo del ROAS de equilibrio
• Un reequilibrio de presupuesto los lunes hacia los ganadores de la semana pasada
• Un escaneo diario de anomalías que señala gastos inusuales antes de que se acumulen

🛡️ Salvaguardas

• 🔐 Solo tu cuenta – la cuenta se resuelve desde tu conexión verificada, nunca desde lo que el asistente pasa. Los IDs que no pertenecen a tu cuenta conectada de Meta o Google se rechazan antes de que se escriba nada.
• ✅ Confirmación primero – las herramientas de escritura se declaran a Claude y ChatGPT como destructivas (readOnlyHint: false, destructiveHint: true), por lo que tu asistente pregunta antes de ejecutar una y el cliente puede mostrar su propio aviso de aprobación. El servidor también instruye al modelo para que confirme contigo antes de cualquier escritura.
• 💰 Tope de presupuesto – los presupuestos diarios de Meta están limitados a $1–$5,000/día, en el chat exactamente como en el panel.
• 📋 Mismo pipeline que el panel – las escrituras pasan por los mismos servicios y verificaciones de propiedad que usa el panel de Agency AI, y cada cambio llega a tu registro de actividad.
• 📊 Medido – cada llamada de herramienta se registra para tu cuenta (herramienta, duración, tamaño de respuesta, errores), para que lo que hizo tu asistente sea auditable.
• ↩️ Reversible – cualquier cosa pausada se puede reactivar de la misma manera. Una creación de anuncio en cola se puede verificar con get_operation_status; pausa el resultado si cambias de opinión.

---

🛒 Plataformas

Agency AI MCP funciona con cualquier plataforma de comercio electrónico o sitio web: conecta tus cuentas publicitarias de Meta y Google y todo lo anterior funciona.

¿Usas Shopify? La app de Agency AI para Shopify añade una capa de datos más profunda: ingresos de la tienda comparados con el gasto publicitario, NCROAS y KPIs avanzados, para el análisis y la automatización más precisos. La recomendamos para tiendas de Shopify.

¿No usas Shopify? Crea una cuenta independiente de Agency AI en agencyai.app/mcp y conecta tus cuentas publicitarias de Meta y Google directamente.

---

✅ Requisitos

• ✔️ Una cuenta de Agency AI – instala la app de Shopify o crea una cuenta en cualquier plataforma
• ✔️ Suscripción a Claude Max O plan de ChatGPT que admita conectores personalizados
• ✔️ Al menos una cuenta publicitaria conectada (Meta y/o Google) en Agency AI

---

🚀 Inicio Rápido

URL del Endpoint

https://s.agencyai.app/mcp

Necesitarás esta URL para ChatGPT; Claude encuentra a Agency AI en su directorio de conectores.

📱 Configuración de Claude

1. Abre Claude (claude.ai)
2. Haz clic en tu perfil → Configuración → Conectores
3. Haz clic en Explorar conectores y busca Agency AI
4. Haz clic en Conectar
5. Inicia sesión con tu cuenta de Agency AI cuando se te solicite
6. ✅ ¡Listo! Empieza a preguntarle a Claude sobre tus anuncios

¿No lo ves? Haz clic en Añadir conector personalizado y pega https://s.agencyai.app/mcp.

💬 Configuración de ChatGPT

1. Abre ChatGPT (chatgpt.com)
2. Haz clic en tu perfil → Configuración → Conectores
3. Haz clic en Añadir conector
4. Pega: https://s.agencyai.app/mcp
5. Inicia sesión con tu cuenta de Agency AI cuando se te solicite
6. ✅ ¡Listo! Empieza a preguntarle a ChatGPT sobre tus anuncios

📖 ¿Necesitas pasos detallados? Consulta llms-install.md para una guía completa.

---

💬 Ejemplos de Prompts

Prueba estas preguntas con tu Claude o ChatGPT conectado:

📊 Analysis
"How did my Meta campaigns perform last 30 days vs prior 30?"
"Show me my top 10 best-performing ads by ROAS"
"Which campaigns are underperforming and why?"

🎯 Strategy
"Which ads should I iterate on and which should I cut?"
"Where should I shift budget this week?"
"Give me creative recommendations for my top 5 performers"

⚡ Ad Management
"Pause all campaigns with ROAS below 2:1"
"Create a new ad for our bestseller and launch it in a new campaign at $50/day"
"Raise Spring Drop's daily budget to $150"
"Every weekday at 9am, check my account and pause anything below breakeven"

---

❓ Preguntas Frecuentes

¿Qué es Agency AI MCP? Un servidor MCP que conecta tus cuentas publicitarias de Meta y Google a Claude y ChatGPT. Maneja análisis de rendimiento, optimización de presupuesto, recomendaciones creativas y estrategia de escalado, y crea anuncios, edita campañas y ejecuta tu cuenta en autopiloto, todo por chat.

¿Necesito Shopify? No. Agency AI MCP funciona con cualquier plataforma de comercio electrónico o sitio web. Las tiendas de Shopify obtienen la capa de datos más profunda y la automatización más precisa a través de la app de Agency AI para Shopify, por lo que la recomendamos si usas Shopify.

¿Claude o ChatGPT pueden realmente crear y editar mis anuncios? Sí. Tu asistente puede crear nuevos anuncios optimizados para conversiones, cambiar presupuestos y nombres, y pausar o lanzar campañas, conjuntos de anuncios y anuncios en Meta y Google.

¿Cambiará algo sin mi aprobación? No. Las herramientas de escritura se declaran destructivas para que tu asistente confirme contigo antes de actuar. Los cambios tienen tope de presupuesto, se verifican la propiedad y cada uno llega a tu registro de actividad.

¿En qué se diferencia de conectar los MCPs de Meta o Google directamente? Un solo conector cubre ambas plataformas con KPIs precalculados, una capa de estrategia y creación de anuncios integrada. Las respuestas llegan más rápido con menor gasto de tokens que los MCPs directos a plataformas publicitarias.

¿Cuánto cuesta? El acceso a MCP está incluido en los planes de Agency AI. Crea una cuenta en agencyai.app/mcp para empezar.

---

🔗 Enlaces

Enlace	Propósito
🌐 Sitio web	Aprende más sobre Agency AI
🚀 Comenzar	Crea una cuenta y conéctate
🛍️ App de Shopify	Instala desde la tienda de apps de Shopify
📧 Soporte	Obtén ayuda o envía comentarios

📄 Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0; consulta el archivo LICENSE para más detalles.