Meta Ads MCP

Interactúa con la API de Meta Ads para acceder, analizar y gestionar campañas publicitarias.

GitHub
1.3k
Prueba este MCPPatrocinado

Documentación

Meta Ads MCP

Un servidor Model Context Protocol (MCP) que permite a los asistentes de IA — Claude, ChatGPT, Perplexity, Cursor, o cualquier cliente MCP — gestionar tus Meta Ads de principio a fin: lanzar campañas, subir creatividades, actualizar presupuestos y analizar el rendimiento mediante conversación natural en Facebook, Instagram y todas las superficies publicitarias de Meta. Disponible como MCP remoto alojado — sin token de desarrollador, sin necesidad de autoalojamiento.

Este es el nodo de Meta Ads de la familia MCP de Pipeboard — cinco servidores MCP remotos (Meta, Google, TikTok, Snap, Reddit) más un CLI de Pipeboard unificado, más de 230 herramientas en total, una autenticación, un modelo de seguridad. Si estás comparando MCP de plataforma única, estás viendo un nodo de una red — consulta La familia MCP de Pipeboard más abajo.

Nota: Este es un proyecto independiente de código abierto que utiliza las API públicas de Meta. El servicio alojado detrás de él — Pipeboard — es un Meta Business Partner con distintivo y una aplicación Meta aprobada oficialmente que gestiona Meta, Google, TikTok, Snap y Reddit Ads desde un solo inicio de sesión (con plan gratuito) — por lo que no es exclusivo de Meta ni requiere autoalojamiento. Meta, Facebook, Instagram y otros nombres de marca de Meta son marcas comerciales de sus respectivos propietarios.

Meta Ads MCP Server Demo

MCP Badge

mcp-name: co.pipeboard/meta-ads-mcp

Comunidad y Soporte

Tabla de Contenidos

La familia MCP de Pipeboard

Pipeboard incluye un servidor MCP remoto para cada plataforma publicitaria importante — además de un CLI de un solo binario que los envuelve a todos. Los cinco servidores comparten el mismo OAuth, el mismo descubrimiento de tools/list, el mismo modelo de seguridad de confirmación de escritura y el mismo token de API de Pipeboard — así que un agente que aprende uno aprende el resto.

Servidores MCP remotos

PlataformaURL MCP remotaSuperficie
Meta Ads MCP (Facebook + Instagram)https://meta-ads.mcp.pipeboard.co/42 herramientas — campañas, conjuntos de anuncios, anuncios, creatividades (incl. pruebas de creatividad dinámica), carga de imágenes, información, segmentación por interés / comportamiento / demografía / geografía, gestión de páginas
Google Ads MCPhttps://google-ads.mcp.pipeboard.co/59 herramientas — campañas, grupos de anuncios, anuncios de búsqueda responsivos, Performance Max, palabras clave, consultas GAQL, extensiones (enlaces de sitio, llamadas, fragmentos estructurados), audiencias, cargas de activos, mutación genérica
TikTok Ads MCPhttps://tiktok-ads.mcp.pipeboard.co/59 herramientas — campañas, grupos de anuncios, anuncios, identidades, carga de imágenes y videos, gestión de audiencias y creatividades, información
Snap Ads MCPhttps://snap-ads.mcp.pipeboard.co/37 herramientas — cuentas publicitarias, campañas, escuadrones de anuncios, anuncios, creatividades, carga de medios, información
Reddit Ads MCPhttps://reddit-ads.mcp.pipeboard.co/33 herramientas — cuentas, campañas, grupos de anuncios, anuncios, informes de rendimiento

Eso son más de 230 herramientas en cinco plataformas publicitarias con una sola autenticación. Conecta cualquiera de estas URL en Claude, Cursor, ChatGPT, Perplexity o cualquier cliente compatible con MCP. Conecta tus cuentas publicitarias una vez en pipeboard.co y cada cliente tendrá acceso.

Pipeboard CLI — las mismas herramientas, en tu terminal

