
Generate images, video and audio from your agent. Every output is kept as an asset in your project.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Your Windpaint API key as a bearer token. Create one in the dashboard under Settings > API Keys. New accounts get 200 free credits.
Optional project id or slug. Jobs and assets go to your organization's default project when this is left out.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http windpaint https://mcp.windpaint.ai/mcp \ --header 'Authorization: Bearer YOUR_TOKEN'
Headers
Authorization (required): 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-Project (optional, not in the config above): Optional project id or slug. Jobs and assets go to your organization's default project when this is left out.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.
| Argument | Type | Description |
|---|---|---|
| job_id* | string |
{
"type": "object",
"title": "cancel_jobArguments",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"title": "Job Id"
}
}
}Cancel an unfinished workflow run; its pending and running steps and their generation jobs are canceled.
| Argument | Type | Description |
|---|---|---|
| run_id* | string |
{
"type": "object",
"title": "cancel_runArguments",
"required": [
"run_id"
],
"properties": {
"run_id": {
"type": "string",
"title": "Run Id"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| kind* | string | |
| name* | string | |
| slug | any | |
| project* | string | |
| description | any | |
| parent_item_id | any |
{
"type": "object",
"title": "create_itemArguments",
"required": [
"project",
"kind",
"name"
],
"properties": {
"kind": {
"type": "string",
"title": "Kind"
},
"name": {
"type": "string",
"title": "Name"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Slug",
"default": null
},
"project": {
"type": "string",
"title": "Project"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description",
"default": null
},
"parent_item_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Item Id",
"default": null
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| kind | any | |
| name* | string | |
| slug | any | |
| description | any |
{
"type": "object",
"title": "create_projectArguments",
"required": [
"name"
],
"properties": {
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Kind",
"default": null
},
"name": {
"type": "string",
"title": "Name"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Slug",
"default": null
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description",
"default": null
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| path | any | |
| asset* | string | |
| overwrite | boolean |
{
"type": "object",
"title": "download_assetArguments",
"required": [
"asset"
],
"properties": {
"path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Path",
"default": null
},
"asset": {
"type": "string",
"title": "Asset"
},
"overwrite": {
"type": "boolean",
"title": "Overwrite",
"default": false
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| loras | any | |
| model | any | |
| inputs | any | |
| prompt | string | |
| project | any | |
| quality | any | |
| capability* | string | |
| duration_s | any | |
| resolution | any | |
| num_outputs | any | |
| aspect_ratio | any | |
| output_format | any | |
| output_quality | any |
{
"type": "object",
"title": "estimate_costArguments",
"required": [
"capability"
],
"properties": {
"loras": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Loras",
"default": null
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model",
"default": null
},
"inputs": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"type": "null"
}
],
"title": "Inputs",
"default": null
},
"prompt": {
"type": "string",
"title": "Prompt",
"default": ""
},
"project": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Project",
"default": null
},
"quality": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Quality",
"default": null
},
"capability": {
"type": "string",
"title": "Capability"
},
"duration_s": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Duration S",
"default": null
},
"resolution": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Resolution",
"default": null
},
"num_outputs": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Num Outputs",
"default": null
},
"aspect_ratio": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Aspect Ratio",
"default": null
},
"output_format": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Output Format",
"default": null
},
"output_quality": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Output Quality",
"default": null
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| slug* | string | |
| inputs | any | |
| project | any |
{
"type": "object",
"title": "estimate_workflowArguments",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
},
"inputs": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Inputs",
"default": null
},
"project": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Project",
"default": null
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| item | any | |
| project* | string | |
| take_id | any | |
| overwrite | boolean |
{
"type": "object",
"title": "exportArguments",
"required": [
"project"
],
"properties": {
"item": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Item",
"default": null
},
"project": {
"type": "string",
"title": "Project"
},
"take_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Take Id",
"default": null
},
"overwrite": {
"type": "boolean",
"title": "Overwrite",
"default": false
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| item | any | |
| seed | any | |
| wait | boolean | |
| loras | any | |
| model | any | |
| inputs | any | |
| prompt | string | |
| project | any | |
| quality | any | |
| step_key | any | |
| timeout_s | integer | |
| capability* | string | |
| duration_s | any | |
| resolution | any | |
| num_outputs | any | |
| aspect_ratio | any | |
| output_format | any | |
| output_quality | any | |
| workflow_run_id | any |
{
"type": "object",
"title": "generateArguments",
"required": [
"capability"
],
"properties": {
"item": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Item",
"default": null
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Seed",
"default": null
},
"wait": {
"type": "boolean",
"title": "Wait",
"default": false
},
"loras": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Loras",
"default": null
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model",
"default": null
},
"inputs": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"type": "null"
}
],
"title": "Inputs",
"default": null
},
"prompt": {
"type": "string",
"title": "Prompt",
"default": ""
},
"project": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Project",
"default": null
},
"quality": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Quality",
"default": null
},
"step_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Step Key",
"default": null
},
"timeout_s": {
"type": "integer",
"title": "Timeout S",
"default": 120
},
"capability": {
"type": "string",
"title": "Capability"
},
"duration_s": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Duration S",
"default": null
},
"resolution": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Resolution",
"default": null
},
"num_outputs": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Num Outputs",
"default": null
},
"aspect_ratio": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Aspect Ratio",
"default": null
},
"output_format": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Output Format",
"default": null
},
"output_quality": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Output Quality",
"default": null
},
"workflow_run_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Workflow Run Id",
"default": null
}
}
}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.
No arguments.
{
"type": "object",
"title": "get_balanceArguments",
"properties": {}
}One item of a project. `item` is its id, slug or `@slug`.
| Argument | Type | Description |
|---|---|---|
| item* | string | |
| project* | string |
{
"type": "object",
"title": "get_itemArguments",
"required": [
"project",
"item"
],
"properties": {
"item": {
"type": "string",
"title": "Item"
},
"project": {
"type": "string",
"title": "Project"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| job_id* | string |
{
"type": "object",
"title": "get_jobArguments",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"title": "Job Id"
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| wait | boolean | |
| run_id* | string | |
| timeout_s | integer |
{
"type": "object",
"title": "get_runArguments",
"required": [
"run_id"
],
"properties": {
"wait": {
"type": "boolean",
"title": "Wait",
"default": false
},
"run_id": {
"type": "string",
"title": "Run Id"
},
"timeout_s": {
"type": "integer",
"title": "Timeout S",
"default": 300
}
}
}One workflow by slug, with its input form, outputs, steps, availability and credit estimate.
| Argument | Type | Description |
|---|---|---|
| slug* | string |
{
"type": "object",
"title": "get_workflowArguments",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| project | any |
{
"type": "object",
"title": "list_assetsArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 50
},
"project": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Project",
"default": null
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| capability | any | |
| available_only | boolean |
{
"type": "object",
"title": "list_capabilitiesArguments",
"properties": {
"capability": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Capability",
"default": null
},
"available_only": {
"type": "boolean",
"title": "Available Only",
"default": true
}
}
}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`.
| Argument | Type | Description |
|---|---|---|
| kind | any | |
| project* | string |
{
"type": "object",
"title": "list_itemsArguments",
"required": [
"project"
],
"properties": {
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Kind",
"default": null
},
"project": {
"type": "string",
"title": "Project"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| model | any | |
| family | any |
{
"type": "object",
"title": "list_lorasArguments",
"properties": {
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model",
"default": null
},
"family": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Family",
"default": null
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| archived | boolean |
{
"type": "object",
"title": "list_projectsArguments",
"properties": {
"archived": {
"type": "boolean",
"title": "Archived",
"default": false
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| project | any | |
| workflow_run_id | any |
{
"type": "object",
"title": "list_recent_jobsArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"project": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Project",
"default": null
},
"workflow_run_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Workflow Run Id",
"default": null
}
}
}Recent workflow runs, newest first (limit 1-200), optionally for one workflow slug.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| project | any | |
| workflow | any |
{
"type": "object",
"title": "list_runsArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"project": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Project",
"default": null
},
"workflow": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Workflow",
"default": null
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| item* | string | |
| project* | string |
{
"type": "object",
"title": "list_takesArguments",
"required": [
"project",
"item"
],
"properties": {
"item": {
"type": "string",
"title": "Item"
},
"project": {
"type": "string",
"title": "Project"
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| category | any |
{
"type": "object",
"title": "list_workflowsArguments",
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category",
"default": null
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| item | any | |
| slug* | string | |
| wait | boolean | |
| inputs | any | |
| project | any | |
| timeout_s | integer |
{
"type": "object",
"title": "run_workflowArguments",
"required": [
"slug"
],
"properties": {
"item": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Item",
"default": null
},
"slug": {
"type": "string",
"title": "Slug"
},
"wait": {
"type": "boolean",
"title": "Wait",
"default": false
},
"inputs": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Inputs",
"default": null
},
"project": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Project",
"default": null
},
"timeout_s": {
"type": "integer",
"title": "Timeout S",
"default": 300
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| item* | string | |
| project* | string | |
| take_id* | string |
{
"type": "object",
"title": "star_takeArguments",
"required": [
"project",
"item",
"take_id"
],
"properties": {
"item": {
"type": "string",
"title": "Item"
},
"project": {
"type": "string",
"title": "Project"
},
"take_id": {
"type": "string",
"title": "Take Id"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| kind | any | |
| name | any | |
| slug | any | |
| project* | string | |
| description | any |
{
"type": "object",
"title": "update_projectArguments",
"required": [
"project"
],
"properties": {
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Kind",
"default": null
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"default": null
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Slug",
"default": null
},
"project": {
"type": "string",
"title": "Project"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description",
"default": null
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| url | any | |
| path | any | |
| project | any | |
| filename | any | |
| data_base64 | any | |
| content_type | any |
{
"type": "object",
"title": "upload_assetArguments",
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"default": null
},
"path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Path",
"default": null
},
"project": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Project",
"default": null
},
"filename": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Filename",
"default": null
},
"data_base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Data Base64",
"default": null
},
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Content Type",
"default": null
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | |
| timeout_s | integer |
{
"type": "object",
"title": "wait_for_jobArguments",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"title": "Job Id"
},
"timeout_s": {
"type": "integer",
"title": "Timeout S",
"default": 300
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 21, 2026.