PropellerAds MCP Server
Servidor MCP de PropellerAds
Democratizando la publicidad programática con IA
Deja que asistentes de IA como Claude gestionen tus campañas publicitarias en PropellerAds automáticamente.
Inicio rápido • Herramientas disponibles • Ejemplos de uso • Configuración de MCP
¿Qué es esto?
PropellerAds MCP es un servidor del Protocolo de Contexto de Modelos (MCP) que conecta a los asistentes de IA (Claude y cualquier cliente compatible con MCP) directamente con la API de la plataforma publicitaria PropellerAds. En lugar de iniciar sesión manualmente en los paneles, extraer informes y hacer clic en la configuración, simplemente hablas con tu asistente de IA en lenguaje natural y él se encarga de todo por ti.
Crea campañas, analiza el rendimiento, añade zonas de bajo rendimiento a listas negras, encuentra oportunidades de escalado, compara periodos de tiempo... todo a través de una conversación natural.
Creado para:
Compradores de medios y especialistas en marketing de rendimiento
Afiliados de iGaming y de instalación de aplicaciones
Growth Hackers y agencias digitales
Cualquier persona que ejecute campañas en PropellerAds y quiera trabajar más rápido
Related MCP server: Google Ad Manager MCP Server
Características
Ciclo de vida completo de la campaña -- Crea, actualiza, inicia, detén y clona campañas sin salir de tu chat
Análisis de rendimiento en tiempo real -- Impresiones, clics, conversiones, CTR, CVR, CPC, CPA y ROI calculados automáticamente
Comparación periodo a periodo -- Compara dos rangos de fechas cualesquiera lado a lado con indicadores de tendencia
Optimización a nivel de zona -- Encuentra zonas de bajo rendimiento que desperdician presupuesto y zonas principales que vale la pena incluir en listas blancas
Listas negras automatizadas -- Un comando para identificar y añadir zonas malas a la lista negra (con modo de seguridad de prueba)
Inteligencia de escalado -- Encuentra automáticamente campañas con un ROI sólido y volumen de conversión listas para escalar
Desglose del rendimiento creativo -- Mira qué creatividades generan resultados y cuáles necesitan ser reemplazadas
Seguro por diseño -- Token de API almacenado en variables de entorno, nunca expuesto en la conversación
Seguridad de prueba (Dry Run) -- Las operaciones destructivas se ejecutan por defecto en modo de vista previa antes de ejecutarse
Herramientas disponibles
Gestión de campañas
Herramienta | Descripción | Parámetros requeridos |
| Lista todas las campañas con filtros opcionales | -- |
| Obtiene información completa de la campaña (segmentación, creatividades, configuración) |
|
| Crea una nueva campaña publicitaria |
|
| Modifica la configuración de la campaña (presupuesto, puja, nombre, estado) |
|
| Activa una o más campañas pausadas |
|
| Pausa una o más campañas activas |
|
| Duplica una campaña existente |
|
Filtros para list_campaigns: status (active/paused/pending/rejected), ad_format (push/onclick/interstitial/in-page-push), name (coincidencia parcial)
Estadísticas y análisis
Herramienta | Descripción | Parámetros requeridos |
| Estadísticas detalladas con métricas calculadas (CTR, CVR, CPC, CPA, ROI) | -- |
| Resumen de rendimiento para una campaña específica |
|
| Compara dos periodos de tiempo con indicadores de cambio |
|
| Análisis a nivel de zona/ubicación, ordenable | -- |
| Desglose del rendimiento a nivel creativo | -- |
Parámetros opcionales comunes: date_from, date_to (YYYY-MM-DD, por defecto los últimos 7 días), campaign_id, group_by (date/campaign/zone/country/creative/device_type/browser/os)
Optimización
Herramienta | Descripción | Parámetros requeridos |
| Encuentra zonas que gastan dinero sin convertir (candidatas a lista negra) |
|
| Encuentra las zonas con mejor rendimiento (candidatas a lista blanca) |
|
| Encuentra campañas listas para escalar (alto ROI + volumen) | -- |
| Encuentra y añade zonas malas a la lista negra en un solo paso (prueba por defecto) |
|
Segmentación
Herramienta | Descripción | Parámetros requeridos |
| Añade zonas a la lista blanca de una campaña |
|
| Añade zonas a la lista negra de una campaña |
|
Cuenta
Herramienta | Descripción | Parámetros requeridos |
| Comprueba el saldo actual de la cuenta | -- |
| Lista todos los países disponibles para segmentación | -- |
| Lista los formatos de anuncios disponibles (push, onclick, etc.) | -- |
Stack tecnológico
Componente | Tecnología |
Entorno de ejecución | Python 3.10+ |
Protocolo | |
Cliente HTTP | |
Validación | Pydantic v2 |
API | |
Sistema de construcción | |
Transporte | stdio (transporte MCP estándar) |
Inicio rápido
Requisitos previos
Cuenta de PropellerAds con acceso a la API
Requisito mínimo: $1,000 de gasto total o depósito
Obtén tu token de API: https://ssp.propellerads.com/#/app/profile
Python 3.10+
Claude Desktop o Claude Code (o cualquier cliente compatible con MCP)
Instalación
Opción 1: Instalar desde PyPI (Recomendado)
pip install propellerads-mcpOpción 2: Instalar desde el código fuente
git clone https://github.com/JanNafta/propellerads-mcp.git
cd propellerads-mcp
pip install -e .Configura tu token de API
Crea un archivo .env en la raíz del proyecto o exporta la variable de entorno:
export PROPELLERADS_API_TOKEN="your_api_token_here"Ejemplos de uso
Gestión de campañas
"Show me all my active campaigns sorted by ROI"
"Create a push campaign for gaming offers in Brazil with $100 daily budget"
"Pause all campaigns with negative ROI in the last 7 days"
"Clone my best performing campaign to Mexico, Colombia, and Peru"Análisis de rendimiento
"What's my campaign performance for the last week?"
"Compare this week's performance vs last week"
"Show me the top 10 zones by conversions for campaign 12345"
"Which creatives have CTR below 0.5%?"Flujos de trabajo de optimización
"Find all zones spending over $50 without conversions and blacklist them"
"Show me campaigns ready for scaling -- ROI above 50% with at least 10 conversions"
"Find top performing zones for my dating campaigns and add them to a whitelist"Rutina de optimización diaria
1. "Show me yesterday's performance for all campaigns"
2. "Find and blacklist underperforming zones across all campaigns"
3. "Which campaigns are ready for scaling?"
4. "Increase budget by 50% for profitable campaigns"Configuración de MCP
Claude Desktop
Añade al archivo de configuración de Claude Desktop:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"propellerads": {
"command": "python",
"args": ["-m", "propellerads_mcp"],
"env": {
"PROPELLERADS_API_TOKEN": "your_api_token_here"
}
}
}
}Reinicia Claude Desktop después de guardar la configuración.
Claude Code
Añade el servidor MCP a Claude Code usando la CLI:
claude mcp add propellerads -- python -m propellerads_mcpAsegúrate de que PROPELLERADS_API_TOKEN esté configurado en tu entorno de shell antes de iniciar Claude Code.
Otros clientes MCP
Este servidor utiliza transporte stdio, el método de comunicación estándar de MCP. Cualquier cliente compatible con MCP puede conectarse iniciando el proceso:
python -m propellerads_mcpEl servidor lee PROPELLERADS_API_TOKEN del entorno. Pásalo a través de la configuración env de tu cliente MCP o configúralo en tu shell.
Estructura del proyecto
propellerads-mcp/
├── src/
│ └── propellerads_mcp/
│ ├── __init__.py # Package init, version, exports
│ ├── __main__.py # Module entry point (python -m)
│ ├── client.py # PropellerAds API client (httpx-based)
│ └── server.py # MCP server, tool definitions & handlers
├── .env.example # Environment variable template
├── .gitignore
├── LICENSE # MIT License
├── pyproject.toml # Build config, dependencies, metadata
└── README.mdSeguridad y permisos
Aspecto | Detalles |
Autenticación | Token Bearer a través de variable de entorno (nunca codificado) |
Operaciones de lectura | Ejecutadas sin confirmación adicional |
Operaciones de escritura | Requieren intención explícita del usuario (crear, actualizar, iniciar, detener, lista negra) |
Lista negra automática | Por defecto |
Limitación de tasa | Respeta los límites de tasa de la API de PropellerAds |
Sin almacenamiento de datos | El servidor no tiene estado; no se almacenan datos localmente |
Contribución
¡Las contribuciones son bienvenidas! Así es como puedes ayudar:
Haz un fork del repositorio
Crea una rama de características (
git checkout -b feature/my-feature)Confirma tus cambios (
git commit -m "Add my feature")Envía a tu rama (
git push origin feature/my-feature)Abre una Pull Request
Para errores y solicitudes de funciones, por favor abre un issue.
Autor
Jan Naftanaila -- Comprador de medios y especialista en automatización de IA
Construyendo herramientas que cierran la brecha entre la IA y la publicidad programática. Enfocado en hacer que la tecnología publicitaria sea accesible, automatizada e inteligente.
Licencia
Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.
PropellerAds MCP -- Código abierto. Creado para la comunidad de publicidad programática.
Available Tools
21 toolsadd_to_blacklistC
Add zones to campaign blacklist.
Inputs: campaign_id (required), zone_ids (required).
add_to_whitelistC
Add zones to campaign whitelist.
Inputs: campaign_id (required), zone_ids (required).
auto_blacklist_zonesC
Automatically find and blacklist underperforming zones for a campaign.
Inputs: campaign_id (required), min_spend, max_conversions, date_from, +2 more.
clone_campaignC
Create a copy of an existing campaign.
Inputs: campaign_id (required), new_name.
compare_periodsC
Compare performance between two time periods.
Inputs: period1_from (required), period1_to (required), period2_from (required), period2_to (required), +1 more.
create_campaignC
Create a new advertising campaign with specified settings.
Inputs: name (required), ad_format (required), countries (required), daily_budget (required), +4 more.
find_scaling_opportunitiesC
Find campaigns ready for scaling based on ROI and conversion volume.
Inputs: min_roi, min_conversions, date_from, date_to.
find_top_zonesC
Find best performing zones. Useful for whitelist candidates.
Inputs: campaign_id (required), min_conversions, min_roi, limit, +2 more.
find_underperforming_zonesB
Find zones that are spending money but not converting. Useful for blacklist candidates.
Inputs: campaign_id (required), min_spend, max_conversions, date_from, +1 more.
get_ad_formatsB
Get list of available ad formats.
Inputs: no named parameters.
get_available_countriesB
Get list of available countries for targeting.
Inputs: no named parameters.
get_balanceB
Get current account balance.
Inputs: no named parameters.
get_campaign_detailsB
Get complete details for a specific campaign including targeting, creatives, and settings.
Inputs: campaign_id (required).
get_campaign_performanceC
Get performance summary for a specific campaign with calculated metrics and insights.
Inputs: campaign_id (required), date_from, date_to.
get_creative_performanceC
Get performance statistics for creatives.
Inputs: campaign_id, date_from, date_to.
get_performance_reportC
Get detailed performance statistics with metrics like impressions, clicks, conversions, spend, CTR, CVR, CPC, CPA, and ROI.
Inputs: date_from, date_to, group_by, campaign_id.
get_zone_performanceB
Get performance statistics grouped by zone/placement. Useful for whitelist/blacklist optimization.
Inputs: campaign_id, date_from, date_to, limit, +1 more.
list_campaignsB
List all campaigns with optional filters. Returns campaign ID, name, status, ad format, and basic metrics.
Inputs: status, ad_format, name.
start_campaignsC
Activate/start one or more campaigns.
Inputs: campaign_ids (required).
stop_campaignsC
Pause/stop one or more campaigns.
Inputs: campaign_ids (required).
update_campaignC
Update campaign settings like budget, bid, targeting, or status.
Inputs: campaign_id (required), name, daily_budget, total_budget, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Most tools have distinct purposes with clear boundaries, such as campaign management (create, clone, update, start, stop), performance analysis (get_campaign_performance, get_performance_report), and zone optimization (find_top_zones, find_underperforming_zones). However, some overlap exists between get_campaign_performance and get_performance_report, which could cause confusion about which to use for campaign-specific metrics.
Tool names follow a highly consistent verb_noun pattern throughout, such as create_campaign, list_campaigns, get_balance, and find_top_zones. All tools use snake_case without deviation, making them predictable and easy to parse for agents.
With 21 tools, the count is slightly high but reasonable for the comprehensive advertising campaign management domain. It covers campaign lifecycle, performance reporting, and optimization tasks, though it borders on being heavy compared to typical well-scoped servers (3-15 tools).
The toolset provides complete coverage for the advertising campaign domain, including CRUD operations (create, list, get, update, clone), lifecycle management (start, stop), performance analysis (various get and compare tools), and optimization features (blacklist/whitelist, scaling, zone analysis). No obvious gaps are present, enabling agents to handle end-to-end workflows.
Related MCP Connectors
Build, edit and sync Google, Microsoft, Reddit and Meta ad campaigns from your assistant.
Manage and optimize your ads on Meta, Google, TikTok, X, ChatGPT Ads, Reddit and LinkedIn from chat.
Manage Google, Meta, TikTok, Microsoft, Pinterest, Amazon, LinkedIn & Reddit ads from your AI
Run Google Ads and Meta Ads from ChatGPT or Claude: audit wasted spend, create and manage campaigns.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to manage TikTok advertising campaigns through the TikTok Ads API. Supports campaign creation, performance analytics, audience management, creative operations, and custom reporting through natural language interactions.54MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Google Ad Manager campaigns, line items, creatives, and advertisers through natural language, automating ad operations that normally require countless clicks through the UI.3567 PyPI20MIT
- FlicenseNot gradedqualityDmaintenanceEnables comprehensive management of Google Ads campaigns through natural language, including campaign creation, ad group management, keyword operations, Performance Max campaigns, conversion tracking, and performance insights with support for multiple accounts.3-

AdButler MCP Serverofficial
AlicenseCqualityCmaintenanceEnables managing your entire AdButler advertising account from any AI assistant, exposing over 600 tools covering the full AdButler v2 API for display ads, video, targeting, reporting, programmatic, and more, plus pre-built workflow prompts.100150 npm1MIT