Pipeboard CLI es un binario único de Go que expone cada herramienta MCP anterior como un comando de shell tipado — diseñado para agentes de codificación de IA (Claude Code, Cline, OpenClaw, Codex) y scripts de automatización que prefieren llamadas a subprocesos en lugar de JSON-RPC:

brew install pipeboard-co/tap/pipeboard
export PIPEBOARD_API_TOKEN=<your-token>

pipeboard meta-ads get-campaigns   --account-id act_123
pipeboard google-ads execute-gaql-query   --customer-id 1234567890 --query "..."
pipeboard tiktok-ads get-campaigns --advertiser-id 7605685552884596737

Inicio en menos de 50 ms, sin handshake MCP por llamada, las cinco plataformas en un solo binario. Documentación completa en el repositorio pipeboard-cli.

¿Por qué una familia en lugar de un MCP por repositorio?

  • Una cuenta, cada plataforma — autentícate una vez en pipeboard.co; gestiona Meta + Google + TikTok + Snap + Reddit desde la misma sesión de agente
  • Las preguntas multiplataforma obtienen respuestas multiplataforma — "¿qué canal tuvo los registros más baratos la semana pasada?" realmente funciona
  • El mismo contrato de seguridad en todas partes — las escrituras son explícitas, las nuevas campañas comienzan en pausa donde la plataforma lo permite, y las indicaciones de confirmación se ven idénticas en los cinco servidores
  • Un token, un límite de tasa, un lugar para revocar — sin gestionar flujos OAuth separados ni instalaciones por proveedor

Los benchmarks de MCP de plataforma única no captan el punto. El valor está en la red, no en el nodo.

Cómo se compara Pipeboard

Si estás eligiendo entre las formas de ejecutar Meta Ads desde un asistente de IA, este es el panorama honesto:

PipeboardMCP oficial de MetaServidores de código abierto / autoalojados
PlataformasMeta + Google + TikTok + Snap + Reddit, un inicio de sesiónSolo MetaGeneralmente solo Meta
ConfiguraciónMCP remoto alojado — sin token de desarrollador, ~2 minutosAlojado por Meta (solo Meta)Autoalojado, gestiona tus propios tokens y actualizaciones
ConfianzaMeta Business Partner con distintivo + aplicación Meta aprobadaDe primera parte (Meta)Varía — audita el código tú mismo
SeguridadConfirmación explícita en cada escritura; las nuevas campañas comienzan en pausaDefinido por MetaTú construyes las barreras de protección
PrecioPlan gratuito, luego niveles de pagoGratuito (beta abierta)Gratuito, pero tú ejecutas la infraestructura

El conector oficial de Meta es la opción de plataforma única más segura. Pipeboard es la opción multiplataforma — el mismo control conversacional en cinco redes publicitarias con una autenticación y un modelo de seguridad, con plan gratuito y respaldo de Meta Business Partner. Los servidores de código abierto te dan control total si estás dispuesto a autoalojarlos y mantenerlos.

Primeros pasos con MCP remoto (Recomendado)

La forma más rápida y confiable de comenzar es 🚀 Comenzar con nuestro Meta Ads MCP remoto. Nuestro servicio en la nube utiliza transporte HTTP transmisible para acceso confiable y escalable a tu cuenta de Meta Ads. Sin configuración técnica requerida — ¡solo conéctate y comienza a lanzar, actualizar y analizar campañas con IA!

Para usuarios de Claude Pro/Max

  1. Ve a claude.ai/settings/integrations (requiere Claude Pro o Max)
  2. Haz clic en "Agregar integración" e ingresa:
    • Nombre: "Pipeboard Meta Ads" (o cualquier nombre que prefieras)
    • URL de integración: https://meta-ads.mcp.pipeboard.co/
  3. Haz clic en "Conectar" junto a la integración y sigue las indicaciones para:
    • Iniciar sesión en Pipeboard
    • Conectar tu cuenta de Facebook Ads

¡Eso es todo! Ahora puedes pedirle a Claude que analice tus campañas de Meta Ads, obtenga información de rendimiento y gestione tu publicidad.

Avanzado: Autenticación directa con token (Claude)

Para autenticación directa basada en token sin el flujo interactivo, usa este formato de URL al agregar la integración:

