KPainter

This page shows the minimum MCP setup that gets KPainter running inside an MCP-compatible client.

KPainter MCP uses the user's own API key.

For local MCP clients,stdiois the easiest path.

Ifkp-mcpis already available in your environment, a standard config looks like this:

{ "mcpServers": { "kpainter": { "command": "kp-mcp", "env": { "KGP_API_KEY": "<your_api_key>" } } } }

If you are running from thekgp-servicesource tree instead, use:

{ "mcpServers": { "kpainter": { "command": "python", "args": ["-m", "src.mcp_server"], "cwd": "/path/to/kgp-service", "env": { "KGP_API_KEY": "<your_api_key>" } } } }

The MCP tool names now use thekp_*prefix, so start with tools such askp_meandkp_get_catalog.

Once the MCP server is connected, start with:

- the key is valid
- it belongs to the intended user
- it can manage creations

Do not skip this and jump straight into creation.

- type
- aspect_ratio
- output_quality
- voice_id
- style_id
- duration_seconds
- scene_count
- image_provider / image_model / image_quality
- video_model / video_task / video_resolution / video_duration_seconds

A first happy-path workflow usually looks like this:
- kp_me
- kp_get_catalog
- kp_create_creation
- kp_get_job_status
- kp_get_creation

For example, you can ask your MCP client to create something like:

Create a Read Aloud Video in English that explains how MCP works in 6 pages.

The client should then map that request to the official type and parameters returned bykp_get_catalog.

The MCP product pages show the exact flat arguments accepted bykp_create_creation. Do not copy the nestedimage_generationorvideo_generationshapes from the REST OpenAPI into an MCP tool call.

- main_url
- artifacts
- scenes
- editable_actions

This is the main place to read the finished result.

For supported types, inspecteditable_actionsandscenesfirst, then use:
- kp_edit_creation
- kp_get_job_status
- kp_get_creation

- Authentication
understand howapi_keyand default-key fallback work
- Transport Modes
see when to usestdioor Streamable HTTP
- Available Tools
browse the current tools, resources, and prompts

Search Apple's Developer Documentation with smart search and wildcard support.