AdRecast MCP server

AdRecast MCP Server

AdRecast remakes proven e-commerce video ads for your product: it maps a reference ad's shots, pacing and hook, writes a script you confirm, and generates a full multi-scene ad with your product and cast, checked for product accuracy in every frame.

Endpoint

• URL: https://adrecast.com/api/mcp
• Transport: Streamable HTTP.
• Authentication: API key only. Send it as a Bearer token: Authorization: Bearer rklive...
• Create a key in Settings → API keys. Choose scopes from read, write and spend.
• Keys are shown once. Store the key somewhere safe when you create it.
• OAuth is not supported.

What it does

The MCP server runs the same remake flow as the web app: find a template → upload product images → review the script → estimate → generate → poll → export.

Tools (46 in total), grouped by area. The grouping is this README's own; the docs list the tools by endpoint.

• Templates & uploads: searchtemplates, createupload_url
• Projects: createproject, listprojects, getproject, getscript, updatescript, rewritescript, getrewrite, addline, deleteline, reorderlines, confirm_script
• Generation & export: estimatecost, generatevideo, listjobs, listclips, getjob, exportvideo, get_export
• Characters & voices: createcharacter, listcharacters, deletecharacter, updatecharacter, clonecharactervoice, keepcharactervoice, listvoices, setproject_character
• Variants: listhookformulas, listvariantstyles, createhookvariant, estimatevariants, createvariants, listvariants, getvariantmanifest, addvariantproduct, cancelvariant_batch
• Studio: studioquote, createstudiogeneration, liststudiogenerations, liststudioassets, getstudiogeneration, confirmstudiovideo, discardstudiovideo, savestudio_output
• Account: get_balance

Video is generated per scene, with the same actor, product and voice across shots. Captions, voice-over or a song, and music are included. You can fix one shot without redoing the whole video.

Spending safety

• Pricing is in credits. 100 credits = $1. Analysis, script, storyboard stills and pre-video script edits are free.
• Video is billed per generated second. 720p is 40 credits/s, 1080p is 50 and 2K is 60. The resolution is fixed when the project is created.
• generatevideo and exportvideo only spend with confirm: true. Without it, they return the estimate (402 confirmationrequired). Call estimatecost and show the estimate to the user before you set confirm: true.
• export_video with a 1:1 or 16:9 re-frame costs 20 credits/s. A 9:16 export is free.
• Revising a shot after its video exists costs 80% of the video price per redone second.
• clonecharactervoice spends a fixed 1000 credits. It also needs confirm: true.
• Creating a project requires the $1 trial or a top-up first (402 payment_required otherwise).
• Auto generation (autogenerate=true on createproject) needs the spend scope.
• Studio prices are 0.8× the matching remake price.
• Failed jobs release their frozen credits.
• For REST calls, send an Idempotency-Key on every POST that creates or spends, so retries never double-charge.

Quick start

Create an API key in Settings → API keys, then export it in the shell where your client runs:

export ADRECAST_API_KEY=rk_live_...

Generic MCP client

Use this JSON for any client that accepts url and headers:

{
  "mcpServers": {
    "adrecast": {
      "url": "https://adrecast.com/api/mcp",
      "headers": { "Authorization": "Bearer ${ADRECAST_API_KEY}" }
    }
  }
}

Claude Code

claude mcp add --transport http adrecast https://adrecast.com/api/mcp --header "Authorization: Bearer $ADRECAST_API_KEY"

Cursor

Add this to .cursor/mcp.json:

Shortened. The full README is on GitHub.