Skip to content

MCP server · CLI · Claude & ChatGPT connector

Wandura MCP Server & CLI

Wandura MCP connects Claude, ChatGPT, Cursor and other AI agents to Wandura, so they can find ad templates and create video, images and audio for you. Every job that spends credits gets a free price check first, at 1 credit = $0.01 like the website.

https://www.wandura.ai/api/mcp

Connector URL for Claude and ChatGPT. Using Claude Code, Cursor or a terminal? See setup

  • Claude · ChatGPTand any MCP client
  • No API keyBrowser sign-in
  • FreePrice check before spending
  • Same creditsAs the website

Connect Wandura to your AI

Pick the app you use. One click, then sign in.

ClaudeWeb and desktop appConnectChatGPTWeb and desktop appConnectCursor or VS CodeOne-click installInstallChrome extensionRemake ads from any pageAdd to Chrome

Pick your app above. We do the first step for you and show what is left right here.

Or set it up by hand

For claude.ai and Claude Desktop

  1. 1

    Copy the Wandura Connector URL

    You will paste this URL into Claude in the next step.

    https://www.wandura.ai/api/mcp
  2. 2

    Open Connector Settings

    In Claude, open Customize, then Connectors.

    CustomizeConnectorsAdd custom connector
  3. 3

    Add Wandura and Sign In

    Add a custom connector named Wandura, paste the URL and sign in. Jobs are billed to your Wandura credits.

    Name: WanduraURL: …/api/mcp

No API key needed for Claude or the CLI. Running in CI or on a machine without a browser? Manage API keys

Overview

What Is Wandura MCP?

Wandura MCP is a Model Context Protocol server that lets your AI agent use Wandura directly. From Claude, ChatGPT, Claude Code, Cursor, Windsurf or another MCP client, the agent can search ad templates, run a free price check, clone a template with your product or render video, images and audio, then return the result.

The Wandura CLI offers the same workflow in a terminal and prints the price before every submit. Both use your Wandura account, so jobs draw from your existing credits.

Connector URL
https://www.wandura.ai/api/mcp
MCP package
@wandura/mcp
CLI package
@wandura/cli · Node 20+
Clients
Claude, ChatGPT, Claude Code, Cursor, Windsurf, any MCP client
Tools
Current list sent by the server to your agent
Sign-in
Browser sign-in · scopes openid, email, offline_access
Billing
Same credits and prices as the website

What Wandura MCP Brings to Your AI Agent

One connection to search ad templates, price a job and create video, images and audio, without leaving your agent.

Clone a Proven Ad with Your Product

Ask for a template, check the price, then swap in your product. A clone keeps the template’s aspect ratio, length and format, and the server writes the prompt for you.

Connect Wandura
Claude Code
You

Find a cold brew ad template and tell me what it costs

Agent

search_templatesMatching templates, 9:16, 10 s

Agent

preview_generationPrice shown, 0 credits spent

You

Make it with my can

Agent

clone_templateJob queued

Result

Your 9:16 ad is ready to download

Just Ask. Here’s What Your Agent Can Do Through Chat

Example requests and the Wandura tools an agent uses to answer them. Copy a prompt and try it after you connect.

  1. Find a skincare ad template in 9:16 and tell me what it costs.

    Your agent searches the catalog, reads the template’s format and runs a free price check before anything is created.

Tools your agent calls
You

Find a skincare ad template in 9:16 and tell me what it costs.

  1. search_templates
  2. get_template
  3. preview_generation

Build with Wandura

Prompts to paste into your coding agent, one for each kind of app people build on Wandura. Sign in once with wandura auth login, then add the server.

Claude Code

claude mcp add wandura -- npx -y @wandura/mcp

Cursor .cursor/mcp.json

{
  "mcpServers": {
    "wandura": { "command": "npx", "args": ["-y", "@wandura/mcp"] }
  }
}

  1. Ad variants for every product

    Price a template for each product in a list before anything is made.

    For each product in products.json, find a 9:16 ad template that fits it and price a clone. Show me a table of templates and costs, and create nothing until I approve.
    1. search_templates
    2. get_template
    3. preview_generation
    4. clone_templateSpends credits

  2. Three opening hooks to test

    Render the same product with different openings and compare them.

    Write three different opening lines for my app ad, price a short 9:16 video for each, then render only the ones I pick.
    1. list_models
    2. preview_render
    3. render_videoSpends credits
    4. get_generation

  3. A short film from a script

    Turn a screenplay into a project with characters, places and scenes.

    Create a Story mode project from script.md, wait for the breakdown, then price the storyboards and send me the approve link.
    1. story_create_project
    2. story_get_project
    3. story_quote
    4. story_get_quote
    5. story_runSpends credits

  4. Assemble the finished episode

    Pick a take for every scene and get one video back.

    Check episode 1 of my Story mode project. Use the first finished take for any scene without one, then export the episode and send me the download link.
    1. story_get_episode
    2. story_choose_take
    3. story_export_episode
    4. story_get_export

  5. Game or website assets

    Make a background and a music bed for a title screen.

    Make a 16:9 forest background for my game title screen and a calm music bed to go with it. Price both first.
    1. list_models
    2. preview_render
    3. render_imageSpends credits
    4. render_audioSpends credits
    5. get_generation

  6. Photo to video effect

    Turn one photo into a short clip with a ready-made effect.

    List the photo effects, price a 5 second clip of photo.jpg with the one I choose, then render it.
    1. list_effects
    2. upload_asset
    3. render_effectSpends credits
    4. get_generation

