MCP Overview Guide

Bring KPainter Into MCP-Compatible Agents

If you are integrating KPainter into an MCP-compatible client, IDE, or agent host, MCP is the right entry point.

KPainter MCP is a thin adapter over the public OpenAPI. It keeps the same official content types, validation rules, and async creation flow.

When MCP Is The Right Fit

Interface	Best for	Not the main fit
`Skills`	end users talking to an agent that already supports Agent Skills	custom product integration
`OpenAPI`	products that want direct REST-style create, poll, list, and detail calls	MCP-native agent tooling
`MCP`	agent hosts, IDEs, and tool-calling model platforms	replacing the main site's browser API

If you are building normal web pages inside KPainter, keep using /kp-app-api/v1/*.

If you are building your own product integration, OpenAPI is still the better default.

If you are connecting KPainter to an external MCP client, start here.

What MCP Currently Covers

MCP currently exposes the minimal public creation workflow:

validate a user API key
read the current catalog and limits
create content
list creations
read creation detail
poll async job status
edit one scene for supported content types

It does not cover:

sign-up or sign-in
API key activation, rotation, or deletion
payments or subscriptions
comments, chat, likes, or views
restart flows
full white-box editing

Supported Content Types

Use the same official public type names as OpenAPI:

explainer_video
read_aloud_video
vector_animation
image
ai_video
slides
interactive_lesson

Use the type names returned by the catalog when creating content.

They map to the seven product pages in the same order as Skills and OpenAPI: Explainer Video, Read Aloud Video, Vector Animation, AI Image, AI Video, AI PPT, and AI App.

Recommended Workflow

Call kp_me to validate the key.
Call kp_get_catalog, then choose type, model-specific image/video fields, voice_id, style_id, duration_seconds, or scene_count only when allowed.
Call kp_create_creation.
Poll kp_get_job_status.
Call kp_get_creation for final URLs, artifacts, and scenes.
Before editing, inspect editable_actions; use kp_edit_creation for scene edits or Omni AI Video iteration.

Tools, Resources, and Prompts

MCP currently exposes:

8 tools
3 resources
2 prompts

The tools are the main integration surface.

Resources and prompts are helper surfaces for discovery and guided workflows. Some resources rely on the server's default API key, so do not treat them as a substitute for explicit per-user authentication.