Character Studio / MCP
FOR AGENTS. MADE FOR CREATORS.

Your agent.
Your characters.
One creative workspace.

Create fictional characters, refine a selected region, and keep every version. Continue in the browser whenever you want.

Streamable HTTP · Private workspace keys · Limited free preview

character-studio / mcpEXAMPLE FLOW

01 / create_character
“An illustrated silver-haired detective”
→ job_id → character_id + version_id

02 / edit_image
“Change the coat to navy blue”
→ candidate image → select_version

03 / export_character
→ PNG + JSON + Studio URL

01 Describe02 Generate & inspect03 Refine a region04 Continue in Studio
01 / CONNECT

A key to your own workspace.

Create the key in the same browser you use for Studio. Characters made by your agent will appear in that browser’s library.

1. Create a connection keyThe key grants access to this browser’s characters and generation allowance. It expires after 30 days and can be revoked here.

2. Add the server to your clientCopy the configuration into Cursor’s MCP settings. In other Streamable HTTP clients, use the endpoint and Authorization header shown here.

mcp.jsonSTREAMABLE HTTP

The preview hides your key. Copy includes it. Keep it out of chat messages and public repositories; keys are shown only when created.

Creating or editing sends your description and relevant images to image-model providers. Imported references may be checked by a vision provider.

02 / CAPABILITIES

Nine tools. A complete workflow.

Start with get_capabilities. Discovery is public; private reads and all creative actions require your workspace key.

get_capabilities

Availability, modes, limits and allowance.

import_asset

Import a reference as an asset ID.

create_character

Generate from a description, or save a reference unchanged.

edit_image

Edit by semantic region, bounding box or mask.

get_job

Check progress and inspect the result image.

list_characters

Find characters in your workspace.

get_character

Read the current image and version history.

select_version

Accept a candidate or restore a saved version.

export_character

Get private PNG and character JSON downloads.

03 / FIRST CREATION

Give your agent a creative brief.

“Create an original adult detective with silver hair and a long coat, in illustration style. Show me the result, then change just the coat to navy blue.”
  1. Check availability; create_character returns a job ID.
  2. Poll get_job every 3 seconds. Inspect the returned image.
  3. Call edit_image with the exact version ID and target: outfit.
  4. Inspect the candidate, then select_version to accept it.
  5. Open the Studio link in this browser or export PNG + JSON.

A limited preview

Discovery is free. Creation and editing use a daily workspace allowance and a shared service quota. The live limits are shown above. Generation stops when either limit is reached.

Keep every version

Edits create candidates. Your current image changes only when you select a result. Strict mode preserves pixels outside the effective mask; whole-image composition does not guarantee identical identity.

Retry safely

Reuse the same idempotency key for an identical request. An unknown outcome requires inspection, not an automatic new submission. Private download links expire after 15 minutes.