Skip to main content
Glama

An agent in any project can find an effect, read how it works, and add it correctly: the embed for plain sites, Webflow, Framer and WordPress, or the source and mount() for bundled apps, with the real param names and ranges.

Add it

Claude Code

claude mcp add --transport http vanilla-motion https://mcp.vanilla-motion.com/mcp

Claude, ChatGPT: add a custom connector with the URL https://mcp.vanilla-motion.com/mcp.

Cursor, VS Code and other MCP clients

{
  "mcpServers": {
    "vanilla-motion": {
      "url": "https://mcp.vanilla-motion.com/mcp"
    }
  }
}

Then ask for what you want, e.g. "add a hover effect to the logo" or "a slideshow transition with a ripple".

Related MCP server: tele-ux-ui-motion-skill-mcp

Tools

Tool

What it returns

search_effects

Compact hits by words, tags or tech, with matching case-study passages on the top 3

get_effect

Params (data-* attribute, default, range, help), embed snippet, install commands, mount() usage, links

get_skill

The effect's skill.md: code reference written for agents

get_case_study

The effect's case study as Markdown

list_tags

The tag and tech vocabulary, grouped by category

Prompt: add_effect ("a hover effect for the logo") runs search_effects → get_effect → get_skill and writes the integration.

Prefer the terminal? npx vanilla-motion add <slug> copies an effect's source into your project.

How it works

Built from perxel-mcp-kit (kit docs: KIT-README.md, the checklist: STANDARD.md; kit/ is never edited here, updates come from pnpm kit:update). Everything the MCP knows comes from https://vanilla-motion.com/content.json, which the site writes on every build (scripts/build-content.mjs in perxel/vanilla-motion, plan 003). The Worker re-checks it about every 10 minutes with If-None-Match, so a site deploy reaches the MCP with no redeploy here. get_skill and get_case_study fetch the per-effect Markdown from the site and cache it the same way. Draft and unlisted effects never reach content.json.

  • Worker vm-mcp on mcp.vanilla-motion.com: /mcp, / (docs), /health, /dash (Access-protected).

  • src/content.ts: the zod schema of content.json; src/fixtures/content.json is a copy of a real one for tests (refresh it from the site's dist/content.json when the shape changes).

  • src/tools/, src/prompts.ts, mcp.config.ts, evals/questions.md.

Development

Command

pnpm dev

local Worker on :8788 + MCP Inspector on :8002

pnpm typecheck && pnpm test

types and tests

pnpm eval --url http://localhost:8788/mcp

run the eval questions against a server

pnpm setup:cloudflare

owner only; see KIT-README.md → Deploy

Pushes to main deploy through .github/workflows/deploy.yml (Markdown-only pushes are skipped).

License

PolyForm Shield 1.0.0 © Perxel

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI assistants with comprehensive access to Motion.dev animation library documentation and code generation tools. Enables LLMs to generate Motion animations for React, JavaScript, and Vue with proper documentation backing and framework conversion capabilities.
      14
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to browse, search, and read a curated library of 198 UI/UX and animation design skills across 17 categories, distilled from 10 open-source projects, with a progressive 5-step workflow for guidance.
      5
      665 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Gives AI coding assistants live access to the Hyperiux Vault catalog of React and Next.js animation effects. Search effects, inspect dependencies and installation instructions, and retrieve source for free effects.
      3
      111
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Gives coding agents a curated, reviewable library of landing pages, hero sections, image prompts, motion-video recipes, logo and pitch-deck recipes, fonts and motion backgrounds that they can search, inspect and fetch, then rebuild locally from code. Searches and reference inspection are uncounted, while template, UI and asset fetches share a daily free limit under OAuth sign-in with no API key.
      MIT