JH

jasp402/hypercodemotion-mcp

Developer tools
0 stars Quality 58 Trend 20Apache-2.0

Connect Claude to HyperCodeMotion, an editor for data-driven motion graphics. Claude designs the animation; this connector checks it and turns it into a .

Overview

Connect Claude to HyperCodeMotion, an editor for data-driven motion graphics. Claude designs the animation; this connector checks it and turns it into a .hcmotion project you open in HyperCodeMotion Studio, where you change texts, colors, timing and order yourself instead of asking the AI to regenerate everything. - https://mcp.hypercodemotion.com/mcp (remote, streamable HTTP) - none. The service has no accounts and reads no data from your Claude account. - app.hypercodemotion.com 1. In Claude, open and choose . 2. Name it HyperCodeMotion and paste https://mcp.hypercodemotion.com/mcp. 3. In a chat, turn the connector on from the tools menu. 4. Ask for an animation, or paste a prompt copied from HyperCodeMotion Studio («Crear con IA» → «Generar prompt»). 5. Claude replies with two links: - : opens the project directly in HyperCodeMotion Studio. - : the .hcmotion file, which you can also open from the Studio home screen («Cargar proyecto»). Both links expire after they are created.

README

HyperCodeMotion MCP

Connect Claude to HyperCodeMotion, an editor for data-driven motion graphics. Claude designs the animation; this connector checks it and turns it into a .hcmotion project you open in HyperCodeMotion Studio, where you change texts, colors, timing and order yourself instead of asking the AI to regenerate everything.

  • MCP endpoint: https://mcp.hypercodemotion.com/mcp (remote, streamable HTTP)
  • Authentication: none. The service has no accounts and reads no data from your Claude account.
  • Studio: app.hypercodemotion.com

Use it in Claude

  1. In Claude, open Settings → Connectors and choose Add custom connector.
  2. Name it HyperCodeMotion and paste https://mcp.hypercodemotion.com/mcp.
  3. In a chat, turn the connector on from the tools menu.
  4. Ask for an animation, or paste a prompt copied from HyperCodeMotion Studio («Crear con IA» → «Generar prompt»).
  5. Claude replies with two links:
    • Open: opens the project directly in HyperCodeMotion Studio.
    • Download: the .hcmotion file, which you can also open from the Studio home screen («Cargar proyecto»).

Both links expire 24 hours after they are created. Save the project from Studio (Archivo → Guardar proyecto) to keep it.

Example prompts

  • “Create a 15-second vertical launch video for Nimbus, a note-taking app with AI, and give me the HyperCodeMotion project.”
  • “Make a 10-second explainer with three steps for brewing pour-over coffee, 16:9, and package it for HyperCodeMotion.”
  • “Which layer types and effects does HyperCodeMotion support?”

Tools

Tool What it does Annotations
get_capabilities Lists the formats, layer types, layer properties and effect presets that Studio supports, with the Studio revision they come from. read-only
create_hcmotion Validates a finished composition and packages it as a .hcmotion file. Invalid input returns created: false with the errors to fix and stores nothing. Valid input returns open and download links (24 h). write (creates a temporary file), not destructive
validate_json Checks a composition, design or improvement patch and returns errors and warnings. Preliminary: it does not prove a correct render. read-only

The connector does not render video, generate images, audio or video with AI models, or access anything outside the request it receives.

Data and privacy

  • get_capabilities and validate_json store nothing.
  • create_hcmotion stores the generated file in a private Vercel Blob store. Anyone with the link can download it until it expires after 24 hours; a daily job deletes expired files (at most about 48 hours after creation).
  • No accounts, cookies, tracking or AI training on your content.

Full details: Privacy Policy · Terms of Service · Support

Support

Email [email protected] (also [email protected]) or open a GitHub issue. Issues are public: never post passwords, tokens or confidential project content.

For developers

Protocol

The server speaks JSON-RPC 2.0 over HTTP POST (initialize, ping, tools/list, tools/call). A GET on the endpoint returns 405 with a short explanation, which is expected. Request bodies are limited to 4 MB.

.hcmotion layout

Offset Size Content
0 3 HCM (ASCII)
3 1 format version (1)
4 1 flags (bit 0: gzip)
5 3 reserved (0)
8 4 JSON size, uncompressed (u32 LE)
12 4 data size (u32 LE)
16 32 SHA-256 of the data
48 n composition JSON, gzip

It is not encrypted: the SHA-256 only detects truncated or edited files. Studio implements the same layout in packages/core/src/hcmotion.ts.

Files are served at https://mcp.hypercodemotion.com/d//.hcmotion. After 24 hours the link returns 410.

Deployment settings

  • A private Blob store connected to the Vercel project. It authenticates through OIDC (BLOB_STORE_ID + the project’s OIDC token); a BLOB_READ_WRITE_TOKEN also works.
  • CRON_SECRET so only Vercel Cron can call /api/cleanup.
  • Optional PUBLIC_URL / STUDIO_URL (default https://mcp.hypercodemotion.com / https://app.hypercodemotion.com).

Testing

npm test          # unit and integration tests
npm run test:live # smoke test against production

GitHub Actions runs both. Neither guarantees full Studio rendering compatibility.

Capabilities snapshot

The catalog is derived from Studio source files (packages/core/src/schema.ts, packages/core/src/presets.ts) and must be reviewed when Studio changes.

HyperCodeMotion Creative Skill

The repository also contains the HyperCodeMotion Agent Skill, which guides AI assistants from brief to art direction, scenes, editable JSON and the .hcmotion handoff. It is distributed separately from the connector and does not activate just because the connector is connected.

License

Source code: Apache License 2.0. The hosted service is subject to the Terms of Service. HyperCodeMotion names and logos are not licensed by the software license.

View this README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add jasp402/hypercodemotion-mcp