# LottieFiles MCP
Connect AI assistants to LottieFiles with the hosted MCP server — search your workspaces, manage animations, and run GraphQL with natural language.

To let an AI assistant work with your LottieFiles account, connect it to the LottieFiles MCP server. It's a remote, hosted [Model Context Protocol](https://modelcontextprotocol.io/) server — you don't install anything or manage API keys. Point your client at the endpoint, sign in with your LottieFiles account, and your assistant can search, organize, and update your workspaces, projects, and animations.

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

## What You Can Do

- **Explore your workspace** — "List the projects in my workspace and the animations in each."
- **Find and organize animations** — "Find every animation tagged 'onboarding' and summarize them."
- **Make changes conversationally** — "Rename the draft animations in Project X to match our naming convention."
- **Build against the GraphQL API** — the server exposes the full LottieFiles GraphQL schema, so your assistant can discover operations and draft working queries for your own integrations.

## Quickstart

<Steps>
  <Step title="Add the server to your client">
    For Claude Code, run:

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

    Using a different client? See [Connect Your Client](/en/platform/mcp/connect) for Claude Desktop, Cursor, VS Code, Windsurf, Zed, and more.
  </Step>

  <Step title="Sign in with LottieFiles">
    On the first request, your client opens a browser window to authorize with your LottieFiles account. Approve the consent screen and you're connected.
  </Step>

  <Step title="Start prompting">
    Ask your assistant something like _"What's in my LottieFiles workspace?"_ — it discovers the right operations and runs them for you.
  </Step>
</Steps>

## How It Works

Instead of exposing hundreds of narrow tools, the server provides a compact **GraphQL workbench** — four tools your assistant chains together:

1. [`operations_list`](/en/platform/mcp/tools#operations_list) — browse the available GraphQL operations
2. [`schema_search`](/en/platform/mcp/tools#schema_search) — search operations, types, and fields
3. [`schema_details`](/en/platform/mcp/tools#schema_details) — inspect one operation or type in full
4. [`graphql_execute`](/en/platform/mcp/tools#graphql_execute) — run the query or mutation

Your assistant discovers what's possible, drafts a precise GraphQL document, and executes it — the same workflow an engineer follows, automated. See [Tools and Workflow](/en/platform/mcp/tools) for the full reference.

<Callout type="info" title="Looking for the Creator MCP?">
  The [Lottie Creator MCP](/en/creator/13_ai-tools/lottie-creator-mcp) is a separate, local MCP server that builds and
  edits animations inside Lottie Creator. The LottieFiles MCP works with your account and workspace data. [Compare the
  two](/en/platform#which-mcp-do-i-need).
</Callout>

## Next Steps

<Grid columns={{ sm: 1, md: 3 }} gap="lg">
  <Card title="Connect Your Client" icon="ph:cloud-arrow-up-duotone" href="/en/platform/mcp/connect" variant="interactive">
    Set up Claude, Cursor, VS Code, Windsurf, Zed, and other MCP clients.
  </Card>

  <Card title="Tools and Workflow" icon="ph:code-duotone" href="/en/platform/mcp/tools" variant="interactive">
    Learn the four workbench tools, resources, prompts, and example usage.
  </Card>

  <Card title="Auth, Security, and FAQ" icon="ph:shield-check-duotone" href="/en/platform/mcp/security" variant="interactive">
    Understand OAuth sign-in, revoke access, and troubleshoot issues.
  </Card>
</Grid>