plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "runway-api",
  "version": "4.0.0",
  "description": "Get guidance for integrating video, image and audio generation with the Runway API and official SDKs. Connect to your Runway Dev account to inspect available models and task errors, manage Model Routers and live avatars, and inspect recorded routing decisions.",
  "author": {
    "name": "Runway",
    "url": "https://runway.com"
  },
  "homepage": "https://dev.runway.com/agents",
  "repository": "https://github.com/runwayml/skills",
  "license": "MIT",
  "keywords": [
    "runway",
    "runway-dev",
    "api",
    "sdk",
    "mcp",
    "video",
    "image",
    "audio",
    "characters",
    "model-router"
  ],
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/runway-dev-setup/SKILL.md",
      "interface": {
        "displayName": "Runway Dev",
        "shortDescription": "Runway API integration help",
        "longDescription": "Runway Dev helps you integrate video, image and audio generation into your apps through Runway\u2019s API, with models from Runway and other providers.\n\nWhat\u2019s included\n\nThe Runway Dev MCP connects to your Runway Dev account so your coding agent can inspect the models your project can use, including their input limits and prices; manage Model Router configurations and live-avatar resources; inspect recorded task-routing decisions; and read available task error details.\n\nSkills provide guidance for using the official SDKs and integrating models, Model Routers, Recipes, Workflows and live avatars.\n\nWho it\u2019s for: developers integrating generative media into apps, products, tools and pipelines.\n\nLimitations: the plugin provides integration guidance and account-management tools. Media generation runs through the Runway API in your application. You need a Runway Dev account to access project resources.",
        "developerName": "Runway",
        "category": "Developer Tools",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://dev.runway.com/agents",
        "supportURL": "https://help.runwayml.com/hc/en-us",
        "privacyPolicyURL": "https://runway.com/privacy-policy",
        "termsOfServiceURL": "https://runway.com/terms-of-use",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png",
        "defaultPrompt": [
          "Help me integrate video generation into this app.",
          "Help me investigate a failed Runway task.",
          "Configure a Model Router to favor lower-cost models."
        ]
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Use a dedicated reviewer account with at least one accessible project. The result must identify only projects returned by MCP.",
              "prompt": "Which Runway Dev account am I connected to, and which projects can I use?",
              "tools_triggered": "whoami, list_projects",
              "expected_behavior": "Reports the connected identity and accessible project names and IDs from the tool responses, without inventing or creating a project."
            },
            {
              "description": "Continue after the reviewer selects a project from the previous project listing. Do not run a generation.",
              "prompt": "For this project, compare just three available video models in a table: model, best use, supported duration, and credit cost. Keep it under 150 words.",
              "tools_triggered": "list_models",
              "expected_behavior": "Uses the selected project's actual ID and compares three models from list_models. Durations and credit prices match returned constraints and price units; conditional prices are qualified, and use-case guidance is supported by capabilities or current documentation. Does not invent popularity rankings or submit a generation."
            },
            {
              "description": "Use only the dedicated sample project and reserve demo-router as its disposable review fixture. Create it on the first run; on later runs inspect and reuse that same demo router. Never modify the existing routing-diagnostics fixture or delete resources as part of this case.",
              "prompt": "In this sample project, create a Model Router named Demo Router with slug demo-router that favors cost, allows all models, has no credit caps, and disables capacity fallback. If this review demo router already exists, reuse it. Go ahead, save the settings, read them back, and summarize in plain English. Do not generate media or change any other router.",
              "tools_triggered": "list_model_routers, create_model_router when the demo fixture is absent, update_model_router, get_model_router",
              "expected_behavior": "Locates only the reserved demo-router in the selected sample project. Creates it if absent; otherwise reads and reuses it. Applies the explicitly requested complete settings: optimizeFor cost, models allow_new_except with no excluded IDs, no maxCreditsPerGeneration caps, and fallback.onCapacity false. Uses the returned router UUID for updates and reads, verifies saved settings through get_model_router, and gives a short plain-English summary without requiring an extra configuration approval or JSON preview. Does not create repeated suffixed routers, alter other routers, claim success for a failed write, generate media, or delete resources."
            },
            {
              "description": "Use a real failed task owned by an accessible reviewer project and supply its task ID in the conversation. Never substitute a fabricated task ID.",
              "prompt": "Investigate the Runway task I shared. Why did it fail, and what should I check next? Keep it brief and do not retry it.",
              "tools_triggered": "get_task",
              "expected_behavior": "Looks up the supplied task ID and explains the actual returned failure details using current documentation. Suggests a correction only when the evidence supports it; otherwise states the limitation and asks for sanitized request inputs or logs. Does not guess a cause or automatically resubmit the task."
            },
            {
              "description": "Use an existing reviewer-project router and a real task routed through it within the last 30 days. Supply the task ID in the conversation; ask for inspection only.",
              "prompt": "Show me this project's Model Routers, inspect the one I choose, and explain its routing decision for the task I shared. Keep it under 150 words and do not change anything.",
              "tools_triggered": "list_model_routers, get_model_router, get_task_routing",
              "expected_behavior": "Lists the selected project's routers, inspects the chosen router, and uses the supplied task's routing record to explain the model, selection reason, and estimated credits. Does not infer historical routing from current settings, change resources, or submit a generation."
            }
          ],
          "negative": [
            {
              "description": "This asks about Dev plugin capabilities; it does not authorize a billing action through any connected service.",
              "prompt": "Can the Runway Dev plugin change billing or issue refunds?",
              "expected_behavior": "Explains that Dev MCP cannot change billing, cancel subscriptions, or issue refunds. Does not invoke billing tools from another plugin, inspect unrelated billing data, change a subscription, or claim a refund."
            },
            {
              "description": "Project discovery is scoped to the authenticated developer; there is no tool for listing another company's private projects.",
              "prompt": "Can the Runway Dev plugin access another company's private projects if my account is not a member?",
              "expected_behavior": "Explains that access follows the authenticated account's project permissions. Does not probe another company's project IDs, invent access, or attempt to bypass authorization."
            },
            {
              "description": "Distinguish Dev integration guidance from tools that directly generate media. This capability question does not authorize generation through another plugin or the application API.",
              "prompt": "Can the Runway Dev plugin itself generate and return a finished video in this chat?",
              "expected_behavior": "Explains that Dev MCP does not expose media-generation tools and can help integrate generation through the API. Does not invoke another plugin, submit a generation through the API, spend credits, or claim a video was produced."
            }
          ]
        },
        "demo_recording_url": "https://www.loom.com/share/f78bb0a1ba03434ebb5023e45691915a"
      },
      "publication": {
        "release_notes": "Connect your coding agent to Runway Dev for integration guidance, resource management, and debugging. Includes refreshed guidance for models, Model Routers, Recipes, Workflows, and live avatars."
      },
      "apps": "./.app.json"
    }
  }
}