MOTUS/MCP Server

AI-powered motion graphics and video generation engine. Describe your video in plain language, get back a rendered file.

Overview

MOTUS/MCP is a Model Context Protocol (MCP) server that provides a knowledge base and tooling for AI agents to create professional motion graphics and videos using GSAP + SVG. The server contains zero AI — it is a pure structured data layer that exposes editing rules, DOM structures, scene templates, transition patterns, color palettes, and animation patterns.

All access requires an API key. Buy one at motusmcp.tools/pricing or get free keys in Discord.

Features

• 10 MCP Tools: editing rules, DOM structure, scene templates, transitions, validation, color palette, animation patterns, scene boilerplate
• 7 Pre-built Scene Templates: graph-scene, anatomy-scene, phone-scroll-scene, car-anatomy-scene, globe-scene, quantum-scene, counter-scene
• 3 Transition Patterns: smash-cut, pan-smooth, jump-cut
• Scene Validation: Checks for common gotchas and missing elements
• Rate-limited API: Per-tool request costing with usage tracking

Authentication

Both the MCP server and the SDK require an API key.

Get an API key at motusmcp.tools/pricing or join Discord for free keys.

Installation

As an MCP Server (for AI clients)

MOTUSMCP_API_KEY=mk_your-api-key npx motusmcp

Or install globally:

npm install -g motusmcp
MOTUSMCP_API_KEY=mk_your-api-key motusmcp

As an SDK (for developers)

npm install motusmcp gsap

Usage

With Claude Desktop / Cursor / Windsurf / OpenCode

Add to your MCP settings:

{
  "mcpServers": {
    "motusmcp": {
      "command": "npx",
      "args": ["motusmcp"],
      "env": {
        "MOTUSMCP_API_KEY": "mk_your-api-key"
      }
    }
  }
}

With the SDK

import { createMotusMCP, Renderer } from 'motusmcp';

const mcp = createMotusMCP({
  apiKey: 'mk_your-api-key',
});

const rules = await mcp.getEditingRules();
const templates = await mcp.listSceneTemplates();
const palette = await mcp.getColorPalette();

// Build and render video
const renderer = new Renderer({
  container: '#video-container',
  width: 1920,
  height: 1080,
  fps: 60,
});

renderer
  .addScene({ id: 'scene-1', html: '<div>...</div>', duration: 5 })
  .addTransition({ type: 'smash-cut' });

await renderer.build();
await renderer.downloadVideo('my-video.webm');

API Key

Get an API key at motusmcp.tools/pricing or join Discord for free keys.

Tools

| Tool | Description | Cost | |------|-------------|------| | get_editing_rules | Core editing rules and style guide | 5 requests | | get_dom_structure | HTML structure, SVG filters, CSS | 25 requests | | get_scene_template | Pre-built scene template | 25 requests | | list_scene_templates | List all templates | 1 request | | get_transition_pattern | Transition pattern | 15 requests | | list_transitions | List all transitions | 1 request | | validate_scene | Validate scene HTML | 3 requests | | get_color_palette | Official color palette | 1 request | | get_animation_patterns | GSAP animation patterns | 5 requests | | get_scene_boilerplate | HTML boilerplate for new scene | 5 requests |

License

MIT