Generate images, video and audio from your agent. Every output is kept as an asset in your project.
MCP Score How we grade
A server needs 3 daily checks before it gets a grade (1 so far).
Connect Remote server
claude mcp add --transport http windpaint https://mcp.windpaint.ai/mcp --header "Authorization: Bearer <YOUR_API_KEY>" --header "X-Windpaint-Project: <X_WINDPAINT_PROJECT>"
{
"mcpServers": {
"windpaint": {
"url": "https://mcp.windpaint.ai/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>",
"X-Windpaint-Project": "<X_WINDPAINT_PROJECT>"
}
}
}
}
{
"servers": {
"windpaint": {
"type": "http",
"url": "https://mcp.windpaint.ai/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>",
"X-Windpaint-Project": "<X_WINDPAINT_PROJECT>"
}
}
}
}
Settings > Connectors > Add custom connector
URL: https://mcp.windpaint.ai/mcp
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools 28 found in our last check
list_capabilitiesList 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,…
list_lorasPlatform 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 on…
estimate_costCredits 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…
upload_assetUpload 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…
generateRun 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…
get_jobCurrent 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 `re…
wait_for_jobWait 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.
download_assetGet 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 signe…
cancel_jobCancel 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.
list_recent_jobsMost 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 `wor…
list_assetsAssets 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.
get_balanceThe 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…
list_projectsProjects 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 a…
create_projectCreate 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 neve…
update_projectChange 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.
list_itemsItems 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`…
get_itemOne item of a project. `item` is its id, slug or `@slug`.
create_itemCreate 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 i…
list_takesTakes 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.
star_takeMark 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.
exportGet 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 i…
list_workflowsReady-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_reaso…
get_workflowOne workflow by slug, with its input form, outputs, steps, availability and credit estimate.
estimate_workflowCredits 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…
run_workflowRun 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…
get_runA 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).
list_runsRecent workflow runs, newest first (limit 1-200), optionally for one workflow slug.
cancel_runCancel an unfinished workflow run; its pending and running steps and their generation jobs are canceled.
Headers
| Name | Description |
|---|---|
AuthorizationRequired, secret | Your Windpaint API key as a bearer token. Create one in the dashboard under Settings > API Keys. New accounts get 200 free credits. |
X-Windpaint-ProjectOptional | Optional project id or slug. Jobs and assets go to your organization's default project when this is left out. |
Details
| Endpoint | https://mcp.windpaint.ai/mcp (Streamable HTTP) |
| First published | 21 Nov 2026 |
| Last updated | 21 Nov 2026 |
| Registry name | ai.windpaint/windpaint |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
