
jasp402/hypercodemotion-mcp
Developer toolsConnect 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
- In Claude, open Settings → Connectors and choose Add custom connector.
- Name it
HyperCodeMotionand pastehttps://mcp.hypercodemotion.com/mcp. - In a chat, turn the connector on from the tools menu.
- Ask for an animation, or paste a prompt copied from HyperCodeMotion Studio («Crear con IA» → «Generar prompt»).
- Claude replies with two links:
- Open: opens the project directly in HyperCodeMotion Studio.
- Download: the
.hcmotionfile, 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_capabilitiesandvalidate_jsonstore nothing.create_hcmotionstores 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); aBLOB_READ_WRITE_TOKENalso works. CRON_SECRETso only Vercel Cron can call/api/cleanup.- Optional
PUBLIC_URL/STUDIO_URL(defaulthttps://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.
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add jasp402/hypercodemotion-mcp