ViewMax MCP

io.github.bytevirtsPublished by GitHub account bytevirtsv1.0.1Updated Nov 3, 2026

Official ViewMax Studio MCP: AI video, image, music, speech and sound effects.

VerifiedStreamable HTTPWeb executableMedia & DesignAI & ML

Overview

ViewMax's hosted MCP server (viewmax.studio); optional API key; Streamable HTTP; 14 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Endpoint
viewmax.studio
Last checked

Installation

In SourceWeft

  1. Open ViewMax MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.bytevirts%2Fviewmax/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "viewmax": {
      "type": "http",
      "url": "https://viewmax.studio/api/mcp"
    }
  }
}

README

ViewMax MCP

Official remote MCP server for ViewMax Studio. Generate AI video, images, music, and speech from Claude, Cursor, ChatGPT (Codex), or any MCP client.

Official server. This is the official ViewMax Studio MCP server, published by bytevirts as io.github.bytevirts/viewmax in the official MCP Registry. The only official endpoint is https://viewmax.studio/api/mcp on the viewmax.studio domain.

Endpoint: https://viewmax.studio/api/mcp
Docs: https://viewmax.studio/docs/mcp

Connect

Claude (Web & Desktop)

Settings → Connectors → Add custom connector. Name it ViewMax, paste:

text
https://viewmax.studio/api/mcp

Click Connect and sign in with your ViewMax account. OAuth, no API key.

Claude Code

bash
claude mcp add --transport http viewmax https://viewmax.studio/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Add to ~/.cursor/mcp.json:

json
{  "mcpServers": {    "viewmax": {      "url": "https://viewmax.studio/api/mcp",      "headers": {        "Authorization": "Bearer YOUR_API_KEY"      }    }  }}

Codex (ChatGPT)

bash
export VIEWMAX_API_KEY=YOUR_API_KEYcodex mcp add viewmax --url https://viewmax.studio/api/mcp --bearer-token-env-var VIEWMAX_API_KEY

Cline

bash
cline mcp add viewmax https://viewmax.studio/api/mcp --transport http --yes

Or add to cline_mcp_settings.json:

json
{  "mcpServers": {    "viewmax": {      "url": "https://viewmax.studio/api/mcp",      "type": "streamableHttp",      "headers": {        "Authorization": "Bearer YOUR_API_KEY"      }    }  }}

Create an API key in ViewMax Settings → API Keys.

Agent skill

This repo ships an agent skill at skills/viewmax/SKILL.md. It covers when to use ViewMax, how to connect, all 14 tools, and workflows for consistent-character long videos, images, music, speech, task polling and credits. Install it with:

bash
npx skills add bytevirts/viewmax-mcp

Tools

ToolPurpose
list_video_models / get_video_modelDiscover video models and pricing
generate_videoCreate a video generation task
list_image_models / get_image_modelDiscover image models and pricing
generate_imageCreate an image generation task
list_music_modelsDiscover music models
generate_musicGenerate music (usually returns URLs immediately)
list_voicesList TTS voices
generate_speechText to speech
generate_sound_effectSound effect from a prompt
get_task / wait_for_taskPoll generation status
get_creditsRemaining account credits

Generation consumes ViewMax credits. Inspect a model before calling a generate_* tool.

License

Documentation in this repository is provided so agents and directories can discover the hosted ViewMax MCP server. The ViewMax product itself is a hosted service at viewmax.studio.

Source: README.md at commit 805d338

Tools

14

list_video_models

List available video models and their capabilities. Video generation consumes credits; use get_video_model for detailed pricing and the values used when options are omitted.

Takes no parameters.

get_video_model

Get full capabilities and credit pricing for one video model. Each mode lists durations, resolutions, aspect_ratios, audio_toggle, credits, and defaults: the duration, resolution and aspect_ratio that generate_video sends and bills when you omit them. max_prompt_length is present when the model limits prompt length. Generating a video with this model consumes credits.

Parametersmodelrequired

generate_video

Create a video generation task and return its task_id. mode defaults to image-to-video when image_urls are given, else video-to-video when video_urls are given, else text-to-video. Omitted duration, resolution and aspect_ratio use the mode's defaults from get_video_model and are billed at those values. Ultra ViewMax C1 generations cost 0 credits within the daily fair-use pool (also via REST API); otherwise this consumes credits from the authenticated ViewMax account. Call wait_for_task with the task_id until it finishes.

Parametersmodeaudiomodelrequiredpromptrequireddurationimage_urlsresolutionvideo_urlsaspect_ratioidempotency_keysource_video_duration_seconds

get_task

Get the current status, output URLs and cost_credits for one of the authenticated user's tasks (video, image, music, or audio). Failed and canceled tasks include error_code and error_message; their credits are refunded automatically.

Parameterstask_idrequired

wait_for_task

Wait up to timeout_seconds (1-50, default 45) for a task and return its latest status in the get_task shape. Some videos take several minutes: keep calling wait_for_task until status is success, failed, or canceled. Task results are persisted and never lost.

Parameterstask_idrequiredtimeout_seconds

get_credits

Get the authenticated account's remaining credits. Generation consumes credits.

Takes no parameters.

list_image_models

List available image models with their modes (text-to-image, image-to-image), aspect ratios, qualities, and credit labels. Image generation consumes credits.

Takes no parameters.

get_image_model

Get full capabilities and credit pricing for one image model. Generating an image with this model consumes credits.

Parametersmodelrequired

generate_image

Create an image generation task (text-to-image, or image-to-image when image_urls are provided). Pro/Ultra flagship models (GPT Image 2, GPT Image 2.5, Nano Banana 2, Grok Imagine) and Ultra ViewMax C1 cost 0 credits within the shared daily fair-use pool; otherwise this consumes credits. Call wait_for_task with the task_id for the result URLs.

Parametersmodelrequiredscenepromptrequiredqualityimage_urlsaspect_ratioidempotency_key

list_music_models

List available music models and their controls (duration, instrumental) and credit cost. Music costs 60 credits for tracks up to 60 seconds, then 1 credit per second.

Takes no parameters.

generate_music

Create an original music track from a text prompt. Costs 60 credits for tracks up to 60 seconds, then 1 credit per second (duration_seconds defaults to 60); plan allowances do not cover music. Setting style sends prompt as the song's lyrics, so do not also send lyrics; to describe a track, put the description in prompt and omit style. Music renders synchronously: the result usually returns immediately with output_urls.

Parametersstylelyricspromptrequiredinstrumentalidempotency_keyduration_seconds

list_voices

List available text-to-speech voices (id, name, gender, accent, language) and speech pricing: characters_per_credit and minimum_credits. A generation costs ceil(characters / 20) credits, minimum 1.

Takes no parameters.

generate_speech

Convert text to speech with a selected voice_id (see list_voices). Costs ceil(characters / 20) credits, minimum 1. Speech renders synchronously: the result usually returns immediately with output_urls.

Parameterstextrequiredspeedmodel_idvoice_idrequiredstabilityidempotency_keysimilarity_boost

generate_sound_effect

Generate a sound effect from a text prompt of at most 450 Unicode characters. Costs 5 credits. Renders synchronously: the result usually returns immediately with output_urls.

Parameterspromptrequiredidempotency_keyduration_secondsprompt_influence

Version history

2
  1. v1.0.1LatestNov 3, 2026
  2. v1.0.0Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.