Machine Learning

Runway MCP Server

Connect your account, then chat with AI to run tools.

Runway provides AI-powered content generation APIs for creating images, videos, and other media. Generate high-quality visual content using text-to-image, image-to-video, video upscaling, and character performance models with state-of-the-art AI technology.

Managed
18 tools
Agent guide included

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Runway — workflow patterns, data models, and gotchas for your AI agent.

Runway

Runway provides AI media generation: text-to-image, image-to-video, video upscaling, and character performance. Each capability has specific models; outputs are generated asynchronously or in real time.

Data Model

  • Organization — account context; billing and usage.
  • Generations — images or videos from prompts; may be async (poll for status).
  • Models — per capability: gen4_image, gen4_turbo, veo3.1, gen4_aleph, act_two, etc.

Gotchas

  • Model selection: Image, video, upscale, and character tools each accept different models—match capability to model (e.g. gen4_image for stills, gen4_turbo/veo family for motion). Vendor model lists evolve quickly.
  • Prompt length: Generation prompts are capped at 1000 UTF-16 code units (not plain byte length). Long marketing copy or multi-scene briefs must be shortened before calling text-to-image or video tools.
  • Aspect ratios are model-specific: gen4_image and gemini_2.5_flash accept different ratio sets; using a gen4 ratio like 1920:1080 with gemini_2.5_flash returns a 400 validation error. Use colon form (1024:1024), not 1024x1024, unless the API lists both.
  • gen4_image_turbo: requires 1-3 reference_image_uris on text-to-image; register HTTPS uploads when refs are not already on Runway.
  • Async tasks: generation tools return Runway task objects (id, status, output when complete). Poll task status by id until SUCCEEDED, or pass wait_for_completion=true on the task read.
  • Credits: insufficient balance returns a structured insufficient_credits outcome, not a generic failure.
  • Async video: Long renders finish asynchronously; wait for completion status before expecting URLs or assets.
  • Compatibility: Major vendor revisions can change defaults; keep prompts aligned with the model family you select.

Tools in this Server (18)

Runway Character Performance

Generate a character performance video (act_two) from a character image and a reference performance video or image.

Runway Create Upload

Upload a temporary media file to Runway and receive a runway:// URI for use in reference_image_uris, prompt_image, video_uri, and other generation par...

Runway Delete Task

Cancel or delete a Runway task by ID.

Runway Get Organization

Get usage tier and credit balance for your Runway organization, including credit balance, tier limits, and current usage statistics.

Runway Get Task

Retrieve a Runway generation task by ID. Returns status, output URLs, and metadata. Set wait_for_completion=true to block until the task finishes.

Runway Image Reference Edit

Generate an image variation locked to 1-3 reference images using gen4_image_turbo. Upload reference images first (inline bytes or from an HTTPS URL) t...

Runway Image To Video

Generate video from an input image URL or data URI. Default video_model is gen4_turbo with ratio 1280:720. Duration is model-specific (veo3.1: 4/6/8, ...

Runway Query Usage

Fetch credit usage data broken down by model and day for your Runway organization. Up to 90 days of data can be queried at a time.

Runway Sound Effect

Generate sound effects from text using Runway (eleven_text_to_sound_v2).

Runway Speech To Speech

Convert speech to another Runway preset voice in audio or video (eleven_multilingual_sts_v2).

Runway Text To Image

Generate images from a text prompt using Runway. Default image_model is gen4_image with ratio 1024:1024. prompt_text is capped at 1000 UTF-16 code uni...

Runway Text To Speech

Generate speech from text using a Runway preset voice (eleven_multilingual_v2).

Runway Text To Video

Generate video from a text prompt. Default video_model is veo3.1 with ratio 1280:720. prompt_text is capped at 1000 UTF-16 code units. veo3.1 and veo3...

Runway Upload Bytes

Upload image bytes to Runway and receive a runway:// URI for gen4_image_turbo reference_image_uris. For HTTPS sources, register the file from a public...

Runway Video Upscale

Upscale a video with Runway gen4_aleph (4x upscale, max 4096px per side). Provide video_uri and a short prompt_text.

Runway Voice Dubbing

Dub audio to a target language using Runway (eleven_voice_dubbing).

Runway Voice Isolation

Isolate voice from background audio using Runway (eleven_voice_isolation). Audio must be between 4.6 and 3600 seconds.

Wait Runway Task

Poll a Runway generation task until it succeeds, fails, is canceled, or times out. Use after tools that return a task id with wait_for_completion=fals...

Frequently Asked Questions

What is the Runway MCP server?

Runway provides AI-powered content generation APIs for creating images, videos, and other media. Generate high-quality visual content using text-to-image, image-to-video, video upscaling, and character performance models with state-of-the-art AI technology. It provides 18 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Runway to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/runway. Authentication is handled automatically.

How many tools does Runway provide?

Runway provides 18 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Runway require?

Runway uses API Key. Runway requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Runway to any MCP client in minutes

MCP URL
https://mcp.mcpbundles.com/bundle/runway

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Runway and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Runway will appear under Not connected — select it and click Connect to complete OAuth.
Name: Runway
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/runway
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use Runway?

Sign in to connect your credentials and start running tools from the chat.

Runway MCP Server & Skill