popcraft-mcp

https://popcraft.ai/api/mcp

---

Quick start

Every client connects the same endpoint; only the "add server" step differs. The first tool call opens the Popcraft sign-in in your browser — press Allow once and the connection stays live with automatic token refresh. New accounts get 100 free credits.

Client	Setup	Guide
Claude (web / desktop)	Settings → Connectors → Add custom connector → name Popcraft → paste the URL → Connect → Allow	clients/claude.md
Claude Code	claude mcp add --transport http popcraft https://popcraft.ai/api/mcp then /mcp → popcraft → Authenticate	clients/claude-code.md
Cursor	Add to ~/.cursor/mcp.json (below), enable popcraft in MCP settings, sign in on first use	clients/cursor.md
ChatGPT	Settings → Apps & Connectors → Advanced → Developer mode on → Create → name Popcraft → paste the URL	clients/chatgpt.md
Codex	Paste: "Help me connect the Popcraft MCP at https://popcraft.ai/api/mcp — add it as a streamable HTTP server named popcraft, then walk me through the sign-in."	clients/codex.md
Anything else (OpenClaw, Hermes, your own agent)	Streamable HTTP + OAuth 2.1 with discovery metadata and dynamic client registration — the URL alone is enough	clients/other.md

{
  "mcpServers": {
    "popcraft": {
      "url": "https://popcraft.ai/api/mcp"
    }
  }
}

Try it

Paste any of these into a fresh chat once the connector is on:

Use the Popcraft MCP to make a 10-second cinematic product teaser — preview the credit cost first.

Make me a 15-second vertical UGC ad for my product on Popcraft — hook people in the first second. (loads the ugc-ad skill)

I need a YouTube thumbnail for my video about why cheap mechanical keyboards beat expensive ones — make it pop, using Popcraft. (loads the thumbnail-pro skill)

Shoot a brand image set for the citrus soda — hero can, lifestyle scene, pattern tile — then voice a 15-second tagline.

---

What your agent gets

Group	Tools	What they do
Create	popcraft_generate_videopopcraft_generate_imagepopcraft_generate_audiopopcraft_generate_3dpopcraft_effects_showpopcraft_list_voices	Text-to-video, image-to-video, first/last frame, reference- and audio-driven videoEvery frontier image model, edits with referencesTTS, sound effects, music3D generationCurated video effectsPlayable voice samples
Enhance	popcraft_upscale_imagepopcraft_upscale_videopopcraft_upgrade_videopopcraft_postprocess_3d	Topaz 2×/4×, nine modes2×/4× with fps controlRe-render a Seedance 2.5 draft at 1080p3D post-processing
Media & references	popcraft_media_uploadpopcraft_media_import_urlpopcraft_media_upload_widgetpopcraft_media_upload_inlinepopcraft_media_confirmpopcraft_show_mediaspopcraft_show_elements	Signed direct upload — shell recipes, so a 200 MB reference streams from disk, not through the context windowAny public URL → referenceInteractive file pickerSmall files without a shellVerify an upload landedYour media libraryReusable characters and styles
Jobs & catalog	popcraft_models_explorepopcraft_job_displaypopcraft_show_generationspopcraft_projects	Capabilities, reference limits, aspect ratios, durations and credit costs per modelResult cards that refresh themselves — no polling loopsRevisit and chain past resultsFile results into projects
Skills	popcraft_get_workflow_instructionspopcraft_get_workflow_bundle_file	Production playbooks served live from the server — see belowPer-step reference modules
Account	popcraft_balancepopcraft_show_plans_and_creditspopcraft_transactions	Credits and plan before spendingPlans and one-click top-upEvery charge and refund

Skills, served live

Ask for a deliverable rather than an asset and the agent loads the matching production recipe before it generates anything. Nothing to install, nothing to paste.

• ugc-ad — one vertical 9:16 creator-style ad, up to 15 s, with speech and sound rendered natively in the clip.intake → creator identity → script → storyboard → realism pass → cost preview → one Seedance 2.0 clip → QA
• thumbnail-pro — click-optimised YouTube / Instagram thumbnails with an identity lock for your own face.16 concept frameworks → one intake question → 11-block prompt → parallel variants → micro-edits → 4K upscale
• h3-product-ad — minimalist, typography-led product ad on Hailuo 3, 5–15 s, with a native score.intake → copy → three anchor photos → storyboard → cost preview → one generation → QA
• voiceover — narration that does not sound like TTS: voice lock, words-per-second budget, per-line direction.script rewrite → voice pick → line-by-line delivery tags
• sd25-prompting / sd25-prompting-zh — ByteDance's official Seedance 2.5 prompt optimizer, served verbatim (English and Chinese editions); compiles your brief and references into one submission-ready prompt.
• gpt-image-25-prompting / h3-prompting — model-specific prompt formats for GPT Image 2.5 (change-vs-preserve structure) and Hailuo 3 (structured format with sound and speech fields).

---

Cost preview on every spend

Every generate tool accepts get_cost: true and returns the exact credit price without submitting anything. Rates come from popcraft_models_explore; the numbers below are as of 2026-09-25 and apply before plan discounts.

Video model	Credits / second (720p)	Image model	Credits / image
Seedance 2.0 Mini	14	Seedream 4.0	5
Seedance 2.0 Fast	20	GPT Image 2.5 Fast	10
Seedance 2.0	26	GPT Image 2.5	11
Seedance 2.5 · 480p draft	42 · 24	Nano Banana 2	15
Veo 3.1 Fast · Veo 3.1	15 · 58	Nano Banana Pro · 4K	20 · 35
Kling 3.0 Omni	16
Wan 3.0 · Hailuo 3	20

Pro and Max include a daily Seedance 2.0 Fast & Mini allowance at no credit cost, and Nano Banana / Seedream images are unlimited from Plus upward — see unlimited-ai-video and pricing.

---

How a good agent run looks

1. Pick the model — popcraft_models_explore: read its reference_limits, the video_input / image_input / audio_input envelope, durations and aspect ratios.
2. Get references in — popcraft_media_import_url for anything with a public URL; otherwise popcraft_media_upload and run the returned shell recipe (curl -T file "<proxy_upload_url>"). Pre-check each file against the envelope — an out-of-envelope reference is rejected, or worse, wastes credits.
3. Bind references in the prompt with the model's tokens — Image 1, Video 1, Audio 1 for the Seedance family; <Picture 1> for Hailuo 3.
4. Preview, then spend — get_cost: true, show the number, then generate. The result card refreshes itself; do not poll in a loop.
5. Chain — any result URL is a valid medias[].value for the next call: upscale it, animate it, edit it.

---

Recipes

Each recipe is a complete run — the tool calls, the prompts and the outputs, shown inline.

#	Recipe	What you get
01	UGC ad from one product photo	The ugc-ad skill end to end, one real run: locked creator → script → storyboard → first frame → a 15 s Seedance 2.0 clip with native speech
02	Thumbnail with identity lock	thumbnail-pro with your own face held constant across variants
03	Seedance 2.5 single take	Timestamped shot list, 480p draft, then popcraft_upgrade_video to 1080p
04	Product image set with an exact wordmark	Packshot → lifestyle → background swap → poster → product loop, with the brand's exact wordmark
05	Batch product images	N products × K scenes in one loop, with consistency rules and cost math

---

FAQ

---