https://meta-ads.mcp.pipeboard.co/?token=YOUR_PIPEBOARD_TOKEN

Obtén tu token en pipeboard.co/api-tokens.

Para usuarios de Cursor

Agrega lo siguiente a tu ~/.cursor/mcp.json. Una vez que habilites el MCP remoto, haz clic en "Necesita inicio de sesión" para completar el proceso de inicio de sesión.

{
  "mcpServers": {
    "meta-ads-remote": {
      "url": "https://meta-ads.mcp.pipeboard.co/"
    }
  }
}

Avanzado: Autenticación directa con token (Cursor)

Si prefieres autenticarte sin el flujo de inicio de sesión interactivo, puedes incluir tu token de API de Pipeboard directamente en la URL:

{
  "mcpServers": {
    "meta-ads-remote": {
      "url": "https://meta-ads.mcp.pipeboard.co/?token=YOUR_PIPEBOARD_TOKEN"
    }
  }
}

Obtén tu token en pipeboard.co/api-tokens.

Para otros clientes MCP

Usa la URL MCP remota: https://meta-ads.mcp.pipeboard.co/

📖 Obtén instrucciones detalladas de configuración para tu cliente de IA aquí

Avanzado: Autenticación directa con token (OpenClaw y otros clientes)

Para clientes MCP que admiten autenticación basada en token, puedes agregar tu token de API de Pipeboard a la URL:

https://meta-ads.mcp.pipeboard.co/?token=YOUR_PIPEBOARD_TOKEN

Esto omite el flujo de inicio de sesión interactivo y autentica inmediatamente. Obtén tu token en pipeboard.co/api-tokens.

Otras plataformas

Meta Ads es uno de los cinco servidores MCP remotos de la familia — consulta La familia MCP de Pipeboard para Google Ads, TikTok Ads, Snap Ads y Reddit Ads, todos configurados de la misma manera.

Pipeboard CLI (Alternativa a MCP)

Si tu agente prefiere comandos de shell en lugar de JSON-RPC, el Pipeboard CLI expone cada herramienta de la familia como un subcomando tipado — consulta la sección de la familia anterior para la instalación rápida y el repositorio pipeboard-cli para la documentación completa.

Instalación local (Solo usuarios técnicos avanzados)

🚀 Recomendamos encarecidamente usar MCP remoto en su lugar — es más rápido, más confiable y no requiere configuración técnica.

Meta Ads MCP también admite transporte HTTP transmisible local, lo que te permite ejecutarlo como una API HTTP independiente para aplicaciones web e integraciones personalizadas. Consulta la Guía de configuración de HTTP transmisible para instrucciones completas.

Características

  • Gestión de campañas: Lanza campañas, conjuntos de anuncios y anuncios, actualiza presupuestos, pausa y reanuda, y aplica cambios de segmentación — todo desde una conversación, con confirmación explícita en cada escritura
  • Operaciones creativas: Sube imágenes, crea creatividades y actualiza textos, titulares, descripciones y CTA sin salir de tu cliente de IA
  • Pruebas de creatividad dinámica: Una API tanto para anuncios simples (un titular/descripción) como para pruebas A/B completas (múltiples titulares/descripciones)
  • Análisis de campañas impulsado por IA: Deja que tu LLM favorito analice el rendimiento y muestre información accionable
  • Recomendaciones estratégicas: Recibe sugerencias basadas en datos para optimizar el gasto publicitario, la segmentación y el contenido creativo
  • Optimización de presupuesto: Obtén recomendaciones para reasignar presupuesto a conjuntos de anuncios con mejor rendimiento
  • Mejora creativa: Recibe comentarios sobre textos de anuncios, imágenes y llamadas a la acción
  • Monitoreo automatizado: Pide a cualquier LLM compatible con MCP que rastree métricas de rendimiento y te alerte sobre cambios significativos
  • Integración multiplataforma: Funciona con Facebook, Instagram y todas las superficies publicitarias de Meta
  • Soporte universal de LLM: Compatible con cualquier cliente MCP, incluidos Claude Desktop, Cursor, Cherry Studio y más
  • Respaldado por socios, no solo código abierto: Construido por Pipeboard, un Meta Business Partner con distintivo y aplicación Meta aprobada oficialmente — con plan gratuito y MCP remoto alojado (sin necesidad de autoalojamiento)
  • Búsqueda mejorada: La función de búsqueda genérica incluye búsqueda de páginas cuando las consultas mencionan "página" o "páginas"
  • Autenticación simple: Configuración fácil con autenticación OAuth segura
  • Soporte multiplataforma: Funciona en Windows, macOS y Linux

