1. ¿Qué es HilltopAds MCP y qué puedes hacer con él?

¿Qué es HilltopAds MCP?

El servidor MCP (Model Context Protocol) es un conector oficial de HilltopAds para clientes de IA. Una vez conectado, la IA puede acceder a los datos de tu cuenta y, con tu autorización, realizar acciones como crear o actualizar campañas a través de un canal seguro y dedicado, sin que tengas que copiar y pegar información manualmente.

Tu nombre de usuario y contraseña nunca se comparten con el cliente de IA. La conexión se autoriza mediante una clave API que generas desde tu cuenta.

El conector expone tu cuenta de HilltopAds mediante un conjunto de herramientas (Tools). La IA selecciona automáticamente la herramienta adecuada para tu solicitud, la ejecuta y presenta el resultado en un formato fácil de entender, como una tabla, un resumen o incluso un gráfico.

¿Qué puedes hacer con él?

Las herramientas se dividen en dos categorías:

Operaciones de lectura (Read Operations): obtienen datos como el saldo, el inventario, las estadísticas, los detalles de una campaña específica o las listas de fuentes de tráfico de una campaña.

Operaciones de acción (Action Operations): realizan cambios en tu cuenta, como crear o actualizar campañas, iniciarlas o detenerlas, ajustar las pujas (Bids), modificar las URL de destino y gestionar listas negras y listas blancas de fuentes de tráfico.

Las herramientas disponibles dependen del tipo de cuenta que tengas: Advertiser, Publisher o ambas. Actualmente, el conector incluye 27 operaciones: 23 para anunciantes y 4 para publishers.

Las operaciones de acción solo se ejecutan con tu aprobación. Los clientes de IA identifican las herramientas como solo lectura o escritura/eliminación, y solicitan tu confirmación antes de realizar cualquier cambio.

Herramientas de cuenta y estadísticas

Herramienta	Descripción
`advertiser_get_balance`	Muestra el saldo actual de la cuenta del anunciante.
`advertiser_list_inventory`	Muestra tus campañas y sus anuncios.
`advertiser_get_stats`	Muestra estadísticas filtradas o agrupadas por fecha, zona, GEO, campaña, sistema operativo, hora o fuente de tráfico.
`advertiser_get_campaign`	Muestra los detalles completos de una campaña mediante su ID.

Herramientas de gestión de campañas

Nota: En los ejemplos de esta guía, el asistente crea cada campaña en estado Inactive para que puedas revisarla antes de que empiece a consumir presupuesto. Este es simplemente un comportamiento predeterminado elegido por el asistente, no una regla fija. Si deseas que una campaña se cree inactiva o que se lance inmediatamente, indícalo expresamente en tu solicitud.

Herramienta	Descripción
`advertiser_create_campaign`	Crea una nueva campaña.
`advertiser_update_campaign`	Actualiza parcialmente la configuración de una campaña.
`advertiser_start_campaign`	Activa una campaña aprobada.
`advertiser_stop_campaign`	Detiene una campaña en ejecución.
`advertiser_archive_campaign`	Mueve una campaña al archivo.
`advertiser_unarchive_campaign`	Restaura una campaña desde el archivo.
`advertiser_set_bid`	Modifica la puja (Bid) del Wildcard GEO.
`advertiser_set_destination_url`	Cambia la URL de destino de una campaña Popunder.
`advertiser_replace_domain`	Sustituye un dominio en todos los anuncios de la cuenta del anunciante.

Herramientas para la lista negra de fuentes de tráfico (Source Blacklist)

Herramienta	Descripción
`advertiser_get_blacklist`	Muestra la lista negra de fuentes de una campaña.
`advertiser_add_to_blacklist`	Añade fuentes a la lista negra.
`advertiser_remove_from_blacklist`	Elimina fuentes de la lista negra.
`advertiser_clear_campaign_blacklist`	Vacía la lista negra de una campaña.
`advertiser_set_blacklist`	Sustituye toda la lista negra y cambia la campaña al modo BLACKLIST.

Herramientas para la lista blanca de fuentes de tráfico (Source Whitelist)

Herramienta	Descripción
`advertiser_get_whitelist`	Muestra la lista blanca de fuentes de una campaña.
`advertiser_add_to_whitelist`	Añade fuentes a la lista blanca.
`advertiser_remove_from_whitelist`	Elimina fuentes de la lista blanca.
`advertiser_clear_campaign_whitelist`	Vacía la lista blanca de una campaña.
`advertiser_set_whitelist`	Sustituye toda la lista blanca y cambia la campaña al modo WHITELIST.