Skip to content
Agentmart
Submit a tool

Runway ML

Runway ML MCP server: AI video, image, audio, voice generation, and task management

Connector by mindstone · GitHub account verified by the MCP Registry

IndexedLicense unknownLocal (stdio)★ 13
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/mindstone-mcp-server-runway

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Runway ML MCP server: AI video, image, audio, voice generation, and task management

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
6 read · 12 write · 5 delete
Secrets
1 (API keys, tokens or passwords)
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 23

Read from the source code; the running server may list different tools.

Read 6 · Look things up without changing anything.

  • check_runway_task
  • get_runway_balance
  • list_custom_voices
  • preview_voice
  • query_credit_usage
  • wait_for_runway_task

Write 12 · Create, change, send or run things.

  • character_performance
  • dub_audio
  • generate_image
  • generate_sound_effect
  • generate_speech
  • generate_video_from_image
  • generate_video_from_text
  • generate_video_from_video
  • isolate_voice
  • swap_voice
  • upload_media
  • upscale_video

Delete 5 · Delete, drop, revoke or wipe things.

  • cancel_runway_task
  • configure_runway_api_key
  • create_custom_voice
  • delete_custom_voice
  • download_runway_output

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • RUNWAYML_API_SECRET

Other settings (environment variables or headers).

  • RUNWAY_ALLOWED_ROOT
  • RUNWAY_DOWNLOAD_ROOT
  • RUNWAY_REQUEST_TIMEOUT_MS
  • RUNWAY_UPLOAD_TIMEOUT_MS

Files it touches

  • Any path the agent passes to its tools

Tools (23)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • cancel_runway_taskcan change or delete data

    Cancel a pending/running task or delete a completed task. Saves credits if cancelled before completion.

  • character_performance

    Animate a character with facial expressions and body movements from a reference performance video (Act-Two). MODEL: act_two. 5 credits/sec. Output duration matches reference video length. WORKFLOW: Returns task_id → poll or use wait_for_runway_task.

  • check_runway_taskread-only

    Check the status of any Runway generation task. STATUS VALUES: PENDING → THROTTLED → RUNNING → SUCCEEDED (output URLs) or FAILED. TIP: Use wait_for_runway_task for automatic polling.

  • configure_runway_api_keycan change or delete data

    Save your Runway API key. Call this when the user provides their key. WHERE TO GET A KEY: Go to https://dev.runwayml.com/ → API Keys. Add credits in Billing (min $10 = 1000 credits).

  • create_custom_voicecan change or delete data

    Create a custom voice from a text description of desired voice characteristics. MODELS: eleven_multilingual_ttv_v2 (default), eleven_ttv_v3 (newer). Check status with list_custom_voices. Once READY, use its ID with generate_speech.

  • delete_custom_voicecan change or delete data

    Delete a custom voice by ID. This is permanent and cannot be undone.

  • download_runway_outputcan change or delete data

    Download a Runway output (video, image, audio) to a local file. Use after a task succeeds to save the output locally. output_path MUST live inside RUNWAY_DOWNLOAD_ROOT (default ~/Downloads/runway-mcp). Sensitive paths (~/.ssh, ~/.aws, /etc, ~/.bashrc, ~/.zshrc) are refused even when the root would otherwise permit them. By default, refuses to overwrite an existing file (atomic flags: "wx") — pass overwrite: true to clobber.

  • dub_audio

    Translate and dub audio into a different language, cloning the original speaker's voice. COST: 1 credit per 2 seconds. WORKFLOW: Returns task_id → poll or use wait_for_runway_task.

  • generate_image

    Generate an image from text, optionally with reference images for style/content guidance. MODELS: gen4_image (high quality), gen4_image_turbo (fast/cheap), gemini_2.5_flash (Google Gemini). REFERENCE IMAGES: Tag with short label (e.g., "cat"), use @tag in prompt. WORKFLOW: Returns task_id → poll with check_runway_task or use wait_for_runway_task.

  • generate_sound_effect

    Generate sound effects from a text description. COST: 1 credit per 6 seconds. WORKFLOW: Returns task_id → poll or use wait_for_runway_task.

  • generate_speech

    Generate spoken audio from text using ElevenLabs voices via Runway. 49 voice presets available. Can also use custom voice IDs (eleven_multilingual_v2 only). MODELS: eleven_multilingual_v2 (default), eleven_v3 (expressive; supports audio tags like [laughs] and [whispers] in the text; preset voices only). COST: 1 credit per 50 characters. WORKFLOW: Returns task_id → poll or use wait_for_runway_task.

  • generate_video_from_image

    Animate a still image into a video. Supports first-frame (and optionally last-frame) keyframe control. MODELS: gen4.5 (flagship), gen4_turbo (fast/cheap), veo3.1 (best quality + audio), veo3.1_fast, veo3 (deprecated upstream). WORKFLOW: Returns task_id → poll with check_runway_task or use wait_for_runway_task.

  • generate_video_from_text

    Create a video entirely from a text description. MODELS: gen4.5 (flagship), veo3.1 (best + audio), veo3.1_fast, veo3 (deprecated upstream). WORKFLOW: Returns task_id → poll or use wait_for_runway_task.

  • generate_video_from_video

    Re-style or transform an existing video using Aleph 2.0. MODEL: aleph2 (only option). 28 credits/sec (56 credit minimum). Input video must be 30 seconds or shorter. WORKFLOW: Returns task_id → poll or use wait_for_runway_task.

  • get_runway_balanceread-only

    Check your Runway credit balance, usage tier limits, and today's usage by model. 1 credit = $0.01.

Show 8 more tools
  • isolate_voice

    Isolate voice from background audio. Extracts clean speech. Input must be 4.6s-3600s. COST: 1 credit per 6 seconds.

  • list_custom_voicesread-only

    List all custom voices you've created. Returns voice IDs, names, descriptions, and status. Use the voice ID with generate_speech.

  • preview_voiceread-only

    Generate a short audio preview of a voice from a text description, without creating it. Use to audition voice characteristics before committing with create_custom_voice.

  • query_credit_usageread-only

    Query detailed credit usage broken down by model and day. Supports date ranges up to 90 days.

  • swap_voice

    Replace the voice in an audio or video file with a different voice, preserving speech content. COST: 1 credit per 3 seconds.

  • upload_media

    Upload a local file to Runway's ephemeral storage, returning a runway:// URI. Supports files up to 200MB. URI valid for 24 hours.

  • upscale_video

    Upscale a video to a higher resolution with the Magnific Video Upscaler. Input video must be 30 seconds or shorter. COST: billed per output frame — roughly 210 credits for 10s @ 30fps at 720p/1k, 270 at 2k, 360 at 4k. WORKFLOW: Returns task_id → poll with check_runway_task or use wait_for_runway_task.

  • wait_for_runway_taskread-only

    Submit a task ID and wait for it to complete. Polls automatically. Returns the final task result including output URLs when successful.

Signals

Stars
13
Forks
4
Open issues
1
Weekly downloads
39
Last commit (this folder)
Aug 10, 2026 (2 months ago)
Last release
Aug 10, 2026 (2 months ago)
Last package publish
Aug 10, 2026 (2 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.mindstone/mcp-server-runway
Version
0.4.1
Auth
API key
License
License unknown
First seen
Oct 24, 2026
Last checked
Oct 24, 2026

More from mindstone

Cite this page

Runway ML MCP server. Agent Mart. https://agentmart.dev/connectors/mindstone-mcp-server-runway (last updated 2026-10-24)