POPJAM Logo
Uzak MCP sunucusu · Akış destekli HTTP

POPJAM MCP Server:
a Marketing Engine
for Your AI Agent

Tek bir URL, Claude, Cursor, ChatGPT veya herhangi bir MCP istemcisine POPJAM'ın kampanya motorunu sunar: marka araştırması, hedef kitle keşfi, reklam kreatifleri ve persona Simulation'ı; hepsi de ajanınızın doğrudan çağırdığı özenle seçilmiş 14 araç olarak.

https://api.popjam.io/mcp
bağlı · popjam · 14 araçÖrnek oturum

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.

POPJAM MCP sunucusu Nedir?

Model Context Protocol, AI yardımcılarının harici araçları çağırmasını sağlayan açık standarttır. POPJAM MCP sunucusu ise tüm pazarlama motorumuzu bu standardın arkasında sunar: ajanınız bir pazarı araştırabilir, hedef kitleleri tanımlayabilir, reklam konseptleri hazırlayabilir, kampanya hunisinin tamamını başlatabilir ve simüle edilmiş persona tepkilerini inceleyebilir; hem de tüm bunları, diğer her şeyi yürüttüğünüz aynı konuşma içinde yapabilir.

Her şey POPJAM çalışma alanınıza yansır. Ajanınızın MCP üzerinden başlattığı bir kampanya, web uygulamasında bir lab oturumu olarak görünür (aynı marka, aynı hedef kitleler, aynı kreatifler, aynı sonuçlar); böylece ekibiniz, ajanınızın bıraktığı yerden tarayıcıda aynen devam edebilir.

Özenle Seçilmiş 14 Araç, API'nin Birebir Yansıması Değil

LLM'ler için özel olarak tasarlandı: özenle seçilmiş araçlar, otomatik dönüştürülmüş onlarca uç noktadan daha iyi sonuç verdiği için, net tanımlara sahip küçük ve kendi içinde tamamlanmış bir işlem seti sunar.

Drafting

Stateless, return in seconds

  • research_topic

    Quick web research with live sources.

  • fetch_website

    Scrape a landing page or competitor URL to clean text.

  • define_audiences

    Turn a campaign brief into structured target audiences.

  • generate_ad_concepts

    Draft on-platform ad creatives (headline, body, CTA) from a brief.

Background work

Return a task handle immediately, run for minutes

  • start_campaign

    The 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_research

    Slow, multi-source deep research as a background task.

Task tracking

Follow background work without blocking a turn

  • wait_for_task

    Long-poll a task for up to 50 seconds and get its progress log.

  • get_task

    Snapshot one task: status, progress narrative, result.

  • list_tasks

    See what's running now or what finished while you were away.

  • cancel_task

    Stop a running task; persisted work stays in place.

Workspace & copilot

Read results, resume labs, converse with memory

  • get_campaign_results

    Audiences, ads, and insights from a lab; works mid-run with partial results.

  • list_labs

    Your lab sessions (campaign workspaces), newest first.

  • get_lab

    One lab's working state, audiences, and recent tasks.

  • copilot

    Talk 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.

Dakikalar Süren İşler Asla Bir Adımı Engellemez

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.

1
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.

2
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.

3
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.

Bir Dakikadan Kısa Sürede Bağlanın

Tek bir URL yapıştırın, tarayıcıda POPJAM hesabınızla oturum açın, işlem tamam.

Claude Code

Terminalinizde tek bir komut çalıştırın; ilk kullanımda OAuth oturum açma penceresi tarayıcınızda açılır.

claude mcp add --transport http popjam https://api.popjam.io/mcp

Claude Desktop & claude.ai

Ayarlar → Bağlayıcılar → Özel bağlayıcı ekleyin, ardından sunucu URL'sini yapıştırın.

https://api.popjam.io/mcp

Cursor, VS Code ve diğerleri

URL'yi istemcinizin MCP ayarlarına uzak MCP sunucusu olarak ekleyin ve kimlik doğrulamasını tamamlayın.

https://api.popjam.io/mcp

Aynı Çalışma Alanı, Aynı Krediler, Bir Kapı Daha

MCP sunucusu ayrı bir ürün değil; POPJAM organizasyonunuza açılan başka bir kapı. Ajanınızın oluşturduğu lab'ler web uygulamasında tüm ekibiniz tarafından görülebilir; copilot aracı, ürün içi chat ile aynı konuşma hafızasını paylaşır; krediler aynı bakiyeden düşer ve bir çalıştırma başlatılır başlatılmaz maliyet tahmini gösterilir. Bir kez kaydolun, sonra ister tarayıcıdan ister ajandan ister her ikisinden, her yüzeyde aynı kampanyalar üzerinde çalışın.

Sıkça Sorulan Sorular

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.

Keşfetmeye devam edin

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.

Harcama yapmadan önce Ads'inizi test etmeye hazır mısınız?

Reklam kreatiflerini tek bir iş akışında oluşturun, doğrulayın ve yayına alın. 500 Krediler ile ücretsiz başlayın.