> ## Documentation Index
> Fetch the complete documentation index at: https://mvnt.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP quickstart

> Generate dance motion from an AI assistant with the local mvnt-mcp package.

Generate dance motion from an AI assistant with the `mvnt-mcp` package. It runs locally and sends requests to the MVNT API. This setup requires Python 3.10 or later and an MCP client that supports a local stdio server, such as Cursor or Claude Desktop. For the REST API, see the [API quickstart](https://mvnt.studio/docs/guides/quickstart.md).

## Install

```bash theme={null}
pip install mvnt-mcp
```

Package page: [pypi.org/project/mvnt-mcp](https://pypi.org/project/mvnt-mcp/)

## Configure your client

Add an MCP server named **MVNT** to your client's local configuration:

```json theme={null}
{
  "mcpServers": {
    "MVNT": {
      "command": "python",
      "args": ["-m", "mvnt_mcp_compact_v1"],
      "env": {
        "MVNT_API_KEY": "mvnt_live_REPLACE_ME",
        "MVNT_API_BASE_URL": "https://api.mvnt.studio"
      }
    }
  }
}
```

Create an API key in [mvntSTUDIO](https://mvnt.studio/platform?tab=keys) and replace the placeholder. Keep the key in your local client configuration. Do not put it in prompts, commit it, or share screenshots of the configuration.

Restart the client and enable **MVNT**.

## Try your first request

Attach your audio file, then use a prompt like this:

```text theme={null}
Use MVNT to generate dance motion from this audio. Confirm the generation settings with me before starting. When the generation finishes, get the GLB motion file and an MP4 preview.
```

The package uses the same API key and mvntSTUDIO credit balance as the REST API. Output availability depends on your plan, and MP4 previews may take several minutes. See [plans and credits](https://mvnt.studio/credits) and the [output formats guide](https://mvnt.studio/docs/guides/outputs.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.