# Runway — MCP server on mcp.ai
> Connect your Runway account and use 22 tools for AI content generation straight from your AI agent. Connect with your own API key. Runway provides generative AI APIs for creating and transforming video, images, audio, avatars, voices, and media workflows.

By: mcp.ai · official
Page: https://mcp.ai/runway

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_runway?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/runway/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/runway/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/runway/skill.md
Postman collection (v2.1): https://mcp.ai/runway/postman.json

## Tools
- runway_cancel_task(task_id: string) — Cancel a running Runway task or delete its task record. Returns success only when Runway confirms the operation; an already absent task remains a 404 error.
- runway_create_document(name: string, content: string) — Create a Runway knowledge document from markdown or plain text for reuse by avatar workflows.
- runway_create_ephemeral_upload(filename: string) — Create only a temporary Runway media upload slot and return its presigned multipart form details and runway:// URI. This action does not upload file bytes; POST them separately to upload_url using fie
- runway_delete_document(document_id: string) — Permanently delete a Runway knowledge document by its ID.
- runway_generate_image() — Start a Runway text-to-image or reference-guided image generation task and return its task ID and estimated credit cost.
- runway_generate_sound_effect() — Generate an audio effect from a text prompt and return the task ID and estimated credit cost.
- runway_generate_speech() — Synthesize speech with Runway using an exact model-specific voice and option contract, then return the task ID and estimated credit cost.
- runway_generate_video_from_image() — Animate one or more input images with a selected Runway model and return the task ID and estimated credit cost.
- runway_generate_video_from_text() — Start a Runway text-to-video task with a model-specific typed request and return its task ID and estimated credit cost.
- runway_get_document(document_id: string) — Get one Runway knowledge document, including its full content and the avatars that currently use it.
- runway_get_organization() — Return the connected Runway organization's credit balance, monthly credit spend cap, exact per-model quotas, and current daily generation usage.
- runway_get_task(task_id: string) — Get the current status, cost, output URLs, and failure details for a Runway generation task. Runway does not update a task more often than every five seconds.
- runway_get_usage(start_date?: string, before_date?: string) — Return daily Runway credit usage by model for an optional UTC date range of up to 90 days.
- runway_get_workflow(workflow_id: string) — Get a published Runway workflow version and its graph so node IDs and output keys can be inspected before running the workflow.
- runway_get_workflow_invocation(invocation_id: string) — Get the current status, completed node output URLs, and node or invocation failure details for a Runway workflow invocation.
- runway_list_documents(sort?: string, limit?: integer, order?: string, cursor?: string) — List Runway knowledge documents one page at a time, with sorting and an opaque continuation cursor. List results omit full document content.
- runway_list_workflows() — List the connected account's published Runway workflows and their available versions, ordered as returned by Runway.
- runway_run_workflow(workflow_id: string, node_outputs?: object) — Invoke a published Runway workflow, optionally overriding graph node outputs, and return the created workflow invocation ID.
- runway_transform_video() — Transform or restyle an existing video with Runway and return the created task ID and estimated credit cost.
- runway_update_document(name?: string, content?: string, document_id: string) — Change the name, content, or both for an existing Runway knowledge document. Provide at least one of name or content.
- runway_upscale_image(flavor?: string, sharpen?: integer, image_uri: string, smart_grain?: integer, scale_factor?: integer, ultra_detail?: integer) — Start a Runway image upscaling task and return its task ID and estimated credit cost.
- runway_upscale_video(flavor?: string, sharpen?: integer, fps_boost?: boolean, video_uri: string, creativity?: integer, resolution?: string, smart_grain?: integer) — Start a Runway video upscaling task and return its task ID and estimated credit cost.

## Example prompts
- "What can I do in Runway?"
- "Show me a summary of my Runway account"

## Links
Docs: https://mcp.ai/docs/mcps/runway
Website: https://mcp.ai/mcps/runway