Charmotion MCP server
Officialby charmotion
README.md
# Charmotion MCP server
[Charmotion](https://charmotion.app) animates your own logo or character without redrawing it. From one PNG, JPEG or WebP you get a Rive (`.riv`) file with a state machine, web, React and SwiftUI code, and on demand MP4, GIF, transparent WebM and MOV videos.
This repository documents the remote MCP server that lets an AI assistant do the same from a chat: design a character or a logo with AI, animate the character or the logo, export videos, and add the result to your app. The server is hosted: there is nothing to install or run.
```
https://charmotion.app/mcp
```
- Model Context Protocol over Streamable HTTP
- OAuth sign-in (dynamic client registration), no API key
- Guide search works without an account
Listed in the official MCP Registry as `app.charmotion/charmotion`.
Full docs: [charmotion.app/mcp-server](https://charmotion.app/mcp-server)
## Connect
**Claude (claude.ai, Claude Desktop)**
Open Settings, then Connectors, and choose Add custom connector. Name it Charmotion, paste `https://charmotion.app/mcp`, click Connect, sign in on charmotion.app and allow access.
**Claude Code**
```sh
claude mcp add --transport http charmotion https://charmotion.app/mcp
```
Then run `/mcp` inside Claude Code, pick charmotion and sign in.
**Cursor** (`~/.cursor/mcp.json`)
```json
{
"mcpServers": {
"charmotion": { "url": "https://charmotion.app/mcp" }
}
}
```
**VS Code with GitHub Copilot** (`.vscode/mcp.json`)
```json
{
"servers": {
"charmotion": { "type": "http", "url": "https://charmotion.app/mcp" }
}
}
```
**Codex CLI**
```sh
codex mcp add charmotion --url https://charmotion.app/mcp
codex mcp login charmotion
```
Any other MCP client that supports remote servers and OAuth sign-in can use the same URL.
## Tools
| Tool | What it does | Account |
|---|---|---|
| `find_animation_guide` | Searches Charmotion's free guides on Rive, Lottie, splash and loading animations, transparent video and adding animation to sites and apps. Returns up to three articles. | None |
| `design_character` | Designs an original character or mascot from a short description, archetype, look, personality and colours. | Yes |
| `design_logo` | Designs a logo for your own brand from its name, what it does, the logo type, feel and colours. | Yes |
| `retry_design` | Makes another version of a design from the same answers. | Yes |
| `get_design` / `list_designs` | A design's status and image; your ready designs. | Yes |
| `create_character_set` | Animates a character from an AI design or an image link, with the animations you pick (launch, happy, wave, loading; idle is always included). | Yes |
| `add_animations` | Adds more animations to a character you already made, keeping its look. | Yes |
| `get_character_set` / `list_character_sets` | Build progress, then download links for the Rive file, code and videos, plus integration notes for a coding assistant. | Yes |
| `export_videos` | Exports a character's videos: MP4 (1080x1080, 60 fps), the 9:16 launch MP4, transparent WebM and MOV, GIF. | Yes |
| `start_motion` | Suggests concepts for a logo animation: a website hero loop or an app launch animation. | Yes |
| `build_motion` / `get_motion` / `refine_motion` | Builds the chosen logo animation, shows its live preview, code per platform and downloads, and applies changes. | Yes |
| `get_account` | The connected account, its plan and the credits left this period. | Yes |
Guide search works without an account. Logo concepts and video exports use nothing. AI designs, character animations and logo animation builds use credits from your Charmotion plan (failed or stopped builds give them back), and the assistant asks before each one. Plans: [charmotion.app/pricing](https://charmotion.app/pricing).
## Things to ask
- Design a friendly cloud mascot for my weather app, then make its animation set.
- Animate my logo as a launch animation for my iOS app. It should feel calm and premium.
- Add my Charmotion character Puff to this React app.
- Export MP4 and transparent WebM videos of my newest set.
## Sharing your image
Most assistants can't pass an attached file to a tool yet, so share a public https link to the image: PNG, JPEG or WebP, at least 512 px, up to 10 MB (logos can also be SVG). Flat, front-facing art on a plain background works best. Photos of real people, existing characters and well-known brands aren't supported.
## Privacy
The assistant sends only what a tool needs: the image link, your design answers, the character name, your choices or a guide search. Charmotion never receives your chat. You can disconnect any assistant in Account, then Connected apps. See the [Privacy Policy](https://charmotion.app/privacy).
## By hand
```sh
curl -s https://charmotion.app/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_animation_guide","arguments":{"query":"rive vs lottie"}}}'
```
More in [examples/](examples).
---
Run by TRY2APP LTD, London. Not affiliated with Rive, Anthropic, OpenAI or Google. Contact: support@charmotion.app
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues