POPJAM MCP Server:
a Marketing Engine
for Your AI Agent
Una sola URL les da a Claude, Cursor, ChatGPT o cualquier cliente MCP acceso al motor de campañas de POPJAM: investigación de marca, descubrimiento de audiencias, creatividades publicitarias y simulación de personas, todo ello a través de 14 herramientas seleccionadas que tu agente invoca directamente.
https://api.popjam.io/mcp
you "Make ads for acme-coffee.com and tell me which audience wins."
→ start_campaign(website_url="https://acme-coffee.com")
task 7f3a scheduled · lab created · ~40 credits estimated
→ wait_for_task("7f3a")
RUNNING · brand & catalog resolved: Acme Coffee, 12 products
RUNNING · 2 audiences defined · 20 personas simulated
RUNNING · 4 image creatives generated · reactions simulated
COMPLETED in 6m 12s
→ get_campaign_results(lab_session_id)
top insight: "Morning Ritual" × Busy Professionals, engagement 82/100
agent Busy Professionals respond best (82/100). The ritual angle beat the discount angle in every panel. I'd scale that one.
¿Qué es el servidor MCP de POPJAM?
Model Context Protocol es el estándar abierto que permite a los copilotos de AI usar herramientas externas. El servidor MCP de POPJAM pone todo nuestro motor de marketing bajo ese estándar: tu agente puede investigar un mercado, definir audiencias, redactar conceptos de anuncios, lanzar todo el embudo de campaña y leer reacciones simuladas de personas, todo desde la misma conversación en la que haces todo lo demás.
Todo llega a tu espacio de trabajo de POPJAM. Una campaña que tu agente inicia a través de MCP aparece como una sesión de Lab en la aplicación web (misma marca, mismas audiencias, mismas creatividades, mismos resultados), para que tu equipo pueda retomar en el navegador exactamente donde lo dejó tu agente.
Catorce herramientas seleccionadas, no un reflejo de la API
Diseñado específicamente para LLM: un pequeño conjunto de operaciones autocontenidas con contratos claros, porque las herramientas seleccionadas rinden mejor que decenas de endpoints convertidos automáticamente.
Drafting
Stateless, return in seconds
research_topicQuick web research with live sources.
fetch_websiteScrape a landing page or competitor URL to clean text.
define_audiencesTurn a campaign brief into structured target audiences.
generate_ad_conceptsDraft on-platform ad creatives (headline, body, CTA) from a brief.
Background work
Return a task handle immediately, run for minutes
start_campaignThe flagship: from one URL, run the entire funnel (brand & catalog, market research, audiences, persona panels, image creatives, simulated reactions, improved variants), persisted to a lab in your workspace.
start_deep_researchSlow, multi-source deep research as a background task.
Task tracking
Follow background work without blocking a turn
wait_for_taskLong-poll a task for up to 50 seconds and get its progress log.
get_taskSnapshot one task: status, progress narrative, result.
list_tasksSee what's running now or what finished while you were away.
cancel_taskStop a running task; persisted work stays in place.
Workspace & copilot
Read results, resume labs, converse with memory
get_campaign_resultsAudiences, ads, and insights from a lab; works mid-run with partial results.
list_labsYour lab sessions (campaign workspaces), newest first.
get_labOne lab's working state, audiences, and recent tasks.
copilotTalk to POPJAM's in-product agent inside a lab. It knows the lab's brand, ads, and results, keeps durable conversation memory shared with the web app, and can trigger any generation as a background task.
El trabajo de varios minutos nunca bloquea un turno
A full campaign takes 10–15 minutes. Nothing slow runs in-request, because heavy work returns a task handle, and your agent follows the same three-call pattern every time.
start_campaign(website_url)Launch and get a handle
Returns in seconds with a task_id, the lab it will write to, and the credit estimate. The funnel (brand research, audiences, persona panels, creatives, simulations, variants) runs in the background on our infrastructure.
wait_for_task(task_id)Follow the progress log
Long-polls up to 50 seconds per call and returns a human-readable narrative of what the run is doing. A campaign typically takes 10–15 minutes, so your agent checks in a few times, and it can keep doing other work in between.
get_campaign_results(lab_session_id)Read results, even mid-run
Audiences, ads, and simulation insights, readable at any time. While the campaign is still running you get whatever exists so far; when it finishes, you get the full picture: the same data your team sees in the web app.
Conéctate en menos de un minuto
Pega una URL, inicia sesión con tu cuenta de POPJAM en el navegador y listo.
Claude Code
Un comando en tu terminal y, en el primer uso, el inicio de sesión con OAuth se abre en tu navegador.
claude mcp add --transport http popjam https://api.popjam.io/mcp
Claude Desktop y claude.ai
Configuración → Conectores → Añadir conector personalizado; luego pega la URL del servidor.
https://api.popjam.io/mcp
Cursor, VS Code y otros
Añade la URL como servidor MCP remoto en la configuración MCP de tu cliente y autentícate.
https://api.popjam.io/mcp
El mismo espacio de trabajo, los mismos créditos, una puerta más
El servidor MCP no es un producto aparte: es otra puerta de entrada a tu organización de POPJAM. Los labs que crea tu agente aparecen en la aplicación web para todo tu equipo; la herramienta de copiloto comparte su memoria de conversación con el chat del producto; los créditos salen del mismo saldo, y la estimación se devuelve en el mismo momento en que se inicia una ejecución. Regístrate una sola vez y cada interfaz, navegador, agente, o ambos, trabajará sobre las mismas campañas.
Preguntas frecuentes
What is the POPJAM MCP server?
A remote Model Context Protocol server at https://api.popjam.io/mcp that exposes POPJAM's marketing engine to AI copilots. Instead of mirroring our REST API, it offers 14 curated tools: quick drafting (research, audiences, ad concepts), the full campaign funnel as a background run, task tracking, and a copilot with durable per-lab memory. Your agent calls them like any other tool.
Which AI clients can connect?
Any MCP client that supports remote servers over Streamable HTTP: Claude Code, Claude Desktop and claude.ai (as a custom connector), ChatGPT, Cursor, VS Code, Windsurf, Cline, Goose, and others. You paste one URL, authenticate in the browser, and the tools appear.
Do I need a POPJAM account?
Yes. The server operates on your organization's workspace: labs, audiences, ads, and simulation results are persisted there and shared with the web app. Connecting signs you in with your POPJAM account; the free tier includes 500 credits with no credit card.
Does using the MCP server cost anything?
The server itself is free. Campaign runs spend POPJAM credits exactly like the web app. start_campaign returns the credit estimate in its immediate response, and a run can be stopped at any point with cancel_task (work already persisted stays in place). Quick drafting tools like research_topic and define_audiences are free to call.
Won't a 15-minute campaign time out my agent?
No, because nothing slow runs inside a request. start_campaign returns a task handle in seconds; your agent follows up with wait_for_task, which long-polls up to 50 seconds per call (safely under client tool timeouts) and returns a human-readable progress log. get_campaign_results works at any time, returning partial results while the run is still going.
How is this different from POPJAM's agent skills?
The agent skills (github.com/popjam-io/skills) are open-source instruction sets that run POPJAM-style pipelines locally inside your agent, writing to files. The MCP server runs POPJAM's hosted engine: real media generation, persisted lab sessions your team sees in the web app, credits, and a copilot that remembers every conversation. Skills are the run-it-yourself edition, while the MCP server is the product with a plug on it.
Sigue explorando
Agent skills for Claude Code
The run-it-locally edition: free, MIT-licensed skills that run POPJAM-style pipelines in your agent.
Free AI marketing tools
Persona generator, ad testing, and pitch deck roasting, all free in the browser with no signup.
Test an ad creative now
Upload one creative and see how AI buyer personas react: score plus reasoning, free.