POPJAM Logo
Uzak MCP sunucusu · Akış destekli HTTP

POPJAM MCP Sunucusu:
bir Pazarlama Motoru
AI Ajanınız İçin

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ş 20 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.

Yirmi Özenle Seçilmiş Araç, API Aynası 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 & active lab & 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.

  • get_active_lab

    Read the lab session you're currently working in (your selected lab).

  • set_active_lab

    Select a lab session as your active workspace; subsequent generate tools use it by default.

  • copilot

    Talk to POPJAM's in-product agent in your active lab. It knows the lab's brand, ads, and results, keeps durable conversation memory shared with the web app, narrates its work as live progress, and can trigger any generation as a background task.

Media generation

Synchronous, runs in your active lab, streams progress, persists the result. Spends credits.

  • save_ad_concept

    Persist an ad concept (from generate_ad_concepts) as a Content row in your active lab so you can generate its media.

  • generate_image

    Generate an image ad creative for a saved Content row (imgen agent, gemini-pro). Streams progress; writes media_url back to the row.

  • generate_video

    Generate a video ad creative for a saved Content row (videogen agent, omni-flash). Streams progress; writes media_url back to the row.

  • generate_animation

    Generate an animation ad creative for a saved Content row (animategen agent, remotion). Streams progress; writes media_url back to the row.

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

Kapsamlı bir kampanya 10–15 dakika sürer. Ağır işlemler bir görev tanıtıcısı döndürdüğü için, yavaş çalışan hiçbir şey istek sırasında yürütülmez; ajanınız da her seferinde aynı üç çağrılık akışı izler.

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 20 curated tools: quick drafting (research, audiences, ad concepts), the full campaign funnel as a background run, task tracking, media generation (image, video, animation) with live progress, 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 campaign work never 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.

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.