lumorig/lumorig-mcp

Lumorig MCP server and agent skill

Create, animate and export brand mascots from your coding agent. Describe a new mascot or bring the one you already have, then ship it as Lottie, animated SVG, transparent clips or a live web embed.

This repo holds the setup for the hosted MCP server, an agent skill that teaches your agent how to use Lumorig, and small examples. The server runs at https://lumorig.com/api/mcp, so there is nothing to build or host.

Install

Claude Code plugin (server and skill)

/plugin marketplace add lumorig/lumorig-mcp
/plugin install lumorig@lumorig

Claude Code (server only)

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

Then run /mcp, choose lumorig and authenticate. Your browser opens once.

Cursor

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

Cursor shows "Needs login" next to it. Click it, then allow access.

Claude Desktop and claude.ai

Go to Settings → Connectors → Add custom connector, name it Lumorig and use the URL https://lumorig.com/api/mcp.

The skill on its own

npx skills add lumorig/lumorig-mcp

Or copy skills/lumorig into your agent's skills folder.

With an API key

For servers, CI or a client that can't open a browser, create a key in the studio:

claude mcp add --transport http lumorig https://lumorig.com/api/mcp \
  --header "Authorization: Bearer lr_sk_…"

What to ask your agent

• "Create a friendly otter mascot for my budgeting app and put it in the empty state."
• "Rebuild the mascot at this image URL as a rigged vector, then give me the embed code."
• "Export the wave as Lottie."
• "Make a chatbot avatar that listens, thinks and talks, and wire it to my chat events."
• "Read our website and suggest three mascots that fit the brand."

Tools

Tool	What it does
create_mascot	Design a mascot from a description, or bring an existing mascot image
list_mascots, get_mascot	Browse your mascots, their looks, props and palette
edit_mascot	Change the design in plain words, or make a new look
recolor_mascot	Change palette colours instantly
switch_look	Make one of the mascot's looks current
set_props, add_prop	Show, hide or draw things the mascot holds or wears
animate_mascot	Add a preset motion or describe a custom one
export_mascot	Render to Lottie, animated SVG, GIF, MP4, WebM, WebP, APNG, sprite sheet, PNG, SVG, sticker or logo
list_clips, create_clip, set_clip_kind, export_clip	Motion clips that keep your exact uploaded art
get_embed_code	Code for the web component, React or Lottie
create_canvas	A state machine that drives the mascot from app events
create_scene	Place the mascot in an illustrated vector scene
analyze_website	Read a website and propose mascot concepts
suggest_animations	Motion ideas that fit the character and your product
wait_for_job, list_jobs	Follow long-running work

Full parameters are in the MCP guide.

Examples

• examples/web: the live player on a page, using a public gallery mascot
• examples/react-native: play exported Lottie files from your app's events
• examples/api: create a mascot with the REST API

Good to know

• Lumorig is a hosted service. Creating and editing use credits, and the free plan gets you started.
• The hosted server can't read or write files on your machine, so it takes image URLs and returns download URLs.
• There are also a CLI, a TypeScript SDK and a REST API.

Support

Open an issue here or email [email protected].

License

The contents of this repo are MIT licensed. Use of the Lumorig service is covered by its Terms.