@saastemly/lottie-mcp

An MCP server that gives AI agents Lottie animations — a bundled, fully-offline starter set of common loaders & status animations (CC0), plus on-demand search of the entire public LottieFiles catalog (no API key).

Runs on plain Node ≥20 — no Bun, no Python, no build step.

Quick start (npx)

{
  "mcpServers": {
    "lottie": {
      "command": "npx",
      "args": ["-y", "@saastemly/lottie-mcp"]
    }
  }
}

Claude Code CLI: claude mcp add lottie -- npx -y @saastemly/lottie-mcp

The bundled starter set works with zero network. The *_online tools need internet (they hit the LottieFiles public API and cache downloads locally).

Tools

| Tool | What it's for | |---|---| | search_lottie | Keyword search over the bundled offline set (spinners, dots, bars, pulse, checkmark, cross). Instant, no network. | | list_lottie | Browse the bundled offline animations. | | get_lottie | Fetch a Lottie as JSON. slug → bundled (offline); id/url → a LottieFiles animation (downloaded + cached). out_path writes to a file (use with inline:false to keep responses small); color retints bundled animations. | | search_lottie_online | Search the full LottieFiles catalog (huge, current) via their API — no key. Returns id, name, preview GIF, and json_url. | | discover_lottie_online | Browse popular / featured / recent / curated LottieFiles feeds. |

Typical agent flow: search_lottie for a common loader (offline) → get_lottie({slug}). For anything else: search_lottie_online({query}) → get_lottie({id, out_path, inline:false}).

Bundled offline set (CC0)

Procedurally generated by this project, released CC0 / public domain — free for any use, no attribution. They share a single accent color (#4F46E5) that get_lottie's color param retints.

spinner · dots · bars · pulse · circular-dots · checkmark · cross

Using the JSON

get_lottie returns Lottie JSON plus ready-to-paste snippets for the lottie-player web component, lottie-react, and @lottiefiles/dotlottie-react.

Licensing

The package and the bundled animations are free to use commercially (MIT code / CC0 animations — see LICENSE). Animations fetched via the *_online tools come from LottieFiles under each animation's own license (typically the Lottie Simple License — free, commercial, no attribution). This package does not bundle or redistribute LottieFiles content; it fetches individual files on demand at your request.