Account and access
MCP & API accessBeta
The Director works through the Vexel MCP server, and the same tools are open to your own MCP clients, such as Claude Code or Cursor. Everything the Director can do, a tool can do.
AvailabilityLink to Availability
MCP and API access is part of the Pro and Max plans. Tool calls that generate are quoted and billed like the same action in the app; your own client’s model tokens are paid by you, not in credits.
Connect Claude CodeLink to Connect Claude Code
The endpoint is /api/mcp on your Vexel address, over Streamable HTTP. Add it to Claude Code:
claude mcp add --transport http vexel https://<your Vexel address>/api/mcpAuthenticate
In Claude Code run
/mcp, choose vexel and Authenticate. Your browser opens.Sign in and allow
Sign in to Vexel if needed. The consent page shows the client, your account and what it may do; choose Allow access.
Check the connection
Back in the terminal,
claude mcp listshows vexel as connected.
Other MCP clients that speak Streamable HTTP connect to the same URL.
What a client can doLink to What a client can do
| Scope | Allows |
|---|---|
| project:read | Read projects, scripts, assets, shots, timelines, renders and exports |
| project:write | Create and edit projects, shots, assets, timelines; queue renders and exports |
| generate | Start paid jobs: shots, pencil sketches, reference images |
| billing:read | Read your credit balance and history |
A client connected by signing in gets project read and write and billing read, but not generate: it cannot spend credits yet. A tool outside a client’s scopes is hidden from its tool list.
The toolsLink to The tools
Tools are named vexel.<module>.<verb>, and every result includes a one-line summary. Tools for Beta features are listed only when the feature is on for your studio.
| Family | Examples |
|---|---|
| Projects and credits | vexel.project.create, vexel.project.list, vexel.credits.balance |
| Script | vexel.script.write, vexel.script.revise, vexel.script.toScenes |
| Assets | vexel.assets.propose, vexel.assets.create, vexel.assets.addRef |
| Storyboard | vexel.shots.generateFromScenes, vexel.shots.upsert, vexel.shots.generate, vexel.shots.selectTake |
| Prompts | vexel.prompt.parse, vexel.prompt.lint, vexel.prompt.compile |
| Models | vexel.models.list |
| Previz | vexel.previz.pencil, vexel.previz.animatic |
| Song | vexel.song.map.get, vexel.song.suggestCuts, vexel.song.alignShots |
| Timeline | vexel.timeline.get, vexel.timeline.apply, vexel.timeline.assembleFromBoard |
| Render and export | vexel.render.enqueue, vexel.export.nle, vexel.export.url |
| Review | vexel.review.createLink, vexel.review.listComments |
| Checkpoints and skills | vexel.checkpoint.propose, vexel.checkpoint.status, vexel.skills.search |
Errors come back as code, message, recoverable and suggestions, so an agent can retry or change course.
Things to tryLink to Things to try
- "Create a Vexel commercial project called Aurora."
- "List the video models."
- "Write a 4 second shot prompt for a steaming cup, lint it and save it as shot 1."
- "Compile shot 1 for Seedance 2.5."