Kyoso MCP
Our Model Context Protocol AI agents connect directly to Kyoso and control its creative workflows. Pass briefs, brand context, and assets straight into Kyoso, and get finished creative content back without ever opening the app.
Add Kyoso as an HTTP MCP server (https://mcp.kyoso.com/mcp), user scope. Verify the connection with the whoami tool, then tell me if auth is needed.Every tool, argument, and auth flow
The guide covers per-client setup, the OAuth handshake, and each tool's parameters and return shape.
Capabilities
What your agent can do
The server exposes Kyoso's creative agent as tools, so an assistant can run real production work inside your projects.
Create and drive projects
Open a new project, then hand it natural-language steps. Each step runs on the canvas and reports back when the work lands.
Generate images and video
Image generation and editing with aspect-ratio adaptation, video generation, plus frames and composition layout.
Attach your own files
Upload product shots, logos, and references from disk as project assets, and track processing until they're ready to use.
Read the canvas back
Walk the node tree, inspect node properties, render any node into the conversation, or get a downloadable PNG link.
Reference
Tools
Everything the server exposes today.
- whoami
- Confirms authentication and returns your user ID.
- kyoso_create_project
- Creates a project and returns its ID and canvas URL.
- kyoso_start_step
- Runs a natural-language instruction against a project.
- kyoso_step_execution_status
- Reports whether a step has finished.
- kyoso_step_messages
- Returns step activity and the agent's messages.
- kyoso_list_canvas_tree
- Lists the node hierarchy with IDs, types, names, and sizes.
- kyoso_inspect_node
- Returns a node's properties and its subtree.
- kyoso_render_node
- Renders a node to an image for display in the conversation.
- kyoso_get_render_url
- Creates a downloadable PNG link for a node.
- kyoso_prepare_project_asset_upload
- Starts uploading a local file as a project asset.
- kyoso_finalize_project_asset
- Completes the upload and begins processing.
- kyoso_project_asset_status
- Tracks an asset's processing progress.