# Runway — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_runway?ms=1787295900000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `runway_cancel_task`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/runway`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/runway/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/runway/cancel/task` — 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.
  - body: { task_id: string }
- `POST https://api.mcp.ai/api/runway/create/document` — Create a Runway knowledge document from markdown or plain text for reuse by avatar workflows.
  - body: { name: string, content: string }
- `POST https://api.mcp.ai/api/runway/create/ephemeral/upload` — 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
  - body: { filename: string }
- `POST https://api.mcp.ai/api/runway/delete/document` — Permanently delete a Runway knowledge document by its ID.
  - body: { document_id: string }
- `POST https://api.mcp.ai/api/runway/generate/image` — Start a Runway text-to-image or reference-guided image generation task and return its task ID and estimated credit cost.
- `POST https://api.mcp.ai/api/runway/generate/sound/effect` — Generate an audio effect from a text prompt and return the task ID and estimated credit cost.
- `POST https://api.mcp.ai/api/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.
- `POST https://api.mcp.ai/api/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.
- `POST https://api.mcp.ai/api/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.
- `POST https://api.mcp.ai/api/runway/get/document` — Get one Runway knowledge document, including its full content and the avatars that currently use it.
  - body: { document_id: string }
- `POST https://api.mcp.ai/api/runway/get/organization` — Return the connected Runway organization's credit balance, monthly credit spend cap, exact per-model quotas, and current daily generation usage.
- `POST https://api.mcp.ai/api/runway/get/task` — 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.
  - body: { task_id: string }
- `POST https://api.mcp.ai/api/runway/get/usage` — Return daily Runway credit usage by model for an optional UTC date range of up to 90 days.
  - body: { start_date?: string, before_date?: string }
- `POST https://api.mcp.ai/api/runway/get/workflow` — Get a published Runway workflow version and its graph so node IDs and output keys can be inspected before running the workflow.
  - body: { workflow_id: string }
- `POST https://api.mcp.ai/api/runway/get/workflow/invocation` — Get the current status, completed node output URLs, and node or invocation failure details for a Runway workflow invocation.
  - body: { invocation_id: string }
- `POST https://api.mcp.ai/api/runway/list/documents` — List Runway knowledge documents one page at a time, with sorting and an opaque continuation cursor. List results omit full document content.
  - body: { sort?: string, limit?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/runway/list/workflows` — List the connected account's published Runway workflows and their available versions, ordered as returned by Runway.
- `POST https://api.mcp.ai/api/runway/run/workflow` — Invoke a published Runway workflow, optionally overriding graph node outputs, and return the created workflow invocation ID.
  - body: { workflow_id: string, node_outputs?: object }
- `POST https://api.mcp.ai/api/runway/transform/video` — Transform or restyle an existing video with Runway and return the created task ID and estimated credit cost.
- `POST https://api.mcp.ai/api/runway/update/document` — Change the name, content, or both for an existing Runway knowledge document. Provide at least one of name or content.
  - body: { name?: string, content?: string, document_id: string }
- `POST https://api.mcp.ai/api/runway/upscale/image` — Start a Runway image upscaling task and return its task ID and estimated credit cost.
  - body: { flavor?: string, sharpen?: integer, image_uri: string, smart_grain?: integer, scale_factor?: integer, ultra_detail?: integer }
- `POST https://api.mcp.ai/api/runway/upscale/video` — Start a Runway video upscaling task and return its task ID and estimated credit cost.
  - body: { flavor?: string, sharpen?: integer, fps_boost?: boolean, video_uri: string, creativity?: integer, resolution?: string, smart_grain?: integer }

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

## More
- Page: https://mcp.ai/runway
- Agent spec (llms.txt): https://mcp.ai/runway/llms.txt
- Postman collection: https://mcp.ai/runway/postman.json