Skip to main content
Glama

Runway MCP Server by useapi.net (third-party)

Create a video (all models)

runway_create_video

Generate a video with any of the 25 video models on Runway (Seedance 2.5 / 2.0, Wan 3.0, MiniMax H3, FLUX 3, Grok Imagine 1.5, HappyHorse, Kling O3 / 3.0 / 2.6, Veo 3.1, Gen-4.5, Gen-4, Gen-4 Turbo) from a prompt and optional reference assets (images, videos, audio from runway_upload_asset). The general video tool: runway_create_gen4_5, runway_create_gen4 and runway_create_gen4_turbo are older single-model routes; runway_edit_video_aleph, runway_act_two and runway_lipsync cover video-to-video, performance and lip sync. Waits up to ~50 s, then returns the video url and assetId (SUCCEEDED), the reason (FAILED) or the taskId for runway_get_task. Uses the account's credits, or none with exploreMode. POST /videos/create.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "model": "<model>"
    },
    "name": "runway_create_video"
  }
}

Input Schema

NameRequiredDescriptionDefault
seedNoSeed, 1-4294967294: gen4.5, gen4, gen4-turbo and minimax-h3-max only (random when omitted).
waitNoWait up to ~50 s for the task to finish (default true); false returns the taskId at once.
audioNoGenerate sound (default true); false for a silent video. On kling-3.0-motion-control and kling-o3-* Edit Video it keeps or drops the source video's sound. Ignored by grok-imagine-1.5 (always silent); no effect on minimax-h3 and minimax-h3-max (no audio toggle).
draftNoseedance-2-5 only: true renders a cheaper 480p preview at the 480p rate (resolution 480p, no mov). Runway offers drafts to some accounts only.
emailNoThe Runway account to run it on: its email from runway_list_accounts. Omit it with reference assets (the account that holds them runs the task) or to let the API pick one of your accounts.
modelYesThe video model. Seedance: seedance-2-5 (4-30 s or 0 = Auto, up to 30 image / 10 video / 10 audio references, video_mode, drafts), seedance-2, seedance-2-fast, seedance-2-mini (4-15 s). Wan: wan-3.0, wan-3.0-prime (2-30 s or 0 = Auto), wan-2.6-flash (5 / 10 / 15 s, one image), wan-2.2-animate (one image + videoAssetId, no prompt). minimax-h3, minimax-h3-max (5-15 s). flux-3 (5-20 s or 0 = Auto, can extend a video). grok-imagine-1.5 (3-15 s, image-to-video only, silent). happyhorse-1.0 (3-15 s). Kling: kling-o3-4k, kling-o3-pro, kling-o3-standard (5 / 10 / 15 s, multishot, Edit Video on pro / standard), kling-3.0-pro, kling-3.0-standard (5 / 10 / 15 s, multishot), kling-3.0-motion-control (character image + performance video), kling-2.6-pro, kling-2.6-i2v (5 / 10 s). veo-3.1 (4 / 6 / 8 s). Runway: gen4.5 (2-10 s), gen4, gen4-turbo (5 / 10 s, one image required).
maxJobsNoOverride the account's maxJobs (Runway tasks at once) for this request, 1-10. Default: the account's own setting.
durationNoLength in seconds, per model as listed under model; 0 = Auto (the model picks the length) on seedance-2-5, wan-3.0 / -prime (billed up to 30 s, the rest refunded) and flux-3 (billed up to 20 s). Default: the model's first value, 5 on wan-3.0 / -prime and flux-3. Not taken by kling-3.0-motion-control and wan-2.2-animate (from the reference video).
replyRefNoYour own reference id, stored and returned with the task.
replyUrlNoA callback URL the API calls with the task (the runway_get_task shape) when it completes or fails. Default: the replyUrl of your useapi.net account.
resolutionNoOutput resolution, per model: seedance-2-5 720p (default), 480p, 1080p (some accounts only, not in Explore Mode); seedance-2 / -fast 480p (default), 720p, 1080p (not in Explore Mode); seedance-2-mini 720p (default), 480p; wan-3.0 / -prime 1080p (default), 720p, 480p; minimax-h3 2K (default), 768p; minimax-h3-max 768p (default), 480p; flux-3, happyhorse-1.0, wan-2.6-flash, veo-3.1 720p (default), 1080p; grok-imagine-1.5 480p (default), 720p; kling-3.0-motion-control 720p (default), 1080p; gen4 / gen4-turbo 720p. Other models pick it themselves.
video_modeNoseedance-2-5 only, Edit Video on the video in videoAssetId (up to 31 s; all reference videos together up to 30 s), text_prompt required, aspect_ratio not used: edit changes it as the prompt says (output as long as the source, not in Explore Mode); extend continues it forwards or backwards for duration seconds (default 5).
draftTaskIdNoseedance-2-5 only: the taskId of a draft to re-render at 1080p within 7 days of the draft, at the 1080p rate. Takes only model, email, maxJobs, replyUrl and replyRef; not in Explore Mode.
exploreModeNoExplore Mode: true spends no credits and runs at lower priority; only for accounts on a Runway Unlimited plan; not on veo-3.1, wan-3.0, wan-3.0-prime, minimax-h3, minimax-h3-max and flux-3. Seedance 1080p needs Credits Mode; seedance-2-5 in Explore Mode is capped at 15 s, with no Auto duration, no video_mode edit and reference videos up to 15 s together. Omit or false: Credits Mode.
text_promptNoWhat the video shows. Required by wan-3.0, wan-3.0-prime, minimax-h3, minimax-h3-max, flux-3, gen4, gen4-turbo, kling-2.6-pro, kling-2.6-i2v and wan-2.6-flash; not taken by wan-2.2-animate; optional elsewhere. Max length per model: 20000 wan-3.0 / -prime, 15000 seedance-2-5, 6000 minimax-h3 / -max, 5000 gen4.5, veo-3.1 and flux-3, 3500 seedance-2 / -fast / -mini, 2500 Kling, grok-imagine-1.5 and happyhorse-1.0, 1500 wan-2.6-flash, 1000 gen4 / gen4-turbo. On kling-o3-* @IMG_1..@IMG_7 cite imageAssetId1..7.
aspect_ratioNoFrame shape; the values depend on the model (gen4.5 text-to-video is 16:9 only; kling-o3-* and kling-3.0-pro / -standard 16:9, 9:16, 1:1; kling-2.6-pro and veo-3.1 16:9, 9:16). auto lets the model choose on seedance-2-5, wan-3.0 / -prime, minimax-h3 and flux-3 (the default on all but seedance-2-5); 2:1 on flux-3 only. Not taken by kling-2.6-i2v, kling-3.0-motion-control, minimax-h3-max.
videoAssetIdNovideoAssetId, reference video 1: required by wan-2.2-animate and kling-3.0-motion-control (performance, 3-30 s); the source for Edit Video on kling-o3-pro / -standard (up to 10 s) and seedance-2-5 video_mode (up to 31 s); the clip to extend on flux-3 (up to 15 s, not with startFrameAssetId); a reference on Seedance, wan-3.0 and minimax-h3: an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). The task runs on the Runway account that holds the asset.
audioAssetId1NoaudioAssetId1, reference audio 1 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3; not with startFrameAssetId / endFrameAssetId.
audioAssetId2NoaudioAssetId2, reference audio 2 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3; not with startFrameAssetId / endFrameAssetId.
audioAssetId3NoaudioAssetId3, reference audio 3 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3; not with startFrameAssetId / endFrameAssetId.
audioAssetId4NoaudioAssetId4, reference audio 4 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5, wan-3.0, wan-3.0-prime; not with startFrameAssetId / endFrameAssetId.
audioAssetId5NoaudioAssetId5, reference audio 5 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5, wan-3.0, wan-3.0-prime; not with startFrameAssetId / endFrameAssetId.
audioAssetId6NoaudioAssetId6, reference audio 6 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5; not with startFrameAssetId / endFrameAssetId.
audioAssetId7NoaudioAssetId7, reference audio 7 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5; not with startFrameAssetId / endFrameAssetId.
audioAssetId8NoaudioAssetId8, reference audio 8 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5; not with startFrameAssetId / endFrameAssetId.
audioAssetId9NoaudioAssetId9, reference audio 9 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5; not with startFrameAssetId / endFrameAssetId.
imageAssetId1NoimageAssetId1, reference image 1 (start frame on most models). Required by gen4, gen4-turbo, kling-2.6-i2v, wan-2.6-flash, wan-2.2-animate, grok-imagine-1.5 and kling-3.0-motion-control (the character to animate): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). The task runs on the Runway account that holds the asset.
imageAssetId2NoimageAssetId2, reference image 2: the end frame on kling-3.0-pro / -standard and veo-3.1, a further reference on multi-reference models: an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). The task runs on the Runway account that holds the asset.
imageAssetId3NoimageAssetId3, reference image 3 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by kling-o3-4k, kling-o3-pro, kling-o3-standard, seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3.
imageAssetId4NoimageAssetId4, reference image 4 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by kling-o3-4k, kling-o3-pro, kling-o3-standard, seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3.
imageAssetId5NoimageAssetId5, reference image 5 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by kling-o3-4k, kling-o3-pro, kling-o3-standard, seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3.
imageAssetId6NoimageAssetId6, reference image 6 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by kling-o3-4k, kling-o3-pro, kling-o3-standard, seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3.
imageAssetId7NoimageAssetId7, reference image 7 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by kling-o3-4k, kling-o3-pro, kling-o3-standard, seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3.
imageAssetId8NoimageAssetId8, reference image 8 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3.
imageAssetId9NoimageAssetId9, reference image 9 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3.
output_formatNoseedance-2-5 only: the container, mp4 (default) or mov.
videoAssetId2NovideoAssetId2, reference video 2 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3.
videoAssetId3NovideoAssetId3, reference video 3 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5, wan-3.0, wan-3.0-prime, minimax-h3.
videoAssetId4NovideoAssetId4, reference video 4 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5, wan-3.0, wan-3.0-prime.
videoAssetId5NovideoAssetId5, reference video 5 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5, wan-3.0, wan-3.0-prime.
videoAssetId6NovideoAssetId6, reference video 6 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
videoAssetId7NovideoAssetId7, reference video 7 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
videoAssetId8NovideoAssetId8, reference video 8 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
videoAssetId9NovideoAssetId9, reference video 9 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
audioAssetId10NoaudioAssetId10, reference audio 10 (MP3, WAV or M4A; fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5; not with startFrameAssetId / endFrameAssetId.
imageAssetId10NoimageAssetId10, reference image 10 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5, wan-3.0, wan-3.0-prime.
imageAssetId11NoimageAssetId11, reference image 11 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId12NoimageAssetId12, reference image 12 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId13NoimageAssetId13, reference image 13 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId14NoimageAssetId14, reference image 14 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId15NoimageAssetId15, reference image 15 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId16NoimageAssetId16, reference image 16 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId17NoimageAssetId17, reference image 17 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId18NoimageAssetId18, reference image 18 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId19NoimageAssetId19, reference image 19 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId20NoimageAssetId20, reference image 20 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId21NoimageAssetId21, reference image 21 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId22NoimageAssetId22, reference image 22 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId23NoimageAssetId23, reference image 23 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId24NoimageAssetId24, reference image 24 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId25NoimageAssetId25, reference image 25 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId26NoimageAssetId26, reference image 26 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId27NoimageAssetId27, reference image 27 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId28NoimageAssetId28, reference image 28 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId29NoimageAssetId29, reference image 29 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
imageAssetId30NoimageAssetId30, reference image 30 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
videoAssetId10NovideoAssetId10, reference video 10 (fill slots in order): an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). Taken by seedance-2-5.
endFrameAssetIdNoendFrameAssetId, the last frame; needs startFrameAssetId. Same models as startFrameAssetId except flux-3; on kling-o3-* not with reference images: an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). The task runs on the Runway account that holds the asset.
prompt_expansionNominimax-h3-max only: how the model rewrites the prompt first; Runway uses balanced when omitted.
startFrameAssetIdNostartFrameAssetId, the first frame (keyframe mode) on Seedance, wan-3.0 / -prime, minimax-h3, minimax-h3-max (256 px or more per side), flux-3 and kling-o3-*. Not with multi-reference images, videos or audio on Seedance, wan-3.0 and minimax-h3: an assetId from runway_upload_asset, runway_list_assets or a finished task (runway_get_task artifacts). The task runs on the Runway account that holds the asset.
multishot_prompt_1NoThe prompt of shot 1 in a multi-shot video (kling-3.0-pro, kling-3.0-standard, kling-o3-4k, kling-o3-pro, kling-o3-standard); needs multishot_duration_1. Shots are numbered from 1 without gaps, at least 2. On kling-o3-* @IMG_N in a shot's prompt binds imageAssetIdN to that shot.
multishot_prompt_2NoThe prompt of shot 2 in a multi-shot video (kling-3.0-pro, kling-3.0-standard, kling-o3-4k, kling-o3-pro, kling-o3-standard); needs multishot_duration_2. Shots are numbered from 1 without gaps, at least 2. On kling-o3-* @IMG_N in a shot's prompt binds imageAssetIdN to that shot.
multishot_prompt_3NoThe prompt of shot 3 in a multi-shot video (kling-3.0-pro, kling-3.0-standard, kling-o3-4k, kling-o3-pro, kling-o3-standard); needs multishot_duration_3. Shots are numbered from 1 without gaps, at least 2. On kling-o3-* @IMG_N in a shot's prompt binds imageAssetIdN to that shot.
multishot_prompt_4NoThe prompt of shot 4 in a multi-shot video (kling-3.0-pro, kling-3.0-standard, kling-o3-4k, kling-o3-pro, kling-o3-standard); needs multishot_duration_4. Shots are numbered from 1 without gaps, at least 2. On kling-o3-* @IMG_N in a shot's prompt binds imageAssetIdN to that shot.
multishot_prompt_5NoThe prompt of shot 5 in a multi-shot video (kling-3.0-pro, kling-3.0-standard, kling-o3-4k, kling-o3-pro, kling-o3-standard); needs multishot_duration_5. Shots are numbered from 1 without gaps, at least 2. On kling-o3-* @IMG_N in a shot's prompt binds imageAssetIdN to that shot.
multishot_prompt_6NoThe prompt of shot 6 in a multi-shot video (kling-o3-4k, kling-o3-pro, kling-o3-standard); needs multishot_duration_6. Shots are numbered from 1 without gaps, at least 2. On kling-o3-* @IMG_N in a shot's prompt binds imageAssetIdN to that shot.
characterOrientationNokling-3.0-motion-control only: follow the character's orientation in the image (default) or in the performance video.
multishot_duration_1NoShot 1 length in seconds, 3-12; all shots together at most 15 s.
multishot_duration_2NoShot 2 length in seconds, 3-12; all shots together at most 15 s.
multishot_duration_3NoShot 3 length in seconds, 3-12; all shots together at most 15 s.
multishot_duration_4NoShot 4 length in seconds, 3-12; all shots together at most 15 s.
multishot_duration_5NoShot 5 length in seconds, 3-12; all shots together at most 15 s.
multishot_duration_6NoShot 6 length in seconds, 3-12; all shots together at most 15 s.

