MCP server

Give Claude, Cursor, Codex or any MCP client a motion decompiler. The server runs on your machine, calls the API with your key, and cannot spend a credit above your ceilings without you typing y.

MCP versus API

Two different things that people mix up.

The API

A versioned HTTP contract. You (or the CLI) call it directly with your key. Good for scripts and your own tools.

API key

The MCP server

A small program (@mvoom/mcp) that speaks the Model Context Protocol. Your agent connects to it and gets four tools; the server talks to the API for it. Good for Claude, Cursor, Codex, Windsurf.

@mvoom/mcp

The four tools

mvoom_discover_page

Lists what moves on a page and names the pieces. No side effects, no quota.

free

mvoom_inspect_component

Measures one piece and returns the recipe and the signed quote. Counts as a read of that page.

a read

mvoom_get_wallet_balance

Lets the agent ask before it tries.

free

mvoom_purchase_and_inject

Buys the component and writes the files into the paired project. Below your ceilings it goes through; above them it stops and asks for y in your terminal.

credits

Install

Any MCP client over stdio. The binary is mvoom-mcp.

Claude Code

npm i -g @mvoom/mcp @mvoom/cli
mvoom auth                      # the key from Settings → API key
claude mcp add mvoom -- mvoom-mcp

Claude Desktop, Cursor, Codex

{ "mcpServers": { "mvoom": { "command": "mvoom-mcp" } } }

Docs

The full reference, with what each tool returns.

MCP docs

Safety

Spending ceilings

Per purchase and per month, in credits, enforced on our side. Set both to zero and nothing is bought without you.

Ceilings

Local adapter

mvoom_adapt_locally can run a model on your machine to adapt a piece. Off by default; it never signs anything.

off by default