Design characters and logos with AI and turn them into interactive Rive animations and video.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use this when the user wants more animations for a character they already made (a ready set from create_character_set or list_character_sets): pass its set_id and the animations to add (launch, happy, wave, loading). The character keeps its look and the animations it has; only the new ones use credits (one each). It takes a few minutes; the result is a new set_id for the updated character (check it with get_character_set). Requires a linked Charmotion account.
set_id of the character's newest ready set.
Animations to add. Ones the character already has are skipped.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http charmotion https://charmotion.app/mcp
Use this when the user wants more animations for a character they already made (a ready set from create_character_set or list_character_sets): pass its set_id and the animations to add (launch, happy, wave, loading). The character keeps its look and the animations it has; only the new ones use credits (one each). It takes a few minutes; the result is a new set_id for the updated character (check it with get_character_set). Requires a linked Charmotion account.
| Argument | Type | Description |
|---|---|---|
| set_id* | string | set_id of the character's newest ready set. |
| animations* | array | Animations to add. Ones the character already has are skipped. |
{
"type": "object",
"required": [
"set_id",
"animations"
],
"properties": {
"set_id": {
"type": "string",
"description": "set_id of the character's newest ready set."
},
"animations": {
"type": "array",
"items": {
"enum": [
"launch",
"idle",
"happy",
"wave",
"loading",
"thinking",
"sad",
"listening",
"talking",
"sleeping",
"attention"
],
"type": "string"
},
"maxItems": 11,
"minItems": 1,
"description": "Animations to add. Ones the character already has are skipped."
}
},
"additionalProperties": false
}Use this after the user has chosen one of the concepts from start_motion. Starts the build of that concept (uses 5 credits from the user's balance; failed or stopped builds give them back). The builder writes the animation, renders it, checks its quality and packages code for each platform. Takes 5 to 30 minutes; check with get_motion. Requires a linked Charmotion account.
| Argument | Type | Description |
|---|---|---|
| adjust | string | Optional small change to the chosen concept, in the user's words. |
| motion_id* | string | The motion_id returned by start_motion. |
| concept_id* | string | The concept_id the user chose (c1, c2 or c3). |
{
"type": "object",
"required": [
"motion_id",
"concept_id"
],
"properties": {
"adjust": {
"type": "string",
"maxLength": 600,
"description": "Optional small change to the chosen concept, in the user's words."
},
"motion_id": {
"type": "string",
"description": "The motion_id returned by start_motion."
},
"concept_id": {
"type": "string",
"description": "The concept_id the user chose (c1, c2 or c3)."
}
},
"additionalProperties": false
}Use this when a signed-in user wants their character animated: from a ready AI character design (design_id, recommended when they designed one) or from a character image they shared. Pass exactly one of design_id or image, and the animations they picked (launch, happy, wave, loading; idle is always included for free). Uses 1 credit per picked animation from the user's balance; an animation the engine can't make gives its credit back automatically. The image is checked first: it must be one finished, coloured character (not a sketch, a photo or a group). The character (Rive file with a state machine, code, README, posters) is usually ready a few minutes later; check it with get_character_set. More animations can be added later with add_animations. Videos are exported afterwards with export_videos. Sending the same image (or design) and name again within 10 minutes returns the existing character instead of charging again. An account without a plan gets one free try: exactly one animation, wave or loading (idle comes with it); its MP4 is made automatically and shown in the chat. Requires a linked Charmotion account.
| Argument | Type | Description |
|---|---|---|
| name* | string | Short name for the character, e.g. 'Kiko'. Used for file names. |
| image | object | The character image (PNG, JPEG or WebP, at least 512 px, up to 10 MB). Outside ChatGPT, set download_url to a public https link to the image and file_id to its file name. Leave out when using design_id. |
| design_id | string | A ready AI character design of this account (from design_character, get_design or list_designs), instead of an image. |
| animations |
Use this when a signed-in user wants a character or mascot animated but has no image of it yet, or asks for a new one: designing it with AI is the recommended first step of the character path. Ask what the app's designer asks: a short description, the archetype, and optionally the look, up to two personality words and up to three colours. Generates one original, front-facing character on a plain background. Uses 1 credit from the user's balance (failed or refused attempts give it back). Usually ready in under a minute: this call waits briefly, then check with get_design and show the image. Next step: create_character_set with its design_id (or retry_design for another version). No existing characters, brands or real people. Requires a linked Charmotion account.
| Argument | Type | Description |
|---|---|---|
| look | string | Drawing style. Default: soft. |
| colours | array | Optional brand colours as #rrggbb. |
| archetype* | string | What kind of character it is. |
| description* | string | What the character is, in the user's words, e.g. 'a round cloud with rosy cheeks and tiny boots'. |
| personality | array | Optional, up to two. |
{
"type": "object",
"required": [
"description",
"archetype"
],
"properties": {
"look": {
"enum": [
"soft",
"flat",
"outline",
"minimal"
],
"type": "string",
"description": "Drawing style. Default: soft."
},
"colours": {
"type": "array",
"items": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
"maxItems": 3,
"description": "Optional brand colours as #rrggbb.",
"uniqueItems": true
},
"archetype": {
"enum": [
"creature",
"animal",
"robot",
"person",
"object"
],
"type": "string",
"description": "What kind of character it is."
},
"description": {
"type": "string",
"maxLength": 300,
"minLength": 3,
"description": "What the character is, in the user's words, e.g. 'a round cloud with rosy cheeks and tiny boots'."
},
"personality": {
"type": "array",
"items": {
"enum": [
"cheerful",
"calm",
"cheeky",
"brave",
"shy",
"nerdy",
"sleepy",
"sporty"
],
"type": "string"
},
"maxItems": 2,
"description": "Optional, up to two.",
"uniqueItems": true
}
},
"additionalProperties": false
}Use this when a signed-in user wants a logo animated but has no logo yet, or asks for a new one: designing it with AI is the recommended first step of the logo path. Ask what the app's logo designer asks: the brand name (spelled exactly), and optionally what the brand does, the logo type, up to two feel words and up to three colours. Generates one flat logo on a plain background. Uses 1 credit from the user's balance (failed or refused attempts give it back). Usually ready in under a minute: this call waits briefly, then check with get_design, show the image and ask the user to check the spelling. Next step: start_motion with its design_id (or retry_design for another version). The user's own brand only: no well-known brands or real people. Requires a linked Charmotion account.
| Argument | Type | Description |
|---|---|---|
| feel | array | Optional, up to two. |
| what | string | Optional: what the brand does, in a few words. |
| brand* | string | The brand name, spelled exactly as it should appear. |
| colours | array | Optional brand colours as #rrggbb. |
| logo_type | string | symbol = a symbol with the name (default); wordmark = the name only; lettermark = initials; mascot = a mascot badge. |
{
"type": "object",
"required": [
"brand"
],
"properties": {
"feel": {
"type": "array",
"items": {
"enum": [
"premium",
"playful",
"minimal",
"bold",
"techy",
"elegant",
"friendly",
"calm",
"cinematic"
],
"type": "string"
},
"maxItems": 2,
"description": "Optional, up to two.",
"uniqueItems": true
},
"what": {
"type": "string",
"maxLength": 120,
"description": "Optional: what the brand does, in a few words."
},
"brand": {
"type": "string",
"maxLength": 24,
"minLength": 1,
"description": "The brand name, spelled exactly as it should appear."
},
"colours": {
"type": "array",
"items": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
"maxItems": 3,
"description": "Optional brand colours as #rrggbb.",
"uniqueItems": true
},
"logo_type": {
"enum": [
"symbol",
"wordmark",
"lettermark",
"mascot"
],
"type": "string",
"description": "symbol = a symbol with the name (default); wordmark = the name only; lettermark = initials; mascot = a mascot badge."
}
},
"additionalProperties": false
}Use this when the user wants video files of a ready Charmotion character: MP4 (1080x1080, 60 fps), vertical (the 9:16 launch MP4), webm and mov (transparent), gif. Queues an export of those formats for all its animations, or only the listed ones; it takes about a minute and uses nothing. Files that already exist are not made again. Then call get_character_set for the download links. Only formats in the set's plan; one export at a time. Requires a linked Charmotion account.
| Argument | Type | Description |
|---|---|---|
| set_id* | string | set_id from create_character_set or list_character_sets. |
| formats | array | Video formats to export. Default: ["mp4"]. |
| animations | array | Animations to export (only ones the character has). Default: all of them. |
{
"type": "object",
"required": [
"set_id"
],
"properties": {
"set_id": {
"type": "string",
"description": "set_id from create_character_set or list_character_sets."
},
"formats": {
"type": "array",
"items": {
"enum": [
"mp4",
"vertical",
"webm",
"mov",
"gif"
],
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"description": "Video formats to export. Default: [\"mp4\"]."
},
"animations": {
"type": "array",
"items": {
"enum": [
"idle",
"happy",
"wave",
"thinking",
"sad",
"loading",
"listening",
"talking",
"sleeping",
"attention",
"success",
"error",
"yes",
"no",
"enter",
"exit",
"launch"
],
"type": "string"
},
"maxItems": 17,
"minItems": 1,
"description": "Animations to export (only ones the character has). Default: all of them."
}
},
"additionalProperties": false
}Use this for how-to questions about animating characters, mascots and logos: Rive and Lottie, splash and loading animations, transparent video, file sizes, and adding animations to websites, iOS, Android, React or no-code builders. Searches Charmotion's free guides and returns up to three matching articles with links. Read-only. Do not use for general questions unrelated to animation.
| Argument | Type | Description |
|---|---|---|
| query* | string | What the user wants to know, in English, e.g. 'add Rive animation to Next.js'. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "What the user wants to know, in English, e.g. 'add Rive animation to Next.js'."
}
},
"additionalProperties": false
}Use this when the user asks which Charmotion account is connected, which plan it has, or how many credits they have left this period (one balance for character animations, AI designs and logo animations). Returns the account email, the plan name, the credits left, what each thing costs and when the period ends. Logo animation concepts don't use any of it. Read-only. Requires a linked Charmotion account.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Use this to check one of the user's Charmotion characters by set_id: progress while it builds, which animations it has, and once it is ready: download links (valid 10 minutes) for every file (the Rive file, code, README, posters and any videos exported so far), the status of video exports, and ai_readme, integration notes for a coding assistant (which file to use per platform, mood numbers, trigger names, code samples). When the user wants the set in their app or site, follow or hand over ai_readme. Read-only. Requires a linked Charmotion account.
| Argument | Type | Description |
|---|---|---|
| set_id* | string | set_id from create_character_set or list_character_sets. |
{
"type": "object",
"required": [
"set_id"
],
"properties": {
"set_id": {
"type": "string",
"description": "set_id from create_character_set or list_character_sets."
}
},
"additionalProperties": false
}Use this to check an AI character or logo design by design_id: its status and, when ready, a link to the image (valid 10 minutes) and how to animate it. Read-only. Requires a linked Charmotion account.
| Argument | Type | Description |
|---|---|---|
| design_id* | string | design_id from design_character, design_logo or list_designs. |
{
"type": "object",
"required": [
"design_id"
],
"properties": {
"design_id": {
"type": "string",
"description": "design_id from design_character, design_logo or list_designs."
}
},
"additionalProperties": false
}Use this to check a logo animation by motion_id: concepts, build progress, and when ready the live preview link, copy-paste code per platform, requirements, download links (valid 10 minutes) and ai_readme, integration notes for a coding assistant (which code to use per platform, install and paste steps, how it behaves, reduced motion, checks). When the user wants the animation in their app or site, follow or hand over ai_readme. Read-only. Requires a linked Charmotion account.
| Argument | Type | Description |
|---|---|---|
| motion_id* | string | The motion_id returned by start_motion. |
{
"type": "object",
"required": [
"motion_id"
],
"properties": {
"motion_id": {
"type": "string",
"description": "The motion_id returned by start_motion."
}
},
"additionalProperties": false
}Use this when the user asks about their Charmotion characters (recent first, up to 10, the newest version of each) or needs a set_id. Read-only. Requires a linked Charmotion account.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Use this when the user asks about the characters or logos Charmotion designed for them, or needs a design_id to animate one. Lists ready designs, newest first (up to 12), optionally only characters or only logos. Read-only. Requires a linked Charmotion account.
| Argument | Type | Description |
|---|---|---|
| kind | string | Optional filter. |
{
"type": "object",
"properties": {
"kind": {
"enum": [
"character",
"logo"
],
"type": "string",
"description": "Optional filter."
}
},
"additionalProperties": false
}Use this when the user wants changes to a ready logo animation (e.g. slower, logo bigger, warmer colours). The builder continues from the current version. Each logo animation includes a number of refines that depends on the user's plan; failed or stopped refines don't count. Check progress with get_motion. Requires a linked Charmotion account.
| Argument | Type | Description |
|---|---|---|
| feedback* | string | What should change, in the user's words. |
| motion_id* | string | The motion_id returned by start_motion. |
{
"type": "object",
"required": [
"motion_id",
"feedback"
],
"properties": {
"feedback": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What should change, in the user's words."
},
"motion_id": {
"type": "string",
"description": "The motion_id returned by start_motion."
}
},
"additionalProperties": false
}Use this when the user wants another version of one of their AI designs (the app's Try again): makes a new design from the same answers as design_id. Uses 1 more credit, like the app (failed or refused attempts give it back). Check it with get_design. Requires a linked Charmotion account.
| Argument | Type | Description |
|---|---|---|
| design_id* | string | design_id from design_character, design_logo or list_designs. |
{
"type": "object",
"required": [
"design_id"
],
"properties": {
"design_id": {
"type": "string",
"description": "design_id from design_character, design_logo or list_designs."
}
},
"additionalProperties": false
}Use this when a signed-in user wants their logo animated: a website hero animation (interactive loop the user places on their site) or an app launch animation (plays once, ends on the logo). Pass exactly one of design_id (one of their ready AI logo designs, from design_logo, get_design or list_designs) or logo (an image they shared). Ask the same questions as the app: hero or launch, where it will be used (and the web stack for web), the background colour it sits on, and how it should feel. Charmotion's creative director proposes 3 concepts (takes up to a minute). Concepts are free and use nothing from the plan. Show the concepts and let the user pick one, then call build_motion. Nothing is built yet. Requires a linked Charmotion account.
| Argument | Type | Description |
|---|---|---|
| feel | array | Optional: how it should feel. A logo design's feel is used when left out. |
| goal* | string | hero = website hero animation (interactive loop); launch = app launch / splash animation that plays once. |
| logo | object | The logo (SVG, PNG, JPEG or WebP, up to 10 MB). Outside ChatGPT, set download_url to a public https link to the image and file_id to its file name. Leave out when using design_id. |
| brief | string | Optional: anything else about the feel or the motion, in the user's words. |
| design_id | string | A ready AI logo design of this account, instead of a logo image. Its flat background is removed and its brand name is used. |
| platforms* |
We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.
| array |
| The animations to make: launch (app intro, ends on idle), happy, wave, loading. idle is always added for free. Default: all of them. |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Short name for the character, e.g. 'Kiko'. Used for file names."
},
"image": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"download_url": {
"type": "string"
}
},
"description": "The character image (PNG, JPEG or WebP, at least 512 px, up to 10 MB). Outside ChatGPT, set download_url to a public https link to the image and file_id to its file name. Leave out when using design_id.",
"additionalProperties": true
},
"design_id": {
"type": "string",
"description": "A ready AI character design of this account (from design_character, get_design or list_designs), instead of an image."
},
"animations": {
"type": "array",
"items": {
"enum": [
"launch",
"idle",
"happy",
"wave",
"loading",
"thinking",
"sad",
"listening",
"talking",
"sleeping",
"attention"
],
"type": "string"
},
"maxItems": 11,
"minItems": 1,
"description": "The animations to make: launch (app intro, ends on idle), happy, wave, loading. idle is always added for free. Default: all of them."
}
},
"additionalProperties": false
}| array |
| Where it will be used. |
| web_stack | string | Optional, for platform web: the site's stack. |
| background | string | Optional: the page background (hero) or launch screen colour it sits on, as #rrggbb. |
| brand_name | string | Optional brand name (a logo design's brand is used when left out). |
{
"type": "object",
"required": [
"goal",
"platforms"
],
"properties": {
"feel": {
"type": "array",
"items": {
"enum": [
"premium",
"playful",
"minimal",
"bold",
"techy",
"elegant",
"friendly",
"calm",
"cinematic"
],
"type": "string"
},
"maxItems": 3,
"description": "Optional: how it should feel. A logo design's feel is used when left out.",
"uniqueItems": true
},
"goal": {
"enum": [
"hero",
"launch"
],
"type": "string",
"description": "hero = website hero animation (interactive loop); launch = app launch / splash animation that plays once."
},
"logo": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"download_url": {
"type": "string"
}
},
"description": "The logo (SVG, PNG, JPEG or WebP, up to 10 MB). Outside ChatGPT, set download_url to a public https link to the image and file_id to its file name. Leave out when using design_id.",
"additionalProperties": true
},
"brief": {
"type": "string",
"maxLength": 880,
"description": "Optional: anything else about the feel or the motion, in the user's words."
},
"design_id": {
"type": "string",
"description": "A ready AI logo design of this account, instead of a logo image. Its flat background is removed and its brand name is used."
},
"platforms": {
"type": "array",
"items": {
"enum": [
"web",
"ios",
"android",
"flutter",
"react_native",
"video"
],
"type": "string"
},
"maxItems": 6,
"minItems": 1,
"description": "Where it will be used."
},
"web_stack": {
"enum": [
"html",
"react",
"nextjs",
"webflow",
"framer",
"wordpress",
"shopify"
],
"type": "string",
"description": "Optional, for platform web: the site's stack."
},
"background": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$",
"description": "Optional: the page background (hero) or launch screen colour it sits on, as #rrggbb."
},
"brand_name": {
"type": "string",
"maxLength": 60,
"description": "Optional brand name (a logo design's brand is used when left out)."
}
},
"additionalProperties": false
}