Schema Changelog

Changes observed during successful MCP inspections.

No schema history has been recorded yet.

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only declare it is a non-readonly, non-destructive, open-world write; the description adds genuinely new behavior: it 'Waits up to ~50 s' before returning, returns url+assetId on SUCCEEDED, a reason on FAILED, or a taskId otherwise, and that it 'Uses the account's credits, or none with exploreMode.' That is exactly the cost/latency/return contract an agent needs for a paid, long-running generation call.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the purpose, then sibling routing, then return contract and endpoint – a sensible ordering with no filler sentences. The long parenthetical catalog of 25 model names is somewhat noisy for a description, though it does serve discovery.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 83-parameter, 25-model generation tool with no output schema, the description covers the essentials: what it produces, which sibling to use instead, how long it blocks, what the response looks like in each terminal state, and the credit/exploreMode cost model. Per-model parameter detail is properly delegated to the schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and every parameter already documents its per-model constraints, so the schema does the heavy lifting. The description only adds the high-level shape (prompt + reference assets sourced from runway_upload_asset) and re-lists model families that already appear in the enum; it adds no syntax or interaction rules the schema lacks.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Generate a video with any of the 25 video models on Runway') plus the inputs ('from a prompt and optional reference assets'), and explicitly positions itself as 'the general video tool' versus the single-model gen4 routes. An agent can tell exactly what this produces and how it differs from runway_create_gen4_5 and peers without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Names the alternatives and the conditions that select them: single-model routes (runway_create_gen4_5, gen4, gen4_turbo) are 'older' paths, while runway_edit_video_aleph, runway_act_two and runway_lipsync cover video-to-video, performance and lip sync. It also states the wait-vs-poll fork ('the taskId for runway_get_task' when wait is false).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources