Available Tools
KPainter MCP provides eight tools for discovery, upload, creation, status, refinement, recovery, and outputs.
| Tool | When to use it |
|---|---|
| kp_capabilities | Read products, file limits, video templates and voices, and image models |
| kp_upload_file | Upload one base64-encoded source and receive a file_id |
| kp_create | Create a video, image, or app |
| kp_list | List the current account's creations |
| kp_get | Read one creation's status, progress, ETA, credits, review, and actions |
| kp_message | Refine an Explainer Video in natural language |
| kp_act | Perform one action explicitly returned by kp_get |
| kp_outputs | Read URLs for usable delivery outputs |
Creation Order
- kp_capabilities
- kp_upload_file when sources are needed
- kp_create
- kp_get until a terminal state
- kp_outputs
Refine a Video
- Use kp_get to confirm current state.
- Send the change and a stable idempotency_key through kp_message.
- Continue with kp_get.
- Refresh kp_outputs after completion.
Continue a Paused Task
- Read available_actions from kp_get.
- Let the user complete recharge or approval.
- Call kp_act with an advertised action.
- Reuse the same idempotency_key for the same attempt.
- Continue only the latest paused task.
Parameter Rules
- Public fields use snake_case.
- kp_create common fields are type, prompt, instructions, input_file_ids, and max_credits.
- Put product settings in the matching video, image, or app object.
- Choose an image provider and model from one capabilities bundle.
- Send only the public fields documented here and returned by kp_capabilities.
- Do not invent status, ETA, credits, or output URLs.