Runway Dev helps your coding agent build AI video, image and audio generation into your apps with Runway’s API, including Runway’s own models alongside the best from other labs.
- The Runway Dev MCP connects your agent to your Runway Developer Portal account. It can look up available models, prices and limits; set up Model Routers based on cost, speed or quality, with an optional credit cap; and manage real-time avatars. It can also inspect failed tasks and routing decisions to help you work out what to check next.
- Skills show your agent how to integrate the API with the official SDKs, and how to build with models, Model Routers, Recipes, Workflows and real-time avatars.
This repository is the plugin: root manifests and MCP configuration load the seven active skills in skills/. The install ID remains runway-api; the display name is Runway Dev.
Installing a plugin does not configure an application's API key or automatically create a Runway account. Public directory availability depends on each host's listing.
Install from the Runway-maintained marketplace:
claude plugin marketplace add runwayml/skills
claude plugin install runway-api@runway-devFor local testing:
claude plugin marketplace add /absolute/path/to/skills
claude plugin install runway-api@runway-devAsk Claude to help connect your Runway Dev account, or run /runway-api:runway-dev-setup. Complete browser sign-in and consent yourself.
The runway-api@claude-plugins-official listing is managed by Anthropic and may pin a different version from the Runway-maintained marketplace.
For local development, register this repository and install its plugin:
codex plugin marketplace add /absolute/path/to/skills
codex plugin add runway-api@runway-devThe Git-backed equivalent is codex plugin marketplace add runwayml/skills. The package declares an onboarding skill; run setup or ask the agent to help connect your Runway Dev account. Public directory availability requires submission and review.
For an OpenAI package export, use Node.js 24.12 or newer:
npm --prefix tooling ci --ignore-scripts
npm --prefix tooling run build:pluginThis creates .build/runway-api-4.0.0.zip. It exports the root plugin files and active Dev skills from an explicit allowlist, excluding the legacy archive and development files. Package validation and native authentication are separate checks.
The root .cursor-plugin/plugin.json defines Runway Dev (runway-api) and selects the root developer skills and MCP connection. For testing, use Cursor's local plugin workflow or its repository install flow with the branch containing this package. A standalone MCP connection remains available; adding only MCP does not install skills.
Replit distributes MCP connections and Agent Skills separately:
- Add Runway Dev MCP to Replit and complete browser authorization.
- Install the setup, foundation, and relevant surface skills:
npx skills add runwayml/skills --skill runway-dev-setup --skill runway-dev --skill runway-dev-models -a replitThe MCP link and standalone skills are separate installations.
| Skill | Purpose |
|---|---|
runway-dev-setup |
Connect an account and project; guide application key setup when needed |
runway-dev |
Shared server boundary, current docs, credentials, SDK tasks, and errors |
runway-dev-models |
Integrate direct model endpoints |
runway-dev-model-routers |
Configure and integrate Model Routers |
runway-dev-characters |
Integrate real-time Characters and Sessions |
runway-dev-recipes |
Implement documented Recipe pipelines |
runway-dev-workflows |
Call published Runway app Workflows through the API |
Standalone installation works for compatible agents without the plugin:
npx skills add runwayml/skills --skill runway-dev --skill runway-dev-models --agent cursor claude-code codexStandalone skills do not automatically configure MCP. Use one installation path for each skill to avoid duplicate copies.
The older rw-generate-*, use-runway-api, and rw-check-org-details skills and their helpers remain available at this pinned revision. They are retired and are no longer included in the current plugin repository files.
Install the self-contained use-runway-api skill explicitly:
npx skills add https://github.com/runwayml/skills/tree/342b34b0df2bd3e6747beaa5fdb9ef11d565be94/legacy --skill use-runway-apiFor the older Python helpers, clone this repository, check out that revision, and run from legacy/. Existing marketplace installs pinned to an older commit keep that version until updated.
MCP uses browser OAuth at https://dev.runwayml.com/mcp; do not put an API key in its configuration. Your application uses its own server-side RUNWAYML_API_SECRET. Create the key in Developer Portal and keep it out of browser bundles, chat, and source control. API generations may consume credits.
Use the current docs, MCP connection guide, and agent context for current contracts. No model catalog or prices are pinned in this README.
Edit the root manifests and active skills/ directly. There is no generated plugin copy or sync step. Build and test dependencies live under tooling/ so plugin installation does not install development packages. Run npm --prefix tooling run build:plugin to export a ZIP; add any new skill resources to its explicit file allowlist. CI checks the export, cross-host paths, and portable schemas. See the maintainer guide.
Licensed under MIT.