Windpaint
Server Details
Generate images, video and audio from your agent. Every output is kept as an asset in your project.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 28 tools
Most tools have clearly distinct resource+action targets, and the descriptions actively disambiguate the few near-neighbors (get_job vs wait_for_job, get_run vs list_runs, estimate_cost vs estimate_workflow, download_asset vs export). Remaining soft spots are generate vs run_workflow and list_assets vs list_takes, but the descriptions explain when to prefer each.
Overwhelmingly a verb_noun snake_case pattern (list_items, create_project, cancel_run, star_take, upload_asset). Only two bare verbs, `generate` and `export`, deviate, and both are still readable and unambiguous in context.
28 tools is on the heavy side and a few could be folded together (wait_for_job as a flag on get_job, estimate_workflow vs estimate_cost, export vs download_asset), plus job/run listing triplets. Still, the domain genuinely spans projects, items, takes, assets, jobs, workflows, runs and credits, so most tools earn their place.
The generation lifecycle is well covered (upload, estimate, generate, poll, cancel, download, star, export, workflows, billing). But lifecycle coverage for other resources has gaps: no update_item or delete_item, no delete_asset/delete_take, and no tool to archive or delete a project despite archived projects being referenced.
Available Tools
28 toolscancel_jobCancel jobADestructiveIdempotentInspect
Cancel a job that has not finished. A model call already running is not interrupted, but its result
is discarded. Returns the job's status afterwards. job_id is the request_id returned by generate.
Inputs: job_id (required). Returns: object
cancel_runCancel workflow runADestructiveIdempotentInspect
Cancel an unfinished workflow run; its pending and running steps and their generation jobs are canceled.
Inputs: run_id (required). Returns: object
create_itemCreate itemAInspect
Create an item in a project. kind is character, place, object, style, sequence or set. The slug
(default: derived from name) is unique in the project and is how prompts and tools refer to it, as @slug.
parent_item_id makes the item a shot of a sequence item. Pass the item to generate or run_workflow
(item) to record outputs as its takes.
Inputs: kind (required), name (required), project (required), slug, +2 more. Returns: object
create_projectCreate projectAInspect
Create a project to keep a piece of work's assets and jobs together. Returns it with its id and slug.
kind says what the project is for (general, film, game, ads, app; default general). It picks the project's icon and
which presets, workflows and docs are shown first, and never restricts what the project can run.
Inputs: name (required), kind, slug, description. Returns: object
download_assetDownload assetADestructiveInspect
Get a generated (or uploaded) file. asset is an asset id or the asset url from a job status.
Locally (stdio) the file is saved to path (default: current directory, named after the asset id)
and the saved path is returned. Remotely (HTTP) nothing is saved: a short-lived signed download URL is
returned instead, and path/overwrite are ignored (the result says so); download the url yourself.
Inputs: asset (required), path, overwrite. Returns: object
estimate_costEstimate costARead-onlyInspect
Credits a generation would cost, without running it. Same arguments as generate. Also validates the
arguments and returns the model chosen and output width/height. credits is null when that tier has no
price, which means it cannot be submitted; otherwise it is unit_credits x num_outputs.
available_credits is the organization's spendable balance. available means the model can run at this
tier now; it does not check the balance. The job is refused when credits exceeds available_credits, or
when the model is paid_credits_only (see list_capabilities) and the organization has no purchased credits.
Inputs: capability (required), loras, model, inputs, +9 more. Returns: object
estimate_workflowEstimate workflow costARead-onlyInspect
Credits a workflow run would cost with these inputs, without running it. Validates the inputs against
the workflow's form. Media inputs take one asset id from upload_asset or an earlier job, a public https URL
or a data: URI. Also returns
available_credits, the organization's spendable balance.
Inputs: slug (required), inputs, project. Returns: object
exportExportADestructiveInspect
Get the files of starred takes: one entry per output asset, as in download_asset (saved to the current
directory over stdio, or a short-lived signed URL over HTTP), tagged with item and take_id. Give item
(id, slug or @slug) for one item, else every item in the project is covered. Give take_id to export that
take even if it is not starred (needs item). Takes that are not starred are skipped, so star first.
Inputs: project (required), item, take_id, overwrite. Returns: result
generateGenerateAInspect
Run a capability (see list_capabilities). model is optional; the capability's first available model,
in list_capabilities order, is used. estimate_cost shows which model that is and its price.
inputs maps slot names to asset ids, e.g. {"images": [id1, id2]} for image.edit or
{"start_frame": [id]} for video.generate; ids come from upload_asset or earlier jobs' outputs. A public
https URL or a data: URI also works in place of an id; the API stores it as an asset at submit.
Credits are charged per job; the response has credits_estimate. With wait=false (default) it returns at
once with request_id; with wait=true the API holds the submit until the job finishes (up to 60s, then
polling continues) for up to timeout_s (max 600) and returns the final status,
whose outputs list the produced asset ids. Images take seconds to a minute; video takes minutes, so
prefer wait=false then wait_for_job. workflow_run_id/step_key tag the job as a step of a workflow.
item (an item id, slug or @slug in project; see list_items) records the output as a new take of that
item. The take is not starred automatically: review it with list_takes and keep it with star_take.
Image models only: num_outputs (1 to the model's max_outputs, at most 4) makes several images in one
job, priced per image and charged only for images delivered; output_format is png (default), jpeg or
webp, and output_quality (1-100) sets jpeg/webp encoding quality.
loras applies up to three platform LoRAs (styles, looks) by slug, optionally with a strength as
"slug:0.8" (default is the LoRA's own). Only models with a lora_family accept them, and only LoRAs of that
family; list_loras shows what fits a model. Each LoRA adds 15% to the price and its trigger words to the prompt.
Inputs: capability (required), item, seed, wait, +15 more. Returns: object
get_balanceGet balanceARead-onlyInspect
The organization's credits: available (spendable now), held (reserved by running jobs, already
excluded from available), totals by_source (plan, top-up, grant), the next expiry, and each credit lot.
Jobs are refused when available credits are below their estimate; top-ups happen in the dashboard.
Inputs: no named parameters. Returns: object
get_itemGet itemCRead-onlyInspect
One item of a project. item is its id, slug or @slug.
Inputs: item (required), project (required). Returns: object
get_jobGet jobARead-onlyInspect
Current status of a generation job: queued, in_progress, completed, failed, nsfw or canceled.
Completed jobs list produced assets under outputs (each with an asset id and url; also images/video
as shortcuts), plus credits estimated and actually charged. job_id is the request_id returned by generate.
Inputs: job_id (required). Returns: object
get_runGet workflow runARead-onlyInspect
A workflow run: status (queued, running, completed, failed, canceled), each step's status, generation
request and outputs, the run's named outputs, and credits. wait=true polls up to timeout_s (max 600).
Inputs: run_id (required), wait, timeout_s. Returns: object
get_workflowGet workflowARead-onlyInspect
One workflow by slug, with its input form, outputs, steps, availability and credit estimate.
Inputs: slug (required). Returns: object
list_assetsList assetsBRead-onlyInspect
Assets in a project, newest first: uploads and generated outputs, with kind, size, dimensions and the job that produced them. Use their ids as inputs to generate.
Inputs: limit, project. Returns: result
list_capabilitiesList capabilitiesARead-onlyInspect
List what Windpaint can do. For each capability: description, output kind, whether a prompt is
required and what it means, the input slots (name, accepted asset kinds, min/max count), and the models
that implement it with available, licence, resolutions, qualities, durations, max_outputs,
output_formats and the current credit price per tier. A capability with no available model cannot be run yet.
Call this first. By default only models you can run now are listed in full; the rest are summed up in
unavailable_models (model, status and why it can't run). Pass capability (e.g. "video.generate")
to get just one, and available_only=false for the full catalog, including every model that can't run yet.
Inputs: capability, available_only. Returns: result
list_itemsList itemsARead-onlyInspect
Items in a project: named things a piece of work keeps coming back to, of kind character, place, object,
style, sequence or set. Each has id, slug, name, kind and starred_take_id. Filter by kind.
project is its id or slug. Items are addressed by id, slug or @slug (the form used in prompts) wherever a
tool takes item.
Inputs: project (required), kind. Returns: result
list_lorasList LoRAsARead-onlyInspect
Platform LoRAs (styles and looks) that generate and estimate_cost accept in loras. Each has a slug, a
family matching a model's lora_family in list_capabilities, trigger words added to the prompt, and a
default and max scale. Pass model (e.g. "z-image-turbo") to see only the LoRAs that model can use.
Inputs: model, family. Returns: result
list_projectsList projectsARead-onlyInspect
Projects in the caller's organization. Every asset and job belongs to one; when a tool's project is
omitted the API key's default project (or the organization's default) is used. project accepts a project
id or slug. Set archived=true to include archived projects alongside active ones.
Inputs: archived. Returns: result
list_recent_jobsList recent jobsARead-onlyInspect
Most recent generation jobs in one project, newest first (limit 1-200), with status, outputs and
credits. The project is project if given, else the API key's default; jobs in other projects are not
included, so to see everything call list_projects and pass each. Filter by workflow_run_id to see the
steps of one workflow run.
Inputs: limit, project, workflow_run_id. Returns: result
list_runsList workflow runsBRead-onlyInspect
Recent workflow runs, newest first (limit 1-200), optionally for one workflow slug.
Inputs: limit, project, workflow. Returns: result
list_takesList takesARead-onlyInspect
Takes of an item, i.e. the generations recorded against it: each with id, status, is_starred and
outputs (assets with url). item is its id, slug or @slug. New takes are not starred automatically;
review the outputs and call star_take on the one to keep.
Inputs: item (required), project (required). Returns: result
list_workflowsList workflowsARead-onlyInspect
Ready-made workflows (e.g. text-to-clip, product-to-ad, effect presets): multi-step pipelines built on the
capabilities. Each has an inputs form (name -> type, label, required, default, options for choices),
its outputs, the steps it runs, available with unavailable_reasons, and credits_estimate at default
settings. Prefer a workflow over chaining generate calls by hand when one fits. Filter by category
(image, video, audio).
Inputs: category. Returns: result
run_workflowRun workflowAInspect
Run a workflow. inputs fills its form (see list_workflows): text and choice values as strings, media
as one asset id, public https URL or data: URI each. Credits are the sum of its steps; the run reports estimate and actual. With
wait=false (default) it returns the queued run with its id; with wait=true it polls up to timeout_s
(max 600) and returns the run with outputs (output name -> assets). Runs with video take minutes.
item (an item id, slug or @slug in project; see list_items) records the run as a new take of that item;
the take is not starred automatically (review with list_takes, keep with star_take).
Inputs: slug (required), item, wait, inputs, +2 more. Returns: object
star_takeStar takeAInspect
Mark a take as the item's chosen one (the item's starred_take_id). item is its id, slug or @slug;
take_id comes from list_takes. Returns the take.
Inputs: item (required), project (required), take_id (required). Returns: object
update_projectUpdate projectAInspect
Change a project's name, slug, description or kind (general, film, game, ads, app). project is its id or slug.
Only the fields given are changed; an empty description clears it. Returns the updated project.
Inputs: project (required), kind, name, slug, +1 more. Returns: object
upload_assetUpload assetAInspect
Upload a reference image, start frame, video or audio file and get an asset id to pass as
inputs ({slot: [asset ids]}; slot names come from list_capabilities). Give exactly one of: path (a local file; only when the server runs locally over stdio),
url (a public http(s) URL the server fetches), or data_base64 (with filename or content_type; up to 20 MB when the server is remote).
data_base64 has to fit in the tool call itself, so it suits small files; for anything over a few hundred
KB pass a url instead.
Accepted: PNG, JPEG, WebP images (up to 20 MB); MP4, MOV, WebM video (200 MB, 60 s); MP3, WAV, M4A, OGG
audio (25 MB, 5 min). The API detects the format from the bytes. Uploads are free.
Inputs: url, path, project, filename, +2 more. Returns: object
wait_for_jobWait for jobARead-onlyInspect
Wait for a job to finish, polling for up to timeout_s seconds (max 600). Returns the final status,
or the latest status with a note if it is still running; call again to keep waiting. job_id is the
request_id returned by generate.
Inputs: job_id (required), timeout_s. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Generate and edit images, video, voice, lip-sync and 3D models from your AI agent.
Generate reproducible image, video, and audio assets with leading models and your own provider keys.
Generate images, videos, voiceovers, and captions from a chat prompt.
Generate images, video, and audio with Glif's media-generation agent
Related MCP Servers
- AlicenseAqualityBmaintenanceGenerates images, videos, music, and speech via the Chutes API, saving assets directly into the project workspace.358 npm1MIT
- AlicenseNot gradedqualityDmaintenanceGenerate and refine AI images/audio/video through natural conversation.412Apache 2.0

arcframe-mcpofficial
AlicenseNot gradedqualityDmaintenanceGenerate videos, images, audio, and 3D models from any MCP-compatible AI agent — Claude, Cursor, ChatGPT, and more.MIT- AlicenseNot gradedqualityAmaintenanceEnables MCP-compatible clients to generate images and videos, synthesize speech, clone and design voices, and create related media outputs.468 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.