MODEL CONTEXT PROTOCOL

Your characters, from your AI assistant.

Every account includes an MCP server. Connect it to Claude Code, Claude Desktop, Cursor, or any client that supports Streamable HTTP, and your assistant can design, animate, and download characters as part of a larger task.

Create an account All features

THREE STEPS

Connected in a couple of minutes.

1. Create an access key

Sign in, open MCP connection in your studio, and create a key. It is shown once, so copy it straight into your client. Keys expire after 30 days and can be replaced or revoked at any time.

2. Add the server to your client

Add the server URL from the same page as a Streamable HTTP server with a Bearer Authorization header. Most clients accept the JSON configuration below; the studio can copy it pre-filled with your key.

3. Ask for a character

Tell your assistant what you want. It will show you the design and ask before spending credits — every tool that costs a credit says so in its description, so a well-behaved client confirms first.

CLIENT CONFIGURATION

A configuration most clients understand.

Paste this into the mcpServers section of your client’s configuration and replace the placeholder with your access key. Copy the exact server URL from your studio.

{
  "mcpServers": {
    "character-animation-ai": {
      "type": "http",
      "url": "https://api.characteranimationai.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_ACCESS_KEY" }
    }
  }
}

Claude Code

Run claude mcp add --transport http character-animation-ai <server-url> --header "Authorization: Bearer <key>", or add the JSON above to your project’s .mcp.json.

Claude Desktop and Cursor

Open the MCP settings, add a new server, and paste the JSON. Restart the client if it does not pick up the new server immediately.

Other clients

Any client that supports the MCP Streamable HTTP transport with custom headers works. Local-only clients need a publicly reachable HTTPS server, which the hosted studio provides.

WHAT YOUR ASSISTANT CAN DO

Seven tools. The whole workflow.

Read-only tools are free. Tools that generate cost the same credits as the studio: 1 per design, 1 per animation.

List characters

READ ONLY

list_characters

Browse your characters and saved animations.

Check character & animation

READ ONLY

get_character

Read a character, its animation history, previews, and generation progress. Poll this after starting a job.

Generate a character

1 CREDIT

generate_character

Create a new character design from a prompt and style. Returns a job; nothing is animated until the design is approved.

Create an animation

1 CREDIT

animate_character

Animate an approved character with a preset or custom motion. Earlier completed animations are kept.

Retry failed generation

1 CREDIT

retry_generation

Retry a failed design or animation. Animation retries reuse saved provider work where possible.

Get animation downloads

READ ONLY

get_animation_downloads

Get WebM, MOV, GIF, and MP4 links for a completed animation, optionally for a specific saved version.

Check credits & motions

READ ONLY

get_account

Read your remaining credits and the available motion presets.

A TYPICAL SESSION

What a conversation looks like.

You ask

“Make a soft 3D panda mascot for our meditation app, then animate it waving for the welcome screen and give me the WebM.”

Your assistant

Calls get_account to confirm credits and motions
Asks permission, then generate_character
Polls get_character and shows you the design
With your approval, animate_character with the Wave preset
Returns links from get_animation_downloads

GOOD TO KNOW

Keys, limits, and safety.

What a key can do

A connected client can read your characters and spend your credits on generation. It cannot change billing, buy credits, or delete your account.

Rotation and revocation

Keys expire after 30 days. Replacing a key disconnects clients using the old one immediately; revoking it disconnects everything until you create a new key.

Same rules as the studio

Generations started over MCP appear in your library, refund on failure, and use the same plan limits. Downloads are the same files you would get in the browser.