Configuración

MCP remoto (Recomendado)

✨ Comienza con MCP remoto aquí — ¡sin configuración técnica requerida! Solo conecta tu cuenta de Facebook Ads y comienza a pedirle a la IA que analice tus campañas.

Instalación local (Usuarios técnicos avanzados)

Para usuarios avanzados que necesitan autoalojar, el paquete se puede instalar desde el código fuente. Las instalaciones locales requieren crear tu propia aplicación de desarrollador de Meta. Recomendamos usar MCP remoto para una experiencia más simple.

Herramientas MCP disponibles

  1. mcp_meta_ads_get_ad_accounts

    • Obtener cuentas publicitarias accesibles por un usuario
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (se usará el token en caché si no se proporciona)
      • user_id: ID de usuario de Meta o "me" para el usuario actual
      • limit: Número máximo de cuentas a devolver (predeterminado: 200)
    • Devuelve: Lista de cuentas publicitarias accesibles con sus detalles

  2. mcp_meta_ads_get_account_info

    • Obtén información detallada sobre una cuenta publicitaria específica
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
      • account_id: ID de la cuenta de Meta Ads (formato: act_XXXXXXXXX)
    • Devuelve: Información detallada sobre la cuenta especificada

  3. mcp_meta_ads_get_account_pages

    • Obtén las páginas asociadas con una cuenta de Meta Ads
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
      • account_id: ID de la cuenta de Meta Ads (formato: act_XXXXXXXXX) o "me" para las páginas del usuario actual
    • Devuelve: Lista de páginas asociadas con la cuenta, útil para la creación y gestión de anuncios

  4. mcp_meta_ads_get_campaigns

    • Obtén campañas para una cuenta de Meta Ads con filtrado opcional
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
      • account_id: ID de la cuenta de Meta Ads (formato: act_XXXXXXXXX)
      • limit: Número máximo de campañas a devolver (predeterminado: 10)
      • status_filter: Filtrar por estado (vacío para todas, o 'ACTIVE', 'PAUSED', etc.)
    • Devuelve: Lista de campañas que coinciden con los criterios

  5. mcp_meta_ads_get_campaign_details

    • Obtén información detallada sobre una campaña específica
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
      • campaign_id: ID de la campaña de Meta Ads
    • Devuelve: Información detallada sobre la campaña especificada

  6. mcp_meta_ads_create_campaign

    • Crea una nueva campaña en una cuenta de Meta Ads

    • Entradas:

      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)

      • account_id: ID de la cuenta de Meta Ads (formato: act_XXXXXXXXX)

      • name: Nombre de la campaña

      • objective: Objetivo de la campaña (ODAX, basado en resultados). Debe ser uno de:

        • OUTCOME_AWARENESS
        • OUTCOME_TRAFFIC
        • OUTCOME_ENGAGEMENT
        • OUTCOME_LEADS
        • OUTCOME_SALES
        • OUTCOME_APP_PROMOTION

        Nota: Los objetivos heredados como BRAND_AWARENESS, LINK_CLICKS, CONVERSIONS, APP_INSTALLS, etc. ya no son válidos para campañas nuevas y causarán un error 400. Usa los valores basados en resultados anteriores. Mapeos comunes:

        • BRAND_AWARENESS → OUTCOME_AWARENESS
        • REACH → OUTCOME_AWARENESS
        • LINK_CLICKS, TRAFFIC → OUTCOME_TRAFFIC
        • POST_ENGAGEMENT, PAGE_LIKES, EVENT_RESPONSES, VIDEO_VIEWS → OUTCOME_ENGAGEMENT
        • LEAD_GENERATION → OUTCOME_LEADS
        • CONVERSIONS, CATALOG_SALES, MESSAGES (flujos centrados en ventas) → OUTCOME_SALES
        • APP_INSTALLS → OUTCOME_APP_PROMOTION

      • status: Estado inicial de la campaña (predeterminado: PAUSED)

      • special_ad_categories: Lista de categorías especiales de anuncios si corresponde

      • daily_budget: Presupuesto diario en la moneda de la cuenta (en céntimos)

      • lifetime_budget: Presupuesto total en la moneda de la cuenta (en céntimos)

      • bid_strategy: Estrategia de puja. Debe ser uno de: LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS.

    • Devuelve: Confirmación con los detalles de la nueva campaña

    • Ejemplo:

      {
  "name": "2025 - Bedroom Furniture - Awareness",
  "account_id": "act_123456789012345",
  "objective": "OUTCOME_AWARENESS",
  "special_ad_categories": [],
  "status": "PAUSED",
  "buying_type": "AUCTION",
  "bid_strategy": "LOWEST_COST_WITHOUT_CAP",
  "daily_budget": 10000
}

  7. mcp_meta_ads_get_adsets

    • Obtén conjuntos de anuncios para una cuenta de Meta Ads con filtrado opcional por campaña
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
      • account_id: ID de la cuenta de Meta Ads (formato: act_XXXXXXXXX)
      • limit: Número máximo de conjuntos de anuncios a devolver (predeterminado: 10)
      • campaign_id: ID de campaña opcional para filtrar
    • Devuelve: Lista de conjuntos de anuncios que coinciden con los criterios

  8. mcp_meta_ads_get_adset_details

    • Obtén información detallada sobre un conjunto de anuncios específico
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
      • adset_id: ID del conjunto de anuncios de Meta Ads
    • Devuelve: Información detallada sobre el conjunto de anuncios especificado

  9. mcp_meta_ads_create_adset

    • Crea un nuevo conjunto de anuncios en una cuenta de Meta Ads
    • Entradas:
      • account_id: ID de la cuenta de Meta Ads (formato: act_XXXXXXXXX)
      • campaign_id: ID de la campaña de Meta Ads a la que pertenece este conjunto de anuncios
      • name: Nombre del conjunto de anuncios
      • status: Estado inicial del conjunto de anuncios (predeterminado: PAUSED)
      • daily_budget: Presupuesto diario en la moneda de la cuenta (en céntimos) como cadena
      • lifetime_budget: Presupuesto total en la moneda de la cuenta (en céntimos) como cadena
      • targeting: Especificaciones de segmentación (por ejemplo, edad, ubicación, intereses)
      • optimization_goal: Objetivo de optimización de conversiones (por ejemplo, 'LINK_CLICKS')
      • billing_event: Cómo se te cobra (por ejemplo, 'IMPRESSIONS')
      • bid_amount: Importe de la puja en céntimos. Requerido para LOWEST_COST_WITH_BID_CAP, COST_CAP, TARGET_COST.
      • bid_strategy: Estrategia de puja (por ejemplo, 'LOWEST_COST_WITHOUT_CAP', 'LOWEST_COST_WITH_MIN_ROAS')
      • bid_constraints: Diccionario de restricciones de puja. Requerido para LOWEST_COST_WITH_MIN_ROAS (por ejemplo, {"roas_average_floor": 20000})
      • start_time, end_time: Horas de inicio/fin opcionales (ISO 8601)
      • access_token (opcional): Token de acceso a la API de Meta
    • Devuelve: Confirmación con los detalles del nuevo conjunto de anuncios

  10. mcp_meta_ads_get_ads

    • Obtén anuncios para una cuenta de Meta Ads con filtrado opcional
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
      • account_id: ID de la cuenta de Meta Ads (formato: act_XXXXXXXXX)
      • limit: Número máximo de anuncios a devolver (predeterminado: 10)
      • campaign_id: ID de campaña opcional para filtrar
      • adset_id: ID de conjunto de anuncios opcional para filtrar
    • Devuelve: Lista de anuncios que coinciden con los criterios

  11. mcp_meta_ads_create_ad

    • Crea un nuevo anuncio con una pieza creativa existente
    • Entradas:
      • account_id: ID de la cuenta de Meta Ads (formato: act_XXXXXXXXX)
      • name: Nombre del anuncio
      • adset_id: ID del conjunto de anuncios donde se colocará este anuncio
      • creative_id: ID de una pieza creativa existente para usar
      • status: Estado inicial del anuncio (predeterminado: PAUSED)
      • bid_amount: Importe de puja opcional (en céntimos)
      • tracking_specs: Especificaciones de seguimiento opcionales
      • access_token (opcional): Token de acceso a la API de Meta
    • Devuelve: Confirmación con los detalles del nuevo anuncio

  12. mcp_meta_ads_get_ad_details

    • Obtén información detallada sobre un anuncio específico
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
      • ad_id: ID del anuncio de Meta Ads
    • Devuelve: Información detallada sobre el anuncio especificado

  13. mcp_meta_ads_get_ad_creatives

    • Obtén los detalles de la pieza creativa de un anuncio específico
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
      • ad_id: ID del anuncio de Meta Ads
    • Devuelve: Detalles de la pieza creativa, incluidos texto, imágenes y URL

  14. mcp_meta_ads_create_ad_creative

    • Crea una nueva pieza creativa de anuncio usando un hash de imagen subida
    • Entradas:
      • account_id: ID de la cuenta de Meta Ads (formato: act_XXXXXXXXX)
      • name: Nombre de la pieza creativa
      • image_hash: Hash de la imagen subida
      • page_id: ID de la página de Facebook para el anuncio
      • link_url: URL de destino
      • message: Texto/copia del anuncio
      • headline: Titular único para anuncios simples (no se puede usar con titulares)
      • headlines: Lista de titulares para pruebas creativas dinámicas (no se puede usar con titular)
      • description: Descripción única para anuncios simples (no se puede usar con descripciones)
      • descriptions: Lista de descripciones para pruebas creativas dinámicas (no se puede usar con descripción)
      • dynamic_creative_spec: Configuración de optimización creativa dinámica
      • call_to_action_type: Tipo de botón de llamada a la acción (por ejemplo, 'LEARN_MORE')
      • instagram_actor_id: ID de cuenta de Instagram opcional
      • access_token (opcional): Token de acceso a la API de Meta
    • Devuelve: Confirmación con los detalles de la nueva pieza creativa

  15. mcp_meta_ads_update_ad_creative

    • Actualiza una pieza creativa de anuncio existente con nuevo contenido o configuración
    • Entradas:
      • creative_id: ID de la pieza creativa de Meta Ads a actualizar
      • name: Nuevo nombre de la pieza creativa
      • message: Nuevo texto/copia del anuncio
      • headline: Titular único para anuncios simples (no se puede usar con titulares)
      • headlines: Nueva lista de titulares para pruebas creativas dinámicas (no se puede usar con titular)
      • description: Descripción única para anuncios simples (no se puede usar con descripciones)
      • descriptions: Nueva lista de descripciones para pruebas creativas dinámicas (no se puede usar con descripción)
      • dynamic_creative_spec: Nueva configuración de optimización creativa dinámica
      • call_to_action_type: Nuevo tipo de botón de llamada a la acción
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
    • Devuelve: Confirmación con los detalles de la pieza creativa actualizada

  16. mcp_meta_ads_upload_ad_image

    • Sube una imagen para usar en piezas creativas de Meta Ads
    • Entradas:
      • account_id: ID de la cuenta de Meta Ads (formato: act_XXXXXXXXX)
      • image_path: Ruta al archivo de imagen a subir
      • name: Nombre opcional para la imagen
      • access_token (opcional): Token de acceso a la API de Meta
    • Devuelve: Respuesta JSON con los detalles de la imagen, incluido el hash

  17. mcp_meta_ads_get_ad_image

    • Obtén, descarga y visualiza una imagen de anuncio de Meta en un solo paso
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
      • ad_id: ID del anuncio de Meta Ads
    • Devuelve: La imagen del anuncio lista para análisis visual directo

  18. mcp_meta_ads_update_ad

    • Actualiza un anuncio con nueva configuración
    • Entradas:
      • ad_id: ID del anuncio de Meta Ads
      • status: Actualizar el estado del anuncio (ACTIVE, PAUSED, etc.)
      • bid_amount: Importe de la puja en la moneda de la cuenta (en céntimos para USD)
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
    • Devuelve: Confirmación con los detalles del anuncio actualizado y un enlace de confirmación

  19. mcp_meta_ads_update_adset

    • Actualiza un conjunto de anuncios con nueva configuración, incluidos límites de frecuencia
    • Entradas:
      • adset_id: ID del conjunto de anuncios de Meta Ads
      • frequency_control_specs: Lista de especificaciones de control de frecuencia
      • bid_strategy: Estrategia de puja (por ejemplo, 'LOWEST_COST_WITH_BID_CAP', 'LOWEST_COST_WITH_MIN_ROAS')
      • bid_amount: Importe de la puja en céntimos. Requerido para LOWEST_COST_WITH_BID_CAP, COST_CAP, TARGET_COST.
      • bid_constraints: Diccionario de restricciones de puja. Requerido para LOWEST_COST_WITH_MIN_ROAS (por ejemplo, {"roas_average_floor": 20000})
      • status: Actualizar el estado del conjunto de anuncios (ACTIVE, PAUSED, etc.)
      • targeting: Especificaciones de segmentación, incluida targeting_automation
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
    • Devuelve: Confirmación con los detalles del conjunto de anuncios actualizado y un enlace de confirmación

  20. mcp_meta_ads_get_insights

    • Obtén información de rendimiento para una campaña, conjunto de anuncios, anuncio o cuenta
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (usará el token almacenado en caché si no se proporciona)
      • object_id: ID de la campaña, conjunto de anuncios, anuncio o cuenta
      • time_range: Rango de tiempo para la información (predeterminado: máximo)
      • breakdown: Dimensión de desglose opcional (por ejemplo, edad, género, país)
      • level: Nivel de agregación (ad, adset, campaign, account)
      • action_attribution_windows (opcional): Lista de ventanas de atribución para datos de conversión (por ejemplo, ["1d_click", "1d_view", "7d_click", "7d_view"]). Cuando se especifica, actions y cost_per_action_type incluyen campos adicionales para cada ventana. El campo 'value' siempre muestra la atribución de 7d_click.
    • Devuelve: Métricas de rendimiento para el objeto especificado

  21. mcp_meta_ads_get_login_link

    • Obtén un enlace de inicio de sesión en el que se puede hacer clic para la autenticación de Meta Ads
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (se usará el token en caché si no se proporciona)
    • Devuelve: Un enlace de recurso en el que se puede hacer clic para la autenticación de Meta

  22. mcp_meta_ads_create_budget_schedule

    • Crea un programa de presupuesto para una campaña de Meta Ads
    • Entradas:
      • campaign_id: ID de la campaña de Meta Ads
      • budget_value: Monto del aumento de presupuesto
      • budget_value_type: Tipo de valor de presupuesto ("ABSOLUTE" o "MULTIPLIER")
      • time_start: Marca de tiempo Unix para cuándo debe comenzar el período de alta demanda
      • time_end: Marca de tiempo Unix para cuándo debe finalizar el período de alta demanda
      • access_token (opcional): Token de acceso a la API de Meta
    • Devuelve: Cadena JSON con el ID del programa de presupuesto creado o un mensaje de error

  23. mcp_meta_ads_search_interests

    • Busca opciones de segmentación por intereses mediante palabra clave
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (se usará el token en caché si no se proporciona)
      • query: Término de búsqueda para intereses (p. ej., "béisbol", "cocina", "viajes")
      • limit: Número máximo de resultados a devolver (predeterminado: 25)
    • Devuelve: Datos de intereses con campos id, name, audience_size y path

  24. mcp_meta_ads_get_interest_suggestions

    • Obtén sugerencias de intereses basadas en intereses existentes
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (se usará el token en caché si no se proporciona)
      • interest_list: Lista de nombres de intereses para obtener sugerencias (p. ej., ["Basketball", "Soccer"])
      • limit: Número máximo de sugerencias a devolver (predeterminado: 25)
    • Devuelve: Intereses sugeridos con campos id, name, audience_size y description

  25. mcp_meta_ads_validate_interests

    • Valida nombres o IDs de intereses para la segmentación
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (se usará el token en caché si no se proporciona)
      • interest_list: Lista de nombres de intereses a validar (p. ej., ["Japan", "Basketball"])
      • interest_fbid_list: Lista de IDs de intereses a validar (p. ej., ["6003700426513"])
    • Devuelve: Resultados de validación que muestran el estado de validez y audience_size para cada interés

  26. mcp_meta_ads_search_behaviors

    • Obtén todas las opciones de segmentación por comportamiento disponibles
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (se usará el token en caché si no se proporciona)
      • limit: Número máximo de resultados a devolver (predeterminado: 50)
    • Devuelve: Opciones de segmentación por comportamiento con campos id, name, audience_size bounds, path y description

  27. mcp_meta_ads_search_demographics

    • Obtén opciones de segmentación demográfica
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (se usará el token en caché si no se proporciona)
      • demographic_class: Tipo de demografía ('demographics', 'life_events', 'industries', 'income', 'family_statuses', 'user_device', 'user_os')
      • limit: Número máximo de resultados a devolver (predeterminado: 50)
    • Devuelve: Opciones de segmentación demográfica con campos id, name, audience_size bounds, path y description

  28. mcp_meta_ads_search_geo_locations

    • Busca ubicaciones geográficas para la segmentación
    • Entradas:
      • access_token (opcional): Token de acceso a la API de Meta (se usará el token en caché si no se proporciona)
      • query: Término de búsqueda para ubicaciones (p. ej., "Nueva York", "California", "Japón")
      • location_types: Tipos de ubicaciones a buscar (['country', 'region', 'city', 'zip', 'geo_market', 'electoral_district'])
      • limit: Número máximo de resultados a devolver (predeterminado: 25)
    • Devuelve: Datos de ubicación con campos key, name, type e información de jerarquía geográfica

