Model Context Protocol

ViewMax MCP Server

Render video from inside Claude, Claude Code, Cursor or any other MCP client. Describe the shot in the chat you are already in, and get a finished clip back as a link.

Get an API key See the models

Once it is connected, this is the whole workflow:

“Make me a 5 second clip of a paper boat drifting down a rain gutter, macro lens, and drop the URL into the hero section.”

Your assistant books the render, waits for it, and hands back a public link. Credits come off the account the key belongs to.

Connect it

1. Create a key on your API keys page. It is shown once, so save it somewhere.
2. Add the server with the snippet for your client below.
3. Ask for a video.

Terminal

claude mcp add --transport http viewmax https://viewmaxstudio.net/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

What it can do

generate_video

Books a render from a prompt and returns a job id straight away. Takes model, length, resolution and frame shape.

get_video

Checks a job. Once it is done the result carries a public video URL that anyone can open.

get_credit_balance

How many credits are left on the key.

list_video_modelsno key needed

Every model with its exact limits and per-second credit price. No key needed.

Rendering runs in the background and takes two to four minutes depending on the model, so booking a clip and collecting it are two separate calls. Your assistant handles the waiting.

Or call the API directly

The MCP server is a thin layer over a plain HTTP API. Same key, same credits, no MCP client required.

Method	Path	What it does
POST	/api/v1/videos	Book a render. Answers 202 with a job id; never waits for the clip.
GET	/api/v1/videos/{id}	One job: its status, and its video URL once it is finished.
GET	/api/v1/credits	Credit balance.
GET	/api/v1/models	The model catalogue with prices. No key needed.

Example

# Book a render
curl -X POST https://viewmaxstudio.net/api/v1/videos \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a paper boat drifting down a rain gutter, macro lens","duration":"5"}'

# Poll it until status is "completed"
curl https://viewmaxstudio.net/api/v1/videos/JOB_ID \
  -H "x-api-key: YOUR_API_KEY"

Credits and limits

Renders spend the same credits the website does, at the same rates. The model catalogue lists every price.
A render that fails is refunded automatically. One you cannot afford is refused before it starts, so nothing is taken.
Each key allows 60 requests a minute. Polling a job every 15 seconds sits far inside that.
Finished clips are served from a public URL. Treat that link as shareable, because it is.