Posecode MCP
The Posecode MCP server teaches a model a text language for movement, checks joint angles and returns a link to a 3D animation.
- 131 ★ on the repository
- Last commit
- Apache-2.0
Minimal access
Why this level
- The server parses text and builds a link, and it reads no files and runs no commands.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/posecode-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The server parses text and builds a link, and it reads no files and runs no commands.
This is third-party code. Review the repository files before installing.
What it does
Posecode describes human movement in text: `.posecode` documents set joints, actions, angles, duration and repeats. The parser, validation and Three.js renderer run without an AI model and give the same result for the same input. The `posecode-mcp` MCP server gives an agent three tools. `posecode_authoring_guide` returns a guide to the grammar, joints and actions. `validate_posecode` parses a document and reports errors and values outside the configured range-of-motion limits. `render_posecode` validates a document and returns a permalink that plays the movement in the Posecode playground. The server itself draws nothing: the 3D maths runs in the browser of whoever opens the link.
Who it is for. Web product developers and animators who want a model to generate and check exercises and poses.
Good fit when
- A fitness app takes exercises from a model and checks joint angles against limits.
- An animator needs a readable, editable draft of a movement instead of a neural trajectory.
- An agent changes a single parameter, such as knee flexion depth in the second phase.
- A link to a finished movement goes to a colleague with no editor installed.
Not a fit when
- You need a finished clip with lighting, textures and facial animation: the language describes skeleton kinematics.
- A closed commercial product cannot accept AGPL terms and does not buy a separate licence.
- The model must render movement with no outside links: rendering happens in the Posecode playground.
Example request
Describe a squat in the Posecode language, check the range-of-motion limits and give me an animation link.MCP
- Transport
- stdio
- Authentication
- not required
Environment variables
POSECODE_BASE_URL- Playground address that links point to. Defaults to the hosted playground.
Limitations
The server checks syntax and range-of-motion limits, but the movement itself is shown only by a link opened in a browser. The playground address defaults to the hosted version and is changed with the `POSECODE_BASE_URL` variable. The `posecode-mcp` package is distributed under AGPL-3.0-only, and a separate commercial licence exists for closed products. The parser and the language sit in other packages of the monorepo with their own terms. The package version at the time of review is 0.6.0, so the interface may change.
How to disable. Remove the posecode entry from the MCP client configuration. The server leaves nothing else on the machine.
FAQ
How do I run posecode-mcp?
Run `npx -y posecode-mcp@latest` or set this command in the `mcpServers` block of your MCP client configuration.
What does render_posecode return?
A permanent link to the Posecode playground. The document is validated first, then a person opens the link and watches the animation in a browser.
How do I change the playground address?
Set the `POSECODE_BASE_URL` environment variable. Without it the links point to the hosted playground.
Is a model needed to validate a document?
No. The parser and validation run without an AI model, which is needed only to draft the movement.
What does validate_posecode check?
The document syntax and angles that fall outside the configured range-of-motion limits. The server returns such values as clamps to the document.
Discussion
No questions or reviews yet.
Related
MCP serversA remote MCP server with 40 tools: a 3D model from text or a photo, rigging, animation, retexturing and GLB checks
An MCP server that turns phone video into a 3D scene and lets an agent measure it, plan paths and export data for robots
Blender MCP
MCP for Blender
An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender
A small Node.js Blender MCP: a stdio server sends Python code to Blender over TCP, reads the scene and pulls Poly Haven assets
Blender MCP: an agent in Cursor, Cline, Windsurf or Claude Desktop builds and edits 3D scenes in Blender from a description; the server installs with uvx
MCP server of the 37Studio video studio: an agent manages brands, makes videos, posts to social networks and answers messages.
README in short
The authors compare Posecode to Mermaid for movement. A readable source can be kept in git, shown on the web with a one-script embed and inspected piece by piece, which diffusion-model trajectories do not offer.