# posecode-mcp

Give an agent tools to create and validate .posecode movement descriptions, inspect issues, and share results. Useful for projects that work with programmable 3D motion.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 124
- Author: posecode-dev
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/posecode-dev/posecode
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/mcp/posecode-mcp

## What it does

posecode-mcp gives an agent tools for generating, checking, critiquing, and sharing movement descriptions. A `.posecode` file represents motion as text, with explicit joints, actions, angles, timed phases, and constraints. The result can be rendered in 3D and opened through a playground link.

The format keeps movement instructions readable and editable rather than hiding them in a trajectory. Parser warnings and fidelity checks help locate issues. Parsing and rendering do not require an AI model, though configured range-of-motion limits affect which angles are allowed.

To add the server to Claude Code, run `claude mcp add posecode-mcp -- npx -y posecode-mcp`. An alternative command sets `POSECODE_BASE_URL`; it requires a value for `<POSECODE_BASE_URL>`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `POSECODE_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env POSECODE_BASE_URL=<POSECODE_BASE_URL> --transport stdio posecode-mcp -- npx -y posecode-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add posecode-mcp --env POSECODE_BASE_URL=<POSECODE_BASE_URL> -- npx -y posecode-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "posecode-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "posecode-mcp"
            ],
            "env": {
                "POSECODE_BASE_URL": "<POSECODE_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "posecode-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "posecode-mcp"
            ],
            "env": {
                "POSECODE_BASE_URL": "<POSECODE_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e POSECODE_BASE_URL=<POSECODE_BASE_URL> posecode-mcp npx -y posecode-mcp
```
Replace <…> with your own values

## When to use it
- write a movement description in `.posecode`
- validate a movement and inspect parser warnings
- find fidelity issues in a movement
- edit a joint action or a motion phase
- prepare a movement for 3D rendering and sharing

## Example prompts
- Create a `.posecode` squat with separate lowering and rising phases.
- Check this `.posecode` file and explain any parser warnings.
- Change the knee flexion in the second phase and prepare the motion for rendering.

## Similar
- [Pascal 3D Editor](https://affpapa.org/en/nevibecode/mcp/pascal-3d-editor.md) — MCP server · ★ 25085
- [Unity-MCP](https://affpapa.org/en/nevibecode/mcp/unity-mcp.md) — MCP server · ★ 4523
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1348
- [Gearboy MCP Server](https://affpapa.org/en/nevibecode/mcp/gearboy-mcp-server.md) — MCP server · ★ 1219
- [ChiR24-unreal_mcp_server](https://affpapa.org/en/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP server · ★ 975
- [Nova3D](https://affpapa.org/en/nevibecode/mcp/nova3d.md) — MCP server · ★ 733

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md