# LottieFiles MCP

Official LottieFiles MCP servers for AI agents. This is the plain-text version of
https://lottiefiles.com/mcp.

Both hosted servers use Streamable HTTP with OAuth. There is nothing to install and no API
key. The user approves access once in a browser with their LottieFiles account, so add the
server and then ask the user to complete sign-in.

## Which server to use

| Job                   | Server               | Runs    | Sign-in  | You get                                 |
| --------------------- | -------------------- | ------- | -------- | --------------------------------------- |
| Make new motion       | Creator MCP          | Hosted  | Required | Lottie, dotLottie, MP4, WebM, GIF       |
| Manage your workspace | LottieFiles MCP      | Hosted  | Required | Your projects and animations, organized |
| Draw in a Creator tab | Creator WebMCP       | Browser | Required | Editable Lottie in Creator              |
| Find animated icons   | Generative Icons MCP | Hosted  | None     | Icon files and code                     |

## Creator MCP

The motion engine for agents. The agent builds a real scene with layers, keyframes and
easing, previews its frames, and exports Lottie JSON, dotLottie, MP4, WebM or GIF. The
result can be saved to a LottieFiles workspace or opened in Lottie Creator.

Server URL:

```text
https://creator.mcp.lottiefiles.com/mcp
```

Claude Code:

```bash
claude mcp add --transport http --scope user creator-mcp https://creator.mcp.lottiefiles.com/mcp
```

Then run `/mcp` in Claude Code, select `creator-mcp` and sign in.

Codex:

```bash
codex mcp add creator-mcp --url https://creator.mcp.lottiefiles.com/mcp
```

Then complete the sign-in prompt.

Cursor, in `~/.cursor/mcp.json`, then sign in from MCP settings:

```json
{
  "mcpServers": {
    "creator-mcp": {
      "url": "https://creator.mcp.lottiefiles.com/mcp"
    }
  }
}
```

Claude: paste the server URL in Customize, Connectors, Add custom connector.

ChatGPT: add the server URL as a plugin. Steps:
https://docs.lottiefiles.com/en/creator-mcp/connect

Let your agent set it up. Paste this prompt into your agent:

```text
Add the Creator MCP server at https://creator.mcp.lottiefiles.com/mcp and help me sign in.
```

- Product page: https://lottiefiles.com/creator-mcp
- Documentation: https://docs.lottiefiles.com/en/creator-mcp.md
- Setup for every client: https://docs.lottiefiles.com/en/creator-mcp/connect.md

## LottieFiles MCP

Works with a LottieFiles account. The agent can search, organize and update workspaces,
projects and animations, and run the LottieFiles GraphQL API. It manages existing
animations. To make animations, use Creator MCP.

Server URL:

```text
https://mcp.lottiefiles.com/mcp
```

Claude Code:

```bash
claude mcp add --transport http lottiefiles https://mcp.lottiefiles.com/mcp
```

Then run `/mcp` in Claude Code and sign in.

Cursor, in `~/.cursor/mcp.json`, then sign in when prompted:

```json
{
  "mcpServers": {
    "lottiefiles": {
      "url": "https://mcp.lottiefiles.com/mcp"
    }
  }
}
```

VS Code, in `.vscode/mcp.json`, then sign in when prompted:

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

Claude: paste the server URL in Settings, Connectors, Add custom connector.

Other clients (Windsurf, Zed and more): add the server URL in the client's MCP settings.

Tools: `operations_list`, `schema_search`, `schema_details`, `graphql_execute`.

- Documentation: https://docs.lottiefiles.com/en/platform/mcp.md
- Setup for every client: https://docs.lottiefiles.com/en/platform/mcp/connect.md

## More ways to connect

- Creator WebMCP: a browser agent draws inside an open Lottie Creator tab. Runs in ChatGPT
  desktop, Chrome, Brave and Edge. Guide:
  https://lottiefiles.com/blog/working-with-lottie-animations/how-to-create-animations-with-ai-using-lottie-creator-webmcp

  Try this prompt in ChatGPT desktop or your browser agent:

  ```text
  Open LottieFiles Creator and use its site tools to create an animation of several bouncing balls, each with a different bounce height and timing
  ```

- Generative Icons MCP: search animated icons and fetch the files and code. Built on
  Creator MCP. https://generativeicons.com

## FAQ

### What is LottieFiles MCP?

LottieFiles MCP is the family of official servers that let AI agents make and manage
Lottie animations. Creator MCP is the motion engine. LottieFiles MCP works with your
account and workspace. Creator WebMCP draws inside a Lottie Creator tab.

### Creator MCP or LottieFiles MCP: which one do I need?

Use Creator MCP to make motion. Your agent builds a scene with real layers and keyframes
and exports it. Use LottieFiles MCP to search, organize and update the animations already
in your workspace. They do different jobs, and you can connect both.

### Which clients work?

Creator MCP works with Claude, ChatGPT, Claude Code, Codex, Cursor and VS Code, and with
other clients that support remote MCP servers with OAuth. LottieFiles MCP works with
Claude Code, Claude, Cursor, VS Code, Windsurf and Zed. Creator WebMCP runs in ChatGPT
desktop, Chrome, Brave and Edge.

### Do I need to install anything?

No. Creator MCP and LottieFiles MCP are hosted. Add the server URL to your client and sign
in with your LottieFiles account. There are no API keys to manage.

### What can I export?

Creator MCP exports Lottie JSON, dotLottie, MP4, WebM and animated GIF from the same
scene. You can also save the animation to your workspace or open it in Lottie Creator and
finish it by hand.

### Is my content used for training?

No. LottieFiles MCP servers are transport layers only. How your conversations are handled
is governed by the terms of your AI provider.