# Lumorig

> Lumorig is a freemium MCP server for design and media. Create, animate and export mascots and logos from a coding agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $12 a month
- **Platforms:** API, CLI
- **Website:** https://lumorig.com/docs/guides/mcp
- **MCP Registry name:** com.lumorig/mascots
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

Lumorig runs its mascot studio as a remote server with OAuth sign-in: you add the URL, approve it once in the browser and pick the workspace the client may act in. A local stdio build (`npx -y @lumorig/mcp`, with a `LUMORIG_API_KEY`) adds file parameters such as `image_path`, `video_path` and `save_to`, so an agent can rebuild a logo from your repo and write the Lottie file next to your code. The hosted version cannot touch your disk and returns download URLs instead.

The 25 tools cover the whole chain. A character is designed from a prompt or rebuilt from an image, edited in words, recoloured, given props and looks, then animated with one of 31 presets, a described motion or a reference video. Exports include Lottie, dotLottie, animated SVG, GIF, MP4, WebM and sprite sheets, and `get_embed_code` returns a snippet for HTML, React or Lottie. Read-only tools are annotated so clients can run them without asking.

Actions that generate new art spend credits, and each shows its price first. Presets, recolours, props and canvases are free.

## Features

- **Design from prompt or image:** Create a mascot from a text prompt or rebuild an uploaded image as a rig, in styles from flat to kawaii.
- **Preset and custom motion:** Animate with built-in presets, a motion described in words, or one copied from a reference video.
- **Many export formats:** Render Lottie, animated SVG, GIF, MP4, WebM, sprites and still images up to 2048 px.
- **Embed snippets:** Get ready-made HTML, React or Lottie embed code with hover or click triggers.
- **Logo animation:** Add a tagline under a logo or generate a short cinematic intro that ends on the logo.
- **Browser sign-in, no key:** The hosted server uses OAuth 2.1 with PKCE; tokens can be revoked under Connected apps.

## Good for

- Generate a mascot for a product from inside Claude Code or Cursor
- Export a Lottie animation straight into a project's public folder
- Animate an existing logo with a short reveal intro
- Get an embeddable animated character for a website or chatbot UI
- Ask for mascot concepts based on a company's website

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mascots https://lumorig.com/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://lumorig.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mascots": {
      "url": "https://lumorig.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mascots": {
      "type": "http",
      "url": "https://lumorig.com/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mascots": {
      "serverUrl": "https://lumorig.com/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mascots": {
      "type": "http",
      "url": "https://lumorig.com/api/mcp"
    }
  }
}
```

## Tools

- `create_mascot`: Design a new mascot from a prompt or rebuild an image as a rig
- `list_mascots`: List the mascots in the workspace with status and animation count
- `get_mascot`: Return a mascot's name, status, palette, parts, states, animations and a preview
- `edit_mascot`: Change a mascot's design from a text instruction, optionally as a new variant
- `recolor_mascot`: Change the palette by token name
- `set_logo_tagline`: Set or change a tagline or web address under a logo
- `make_cinematic_intro`: Generate a roughly 5 second 1080p intro that resolves into a logo
- `switch_look`: Make one of the mascot's looks current
- `set_props`: Show or hide props by id or name
- `add_gear`: Give the mascot a ready-made prop with its motion
- `turn_mascot`: Turn the mascot to a slight side view or back to front
- `add_prop`: Draw something the mascot holds or wears as its own part
- `animate_mascot`: Animate with a preset, a described motion or a reference video
- `export_mascot`: Render an animation or still in a chosen format
- `list_clips`: List the clips in a clip mascot's motion library
- `create_clip`: Create a video clip of an uploaded mascot's art from a motion or prompt
- `set_clip_kind`: Mark a clip as a one-shot reaction or a looping state
- `export_clip`: Render a clip as a file
- `get_embed_code`: Return an embed snippet for HTML, React or Lottie
- `create_canvas`: Create an interactive state machine from a template or custom graph
- `analyze_website`: Read a site and propose three mascot concepts
- `create_scene`: Generate an illustrated vector scene around the mascot
- `suggest_animations`: Suggest signature motions for the character
- `wait_for_job`: Wait for a long-running job and return its result
- `list_jobs`: List the 20 most recent jobs with type, status and credits

## FAQ

### Do I need an API key?

Not for the hosted server: you sign in through the browser once. The local stdio server needs LUMORIG_API_KEY.

### Can the hosted server save files to my machine?

No. It cannot read or write local files, so you pass image or video URLs and exports come back as download URLs.

### Which actions cost credits?

Creating new art, such as a character, a custom motion, a scene or a chat edit, costs credits. Presets, recolours, props and canvases are free.

### What does it cost?

Free gives 100 credits once; Maker is $12 a month with 1,200 credits and Studio is $36 a month with 3,600. One-time credit packs start at $7 for 500.

### Is Lumorig free?

Lumorig has a free plan, with paid plans for more usage or features. Paid plans start at $12 a month.

### How do I add Lumorig to Claude Code?

Run this command in your terminal: claude mcp add --transport http mascots https://lumorig.com/api/mcp

### What are the best alternatives to Lumorig?

The closest alternatives to Lumorig are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/lumorig
