Runway Dev plugin
The Runway Dev plugin gives an agent an MCP server and seven skills to embed Runway video, image and audio generation
- 74 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- MCP signs in to your Developer Portal account through OAuth and can configure routers and avatars, and API generations consume credits
- The skills suggest adding a server-side `RUNWAYML_API_SECRET` key to the app, and a leak of it spends your credits
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/runway-devDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- MCP signs in to your Developer Portal account through OAuth and can configure routers and avatars, and API generations consume credits
- The skills suggest adding a server-side `RUNWAYML_API_SECRET` key to the app, and a leak of it spends your credits
This is third-party code. Review the repository files before installing.
What it does
The plugin consists of an MCP server and seven skills. The server connects the agent to your Runway Developer Portal account: it looks up available models, prices and limits, sets up Model Routers by cost, speed or quality with an optional credit cap, and manages real-time avatars. It also inspects failed tasks and routing decisions. The skills teach the agent to integrate the API through the official SDKs: `runway-dev-setup` connects an account and project, `runway-dev` covers shared boundaries, credentials and errors, `runway-dev-models` handles direct models, `runway-dev-model-routers` routers, `runway-dev-characters` real-time characters and sessions, `runway-dev-recipes` recipes, and `runway-dev-workflows` published workflows. MCP signs in through browser OAuth, and no API key goes into its configuration. The application needs its own server-side `RUNWAYML_API_SECRET`, created in the Developer Portal. Claude Code has a separate plugin in the `claude/` folder: it connects to `https://dev.runwayml.com/mcp/claude` and omits `create_avatar`, so new avatars are created in the portal.
Who it is for. Developers adding video, image and audio generation to an app through the Runway API while working in Claude Code, Codex or Cursor.
Good fit when
- The app needs a Runway video model call and the agent should pick a model, price and limits from your account
- You want a model router that chooses by cost or quality and stops at a credit cap
- Generation tasks fail and the agent should work out why, including routing decisions
- The app needs real-time characters with sessions assembled from the SDK docs
Not a fit when
- You need to generate one clip by hand: the Runway web interface is enough
- You have no Developer Portal account: the plugin does not create one
- You need another video provider: the plugin targets the Runway API
Example request
Connect Runway Dev, pick a model for five-second text-to-video generation and add the call to our Node.js serverLimitations
- The plugin does not configure the application API key or create a Runway account; both are done in the Developer Portal.
- API generations consume credits; MCP shows prices and lets you set a cap.
- In the Claude Code plugin the skills validate integration locally and leave live generations, sessions and recipe calls to your application.
- Availability in public host directories depends on each host's listing, and the `claude-plugins-official` version may differ from the Runway marketplace.
How to disable. For Claude Code remove the plugin with claude plugin uninstall runway-api@runway-dev. Standalone skills are removed by deleting the runway-dev folders from the agent's skills directory. MCP access is revoked in the Developer Portal.
FAQ
How do I install the Runway Dev plugin in Claude Code?
Run claude plugin marketplace add runwayml/skills and claude plugin install runway-api@runway-dev. Then ask Claude to connect your account or run `/runway-api:runway-dev-setup` and finish the browser sign-in.
Do I put an API key into the MCP configuration?
No, MCP signs in through browser OAuth. The `RUNWAYML_API_SECRET` key is for your application only and belongs on the server, out of browser bundles, chat and the repository.
How do I install the skills without the plugin?
Run `npx skills add runwayml/skills --skill runway-dev --skill runway-dev-models --agent cursor claude-code codex`. Such skills do not configure MCP, so connect it separately and use one install path per skill.
How do I connect Runway Dev to Codex?
Run codex plugin marketplace add runwayml/skills and codex plugin add runway-api@runway-dev. The package declares an onboarding skill; run it or ask the agent to connect your account.
What can the agent do through MCP?
Look up models, prices and limits, set up model routers with a credit cap, manage real-time avatars and inspect failed tasks. Avatar creation is disabled in the Claude Code version.
Discussion
No questions or reviews yet.
Related
PluginsRunAPI MCP server: a catalog of 160 models for images, video, music and speech, pricing, task runs and balance
MCP server of the 37Studio video studio: an agent manages brands, makes videos, posts to social networks and answers messages.
A Comfy Cloud plugin for Claude Code: commands to generate images, video, audio and 3D, connected through a hosted MCP server
A Claude Code plugin that makes a motion graphics video from a track and a prompt: plan, characters, animation, audio mix.
WaveSpeed MCP server: an agent runs image, video, audio and 3D models, reads each model's input schema and quotes the price first
A self-hosted pipeline turns a text script into an MP4 with voiceover and stock footage, and an agent drives it through MCP.
README in short
The README explains what Runway Dev contains: an MCP server tied to an account and skills for integrating the API with the official SDKs. Install sections for Claude Code, Codex and ChatGPT, Cursor and Replit follow. A table describes the seven skills, a separate section covers keys and credit use, and the last one covers plugin development and release with a ZIP export.