POPJAM MCP Server:
a Marketing Engine
for Your AI Agent
Med en enda URL får Claude, Cursor, ChatGPT eller valfri MCP-klient tillgång till POPJAM:s kampanjmotor: varumärkesanalys, målgruppsupptäckt, annonsmaterial och personasimulering som 14 kurerade verktyg som din agent anropar direkt.
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.
Vad är POPJAM MCP-server?
Model Context Protocol är den öppna standard som låter AI-copiloter anropa externa verktyg. POPJAM:s MCP-server gör hela vår marknadsföringsmotor tillgänglig via den standarden: din agent kan analysera en marknad, definiera målgrupper, ta fram annonskoncept, lansera hela kampanjflödet och läsa simulerade reaktioner från personas, allt i samma konversation där du gör allt annat.
Allt hamnar i din POPJAM-arbetsyta. En kampanj som din agent startar via MCP dyker upp som en labbsession i webbappen (samma varumärke, samma målgrupper, samma annonsmaterial, samma resultat), så att ditt team kan fortsätta i webbläsaren exakt där agenten slutade.
Fjorton kurerade verktyg, inte en spegling av API:t
Särskilt byggd för LLM:er: ett litet antal fristående operationer med tydliga gränssnitt, eftersom noggrant utvalda verktyg fungerar bättre än dussintals automatiskt konverterade endpoints.
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.
Arbete som tar flera minuter blockerar aldrig en interaktion
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.
Anslut på mindre än en minut
Klistra in en URL, logga in med ditt POPJAM-konto i webbläsaren, klart.
Claude Code
Ett kommando i terminalen, sedan visas OAuth-inloggningen i webbläsaren första gången du använder den.
claude mcp add --transport http popjam https://api.popjam.io/mcp
Claude Desktop & claude.ai
Inställningar → Connectors → Lägg till anpassad connector och klistra sedan in serverns URL.
https://api.popjam.io/mcp
Cursor, VS Code och andra
Lägg till URL:en som en fjärransluten MCP-server i klientens MCP-inställningar och autentisera.
https://api.popjam.io/mcp
Samma arbetsyta, samma kredit, ytterligare en väg in
MCP-servern är inte en separat produkt: det är ytterligare en väg in i din POPJAM-organisation. Labb som din agent skapar visas i webbappen för hela teamet; copilot-verktyget delar sitt konversationsminne med chatten i produkten; kredit kommer från samma saldo, och uppskattningen returneras i samma ögonblick som en körning startar. Registrera dig en gång, så arbetar alla gränssnitt, webbläsare, agent eller båda, med samma kampanjer.
Vanliga frågor
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.
Fortsätt utforska
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.