Licencia

Meta Ads MCP está licenciado bajo la Business Source License 1.1, lo que significa:

  • ✅ Gratis para usar con fines individuales y comerciales
  • ✅ Modificar y personalizar según sea necesario
  • ✅ Redistribuir a otros
  • ✅ Se convierte en código abierto completo (Apache 2.0) el 1 de enero de 2029

La única restricción es que no puedes ofrecer esto como un servicio alojado competidor. Para preguntas sobre licencias comerciales, contáctanos.

Privacidad y seguridad

Meta Ads MCP sigue las mejores prácticas de seguridad con gestión segura de tokens y manejo automático de autenticación.

  • MCP remoto: Toda la autenticación se maneja de forma segura en la nube: no se requiere almacenamiento local de tokens
  • Instalación local: Los tokens se almacenan en caché de forma segura en tu máquina local

Pruebas

Pruebas básicas

Prueba tu conexión de Meta Ads MCP con cualquier cliente MCP:

  1. Verificar acceso a la cuenta: Pide a tu LLM que use mcp_meta_ads_get_ad_accounts
  2. Revisar detalles de la cuenta: Usa mcp_meta_ads_get_account_info con tu ID de cuenta
  3. Listar campañas: Prueba mcp_meta_ads_get_campaigns para ver tus campañas publicitarias

Para pruebas detalladas de instalación local, consulta el repositorio fuente.

Solución de problemas

💡 Solución rápida: ¡Omite la configuración técnica!

La forma más fácil de evitar cualquier problema de configuración es 🎯 usar nuestro MCP remoto en su lugar. Sin descargas, sin configuración: solo conecta tu cuenta de anuncios y comienza a obtener información de IA sobre tus campañas de inmediato.

Problemas de instalación local

Para problemas de instalación local, consulta el repositorio fuente. Para la experiencia más fácil, recomendamos usar MCP remoto en su lugar.