Building an app that calls Wandura from your own server instead of from an agent? The image and video API runs ready-made styles with one HTTPS call, and a test key returns a sample result so you can build before you add money. Read the API docs · OpenAPI file

Make a Short Film from a Script

Story mode turns a screenplay into episodes, scene by scene. Your agent does the work, and you approve every price in Wandura.

  1. 1

    Create the project

    Your agent sends a screenplay or story text. Wandura breaks it into characters, places, props, episodes and scenes.

    1. story_create_project
    2. story_get_project
  2. 2

    Review the script and cast

    Read the episode outline, fix a line or edit how a character looks before any picture is drawn.

    1. story_get_script
    2. story_update_script
    3. story_list_assets
    4. story_update_asset
  3. 3

    Get a price

    For pictures, storyboards or scene videos, your agent asks for a quote. A quote costs nothing and runs nothing.

    1. story_quote
  4. 4

    Approve it in Wandura

    You open the approve link and accept the price in Wandura. Your agent cannot approve a paid step for you.

    1. story_get_quote
  5. 5

    Run and export

    Once approved, the agent runs the step, picks a take for each scene and exports the episode as one video.

    1. story_runSpends credits
    2. story_choose_take
    3. story_export_episode
    4. story_get_export

Nothing that costs credits runs until you press Approve in Wandura. If the price goes up after you approve, the step does not run.

Agent Tools: Find, Price, Create, Track

The server sends your agent the current tool list. Every tool that spends credits has a free price check first.

  1. Find

    6
    • search_templatesSearch ad templates by product, format and industry
    • get_templateRead one template: aspect, length and format
    • list_modelsList models with the settings each one accepts
    • list_effectsList the 20 one-photo video effects (e.g
    • render_effectRender a one-photo video effect from list_effects, SPENDS CREDITSSpends credits
    • browse_libraryFind creators, hooks, scenes and your saved products

  2. Price

    2
    • preview_generationPrice a template clone before creating it
    • preview_renderPrice a video, image or audio render

  3. Create

    5
    • clone_templateClone a template with your productSpends credits
    • render_videoRender a video from your prompt with any modelSpends credits
    • render_imageGenerate a product shot, background or characterSpends credits
    • render_audioGenerate a voice line, sound effect or music bedSpends credits
    • upload_assetUpload a local file so a render can use it

  4. Track

    1
    • get_generationCheck status and get the result URL

Story mode

20
  • story_list_projectsList the user's Wandura Story mode projects (films made from a script), newest first, with a link to open each one
  • story_create_projectCreate a Wandura Story mode project from a screenplay or story text and start the script breakdown (characters, places, props, episodes, scenes)
  • story_get_projectStart here for an existing project
  • story_get_scriptRead the analysed script of a Story mode project: title, logline, synopsis, genre and tone, and the episode outline
  • story_update_scriptReplace a Story mode project's script and analyse it again (a few minutes)
  • story_list_assetsList a Story mode project's assets (characters, backgrounds, props) with their descriptions and whether each has a picture yet
  • story_update_assetEdit an asset's name, description or identity phrase
  • story_get_episodeRead one episode of a Story mode project: every scene (one scene = one video clip) with its cast, reference assets, storyboard state (and whether it is outdated), video takes with status, and the chosen take
  • story_set_scene_assetsChoose which assets (reference pictures) a scene's storyboard and video are made from
  • story_refresh_sceneBring one scene up to date with the latest script after story_update_script
  • story_choose_takeChoose which finished video take of a scene goes into the episode (same as 'Use in episode' in Wandura)
  • story_quotePrice a paid step and ask the user to approve it in Wandura
  • story_get_quoteCheck whether the user approved, declined or let a quote expire, and after a run, which jobs it started
  • story_runRun a quote the user has approved in WanduraSpends credits
  • story_get_jobStatus of one Story mode job (asset picture, storyboard or scene video): queued, running, done (with url) or error
  • story_add_episodeAdd an episode to the end of a Story mode project
  • story_create_assetAdd a character, background or prop to a Story mode project, for ones the script breakdown did not find
  • story_set_asset_imageSet an asset's reference picture from an image the user gave you
  • story_export_episodeAssemble an episode into one video: the chosen take of every scene, in order, with the episode's music
  • story_get_exportStatus of the latest assembled video of an episode: none, assembling, done (with a download url) or error

You Stay in Control of Credits and Access

Price Before You Create

preview_generation and preview_render price a job for free. The CLI prints the price before every submit, and --cost-only stops after the price.

Limits Cap What an Agent Can Use

Only the tools that create something spend credits. Your balance and account limits cap what any agent can use, with the same credits and prices as the website.

Minimal Sign-In Scopes

Wandura sees your account identity so jobs are billed to your credits: openid, email and offline_access. Revoke access any time in your client’s connector settings.

Wandura MCP: Frequently Asked Questions

Quick answers about setup, credits and access.

Contact support

Create Ads from Your Agent

Connect once, then ask your agent to find a template, check the price and create.

See all setup options
  • Codex
  • Claude
  • Cursor
  • Windsurf