Skip to main content
Glama

Restyle video

restyle_video

Restyles an existing video clip with an art-style preset or a custom prompt. Supports v1/v2/v3 presets; v3 requires a supplied reference image and positive source-video width and height. Starts a background job that costs credits; returns a project id for wait_for_video_project. Before choosing settings, read get_account_info and the current parameter constraints. A listed model, resolution, duration or count is not necessarily available together or on this account. Preserve explicit requirements and all supplied inputs; explain a genuine block instead of submitting an incompatible request. Account balance alone does not prove a request is affordable. Use the named attachment fields first for ChatGPT files. Ask which file goes where if their roles are unclear. If a file fails, ask the user to attach it again and keep the requested settings.

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": {
      "start_seconds": "<start_seconds>",
      "end_seconds": "<end_seconds>",
      "style": "<style>",
      "assets": "<assets>"
    },
    "name": "restyle_video"
  }
}

Input Schema

NameRequiredDescriptionDefault
fpsNoSource video FPS for v3 frame limits and estimated credits. Defaults to 30; final charges settle to rendered frames.
nameNoOptional project name for identifying this output. Omit to use the API's default project name.Video To Video - dateTime
styleYesArt preset, rendering version, model and prompt controls for restyling the video.
videoNoAttach the video from ChatGPT for this input. Set assets.video_source to file.
widthNoSource video width in integer pixels. Required and positive for v3; ignored for v1/v2.
assetsYesProvide the assets for video-to-video. For video, The `video_source` field determines whether `video_file_path` or `youtube_url` field is used
heightNoSource video height in integer pixels. Required and positive for v3; ignored for v1/v2.
end_secondsYesEnd time of your clip (seconds). Must be greater than start_seconds.
first_frameNoAttach the first frame from ChatGPT for this input.
start_secondsYesStart time of your clip (seconds). Must be ≥ 0.
fps_resolutionNoDetermines whether the resulting video will have the same frame per second as the original video, or half. * `FULL` - the result video will have the same FPS as the input video * `HALF` - the result video will have half the FPS as the input videoHALF

Output Schema

NameRequiredDescriptionDefault
idYesUnique ID of the video. Use it with the [Get video Project API](https://docs.magichour.ai/api-reference/video-projects/get-video-details) to fetch status and downloads.
credits_chargedYesThe amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video. If video generation fails, credits will be refunded, and this field will be updated to include the refund.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / first_frame
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Attach the first frame from ChatGPT for this input.",
      +  "properties": {
      +    "download_url": {
      +      "description": "Exact HTTPS download URL supplied for the native ChatGPT attachment, including its signed query.",
      +      "title": "Download Url",
      +      "type": "string"
      +    },
      +    "file_id": {
      +      "description": "Native ChatGPT file identifier paired with download_url; not a local filesystem path.",
      +      "title": "File Id",
      +      "type": "string"
      +    },
      +    "file_name": {
      +      "default": "",
      +      "description": "Original attachment filename, when supplied by ChatGPT.",
      +      "title": "File Name",
      +      "type": "string"
      +    },
      +    "mime_type": {
      +      "default": "",
      +      "description": "Attachment MIME type, when supplied by ChatGPT.",
      +      "title": "Mime Type",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "download_url",
      +    "file_id"
      +  ],
      +  "title": "ChatGPTFile",
      +  "type": "object"
      +}
    • addedInput schema / properties / video
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Attach the video from ChatGPT for this input. Set assets.video_source to file.",
      +  "properties": {
      +    "download_url": {
      +      "description": "Exact HTTPS download URL supplied for the native ChatGPT attachment, including its signed query.",
      +      "title": "Download Url",
      +      "type": "string"
      +    },
      +    "file_id": {
      +      "description": "Native ChatGPT file identifier paired with download_url; not a local filesystem path.",
      +      "title": "File Id",
      +      "type": "string"
      +    },
      +    "file_name": {
      +      "default": "",
      +      "description": "Original attachment filename, when supplied by ChatGPT.",
      +      "title": "File Name",
      +      "type": "string"
      +    },
      +    "mime_type": {
      +      "default": "",
      +      "description": "Attachment MIME type, when supplied by ChatGPT.",
      +      "title": "Mime Type",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "download_url",
      +    "file_id"
      +  ],
      +  "title": "ChatGPTFile",
      +  "type": "object"
      +}
  2. Changed5 schema fields changed
    • changedInput schema / properties / name / description
      Previous value: -"Give your video a custom name for easy identification."New value: +"Optional project name for identifying this output. Omit to use the API's default project name."
    • addedInput schema / properties / style / description
      Added value: +"Art preset, rendering version, model and prompt controls for restyling the video."
    • addedInput schema / properties / style / properties / art_style / description
      Added value: +"Art-style preset to apply to the source video. The preset determines the default rendering version, model and prompt; check their compatibility before generation."
    • changedInput schema / properties / style / properties / model / description
      Previous value: -"Select a listed rendering model for the art style. `default` uses the selected art style's default model."New value: +"* `Dreamshaper` - a good all-around model that works for both animations as well as realism.\n* `Absolute Reality` - better at realism, but you'll often get similar results with Dreamshaper as well.\n* `Flat 2D Anime` - best for a flat illustration style that's common in most anime.\n* `Default` - the v3 model.\n* `default` - use the default recommended model for the selected art style."
    • changedInput schema / properties / style / properties / version / description
      Previous value: -"Select restyling version `v1` or `v2`. `default` uses the selected art style's default version. Some styles default to v3, which this API does not support. For `Studio Ghibli`, explicitly set `version` to `v2` for its supported preset."New value: +"* `v1` - more detail, closer prompt adherence, and frame-by-frame previews.\n* `v2` - faster, more consistent, and less noisy.\n* `v3` - consistent styling guided by a caller-supplied reference image. Requires assets.initial_image_path and positive width/height.\n* `default` - use the selected art style's default version, including v3."
  3. Changed1 schema field changed
    • changedInput schema / properties / style / properties / art_style / example
      Previous value: -"Minecraft"New value: +"3D Render"
  4. Changed8 schema fields changed
    • addedInput schema / properties / assets / properties / initial_image_path
      Added value: +{
      +  "description": "Required for v3: an uploaded reference image path, or a completed image output owned by you. The caller supplies this image; the API does not generate it.",
      +  "example": "api-assets/id/reference.png",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / fps
      Added value: +{
      +  "default": 30,
      +  "description": "Source video FPS for v3 frame limits and estimated credits. Defaults to 30; final charges settle to rendered frames.",
      +  "example": 30,
      +  "minimum": 1,
      +  "type": "number"
      +}
    • addedInput schema / properties / height
      Added value: +{
      +  "description": "Source video height in integer pixels. Required and positive for v3; ignored for v1/v2.",
      +  "example": 704,
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • changedInput schema / properties / style / properties / art_style / enum
      Previous value: -[
      -  "Minecraft",
      -  "Watercolor",
      -  "Pixel",
      -  "Retro Sci-Fi",
      -  "Lego",
      -  "Origami",
      -  "Ghost",
      -  "Sub-Zero",
      -  "Studio Ghibli",
      -  "Comic",
      -  "Impressionism",
      -  "Master Chief",
      -  "Solid Snake",
      -  "Street Fighter",
      -  "Hologram",
      -  "GTA",
      -  "Clay",
      -  "Mystique",
      -  "Dragonball Z",
      -  "Mario",
      -  "Samurai",
      -  "Spartan",
      -  "Boba Fett",
      -  "3D Render",
      -  "Airbender",
      -  "Android",
      -  "Anime Warrior",
      -  "Armored Knight",
      -  "Assassin's Creed",
      -  "Avatar",
      -  "Black Spiderman",
      -  "Bold Anime",
      -  "Celestial Skin",
      -  "Chinese Swordsmen",
      -  "Cyberpunk",
      -  "Cypher",
      -  "Dark Fantasy",
      -  "Future Bot",
      -  "Futuristic Fantasy",
      -  "Ghibli Anime",
      -  "Gundam",
      -  "Illustration",
      -  "Ink",
      -  "Ink Poster",
      -  "Jinx",
      -  "Knight",
      -  "Link",
      -  "Marble",
      -  "Mech",
      -  "Naruto",
      -  "Neon Dream",
      -  "No Art Style",
      -  "Oil Painting",
      -  "On Fire",
      -  "Painterly Anime",
      -  "Pixar",
      -  "Power Armor",
      -  "Power Ranger",
      -  "Radiant Anime",
      -  "Realistic Anime",
      -  "Realistic Pixar",
      -  "Retro Anime",
      -  "Samurai Bot",
      -  "Sharp Anime",
      -  "Soft Anime",
      -  "Starfield",
      -  "The Void",
      -  "Tomb Raider",
      -  "Underwater",
      -  "Van Gogh",
      -  "Viking",
      -  "Western Anime",
      -  "Wu Kong",
      -  "Wuxia Anime",
      -  "Zelda"
      -]New value: +[
      +  "WWI Soldier",
      +  "Minecraft",
      +  "Watercolor",
      +  "Chalkboard",
      +  "Pixel",
      +  "Rick & Morty",
      +  "Sketch",
      +  "Roblox",
      +  "Hitman",
      +  "Joker",
      +  "Darth Maul",
      +  "Jon Snow",
      +  "Dexter's Lab",
      +  "Darth Vader",
      +  "Shadow",
      +  "Bronze Statue",
      +  "Toy Story",
      +  "Puppets",
      +  "Yarn",
      +  "Obsidian Gods",
      +  "Claymation",
      +  "James Bond",
      +  "Retro Sci-Fi",
      +  "Chrome",
      +  "Lego",
      +  "Origami",
      +  "Scorpion",
      +  "Ash Ketchum",
      +  "Terra Cotta Soldiers",
      +  "Obi-Wan",
      +  "Venom",
      +  "Scream",
      +  "Matrix",
      +  "Crusader",
      +  "Batman",
      +  "Superman",
      +  "Deadpool",
      +  "Ghost",
      +  "Iron Man",
      +  "Warzone",
      +  "Thanos",
      +  "Tarzan",
      +  "Polish Hussar",
      +  "Gladiators",
      +  "Grim Reaper",
      +  "Hulk",
      +  "Candle",
      +  "Anime Ninja",
      +  "Sand Sculpture",
      +  "Spiderman",
      +  "Ash Skeleton",
      +  "Sub-Zero",
      +  "Hades",
      +  "Studio Ghibli",
      +  "Comic",
      +  "Gojo",
      +  "Diorama",
      +  "Mad Max",
      +  "Dragon Rider Knight",
      +  "Nightmare",
      +  "Pennywise",
      +  "One Punch Man",
      +  "Anime Aviator",
      +  "Slime",
      +  "Sandpaper",
      +  "Spray Paint",
      +  "Flash",
      +  "Impressionism",
      +  "Master Chief",
      +  "Solid Snake",
      +  "Street Fighter",
      +  "Hologram",
      +  "Plague Doctor",
      +  "South Park",
      +  "GTA",
      +  "Chess",
      +  "Chalk Dust",
      +  "Clay",
      +  "Peely",
      +  "Pepe the Frog",
      +  "Tarot Card",
      +  "Ninja Turtle",
      +  "Tribal Warrior",
      +  "Bubble Wrap",
      +  "Glass Sculpture",
      +  "Frankenstein",
      +  "Napoleon Painting",
      +  "Pokémon Trainer",
      +  "Invader Zim",
      +  "Terminator",
      +  "Cuphead Devil",
      +  "Cyclops",
      +  "Luigi",
      +  "Mythra",
      +  "Phoenix Wright",
      +  "Swamp Creatures",
      +  "Vikings",
      +  "Fossils",
      +  "Cyber Samurai",
      +  "Ice and Fire",
      +  "Braveheart",
      +  "Fire Golems",
      +  "Golden Scarabs",
      +  "Black Ink",
      +  "Lich King",
      +  "WWII Paratrooper",
      +  "101 Dalmatians",
      +  "8-Bit Angel",
      +  "Ace (One Piece)",
      +  "Aviator",
      +  "Bagheera",
      +  "Diablo",
      +  "C-3PO",
      +  "Qilin",
      +  "Crusader Zombie",
      +  "Daredevil",
      +  "Statue of David",
      +  "Doctor Doom",
      +  "White Walker",
      +  "Bioshock",
      +  "Jason Voorhees",
      +  "Kai’Sa",
      +  "Killer Croc",
      +  "Mechanical Scorpion",
      +  "Metallic Angel",
      +  "Spider-Venom",
      +  "Mystique",
      +  "Nathan Drake",
      +  "Wendingo",
      +  "Nautilus",
      +  "Nosferatu",
      +  "Gray NPC",
      +  "Orc",
      +  "Sans Undertale",
      +  "Spiderman 2099",
      +  "TF2 Spy",
      +  "Sulley",
      +  "The Creeper",
      +  "X-Ray Soldier",
      +  "Zeus (Disney)",
      +  "Zombie",
      +  "Eclipse",
      +  "Nebula",
      +  "Polygon",
      +  "Raiden",
      +  "Celestial",
      +  "Wool Beast",
      +  "Chibi",
      +  "Albert Einstein",
      +  "Alucard",
      +  "Confederate Soldier",
      +  "Fabric",
      +  "Avian Aviator",
      +  "FNAF",
      +  "Mushroom",
      +  "Beast",
      +  "Blitzcrank",
      +  "Captain America",
      +  "Crystal Knight",
      +  "Darkseid",
      +  "Dio Brando",
      +  "Doctor Fate",
      +  "Green Goblin",
      +  "Groot",
      +  "Rooster",
      +  "Devil",
      +  "Kenshiro",
      +  "Martian",
      +  "Mech Dragon",
      +  "Prince",
      +  "Pyke",
      +  "Robin",
      +  "RoboCop",
      +  "Samara Morgan",
      +  "Shiva",
      +  "Singed",
      +  "Star Trek",
      +  "Steampunk Captain",
      +  "Tyrande Whisperwind",
      +  "Predator",
      +  "Yeti",
      +  "Marble Sculpture",
      +  "Washi",
      +  "Woodcut",
      +  "Dark Reaper",
      +  "Mech Valkryie",
      +  "Renaissance Painting",
      +  "Renaissance Sketch",
      +  "Comic Batman",
      +  "Astronaut",
      +  "Dragonball Z",
      +  "Watercolor Painting",
      +  "Cinematic",
      +  "Optimus Prime",
      +  "Mario",
      +  "Poseidon",
      +  "Moss Spirits",
      +  "Green Lantern",
      +  "Detective Conan",
      +  "Prince of Persia",
      +  "King Arthur",
      +  "Wolverine",
      +  "Statue of Liberty",
      +  "Black Panther",
      +  "Iron Valor",
      +  "Legend of Zelda",
      +  "Mandalorian",
      +  "Aquaman",
      +  "Cloud Strife",
      +  "Samurai",
      +  "John Wick",
      +  "Freddy Krueger",
      +  "Hercules",
      +  "Spartan",
      +  "Shrek",
      +  "Solar Flare",
      +  "Scottish Highlander",
      +  "Desert Wraith",
      +  "Kung Fu",
      +  "Porcelain",
      +  "Molten Rock",
      +  "Apocalyptic Marble",
      +  "Ash",
      +  "Popeye",
      +  "Simpsons",
      +  "Liquid Metal",
      +  "Cave Painting",
      +  "Crayon",
      +  "Scuba Diver",
      +  "Vampire",
      +  "Miner",
      +  "Origami Samurai",
      +  "Qing Dynasty",
      +  "Wax",
      +  "Bastet",
      +  "Bellwether",
      +  "Hobbits",
      +  "Day of the Dead",
      +  "Engineer",
      +  "Finn",
      +  "Huggy Wuggy",
      +  "Krillin",
      +  "Hugging Bear",
      +  "Malfurion Stormrage",
      +  "Mickey Mouse",
      +  "Might Guy",
      +  "Nala",
      +  "Naruto Uzumaki",
      +  "Oni",
      +  "Piccolo",
      +  "Raiden (Metal Gear)",
      +  "Rocket Raccoon",
      +  "Russell (Up)",
      +  "Shark Gladiator",
      +  "The Mask",
      +  "The Mummy",
      +  "The Nun",
      +  "Indiana Jones",
      +  "Aragorn",
      +  "Foam",
      +  "Jello",
      +  "Dune",
      +  "Anubis",
      +  "Genghis Khan",
      +  "Ink Blot",
      +  "Ken",
      +  "Kratos",
      +  "Lara Croft",
      +  "Legolas",
      +  "Luffy",
      +  "Oil Slick",
      +  "Mech Angels",
      +  "Pencil Sketch",
      +  "Gargoyle",
      +  "Ink Bottle",
      +  "Marble Chesspieces",
      +  "Coral",
      +  "Solar Eclipse",
      +  "Molten Beasts",
      +  "Porcelain Nobles",
      +  "Calligraphy",
      +  "Paper Lantern",
      +  "Sandstorm Gladiator",
      +  "Insect",
      +  "Wool Giant",
      +  "Rusted Valor",
      +  "Pharaoh",
      +  "Paper Cut",
      +  "Wax Museum",
      +  "Blood Ink",
      +  "Ink Samurai",
      +  "Demon Hunter",
      +  "Spirit Fox",
      +  "Baroque",
      +  "Clouds",
      +  "Goblin Inventor",
      +  "HK-47",
      +  "Karl Marx",
      +  "Da Vinci",
      +  "Cracked Marble",
      +  "Medieval Painting",
      +  "Melted Wax",
      +  "Socrates",
      +  "Sumo Wrestler",
      +  "Postapocalyptic",
      +  "William Wallace",
      +  "Leatherface",
      +  "Regan MacNeil",
      +  "Frieza",
      +  "Cell",
      +  "Sidewalk Chalk",
      +  "Altair Ibn-La’Ahad",
      +  "American Gothic",
      +  "Aztec",
      +  "Banzai",
      +  "Beowulf",
      +  "Boba Fett",
      +  "Carl Fredricksen",
      +  "Carnage",
      +  "Cheetah",
      +  "Portal",
      +  "Chewbacca",
      +  "Thor",
      +  "Chucky",
      +  "Cinderella",
      +  "The Witcher",
      +  "Cursed Samurai",
      +  "Deathstroke",
      +  "Dieselpunk",
      +  "Din Djarin",
      +  "Donald Duck",
      +  "Edward Elric",
      +  "Joy vs. Anger",
      +  "Gandalf",
      +  "Native American",
      +  "Ghost Rider",
      +  "Gimli",
      +  "Girl with Pearl Earring",
      +  "GLaDOS",
      +  "Hades (Disney)",
      +  "Han Solo",
      +  "Hellboy",
      +  "Japanese Raijin",
      +  "Japanese Susanoo",
      +  "Jarvan",
      +  "Levi Ackerman",
      +  "John Darling",
      +  "Fury Road",
      +  "Maestro Hulk",
      +  "Man Bat",
      +  "Mike Wazowski",
      +  "Minotaur King",
      +  "Wukong",
      +  "Robin Hood",
      +  "Samus",
      +  "Sarah Kerrigan",
      +  "Shadow Phoenix",
      +  "Simón Bolívar",
      +  "The Flash",
      +  "Leprechaun",
      +  "The Thinker",
      +  "Thrall",
      +  "Tree Ent King",
      +  "Alien",
      +  "Erron Black",
      +  "3D Render",
      +  "Airbender",
      +  "Android",
      +  "Anime Warrior",
      +  "Armored Knight",
      +  "Assassin's Creed",
      +  "Avatar",
      +  "Black Spiderman",
      +  "Bold Anime",
      +  "Celestial Skin",
      +  "Chinese Swordsmen",
      +  "Cyberpunk",
      +  "Cypher",
      +  "Dark Fantasy",
      +  "Future Bot",
      +  "Futuristic Fantasy",
      +  "Ghibli Anime",
      +  "Gundam",
      +  "Illustration",
      +  "Ink",
      +  "Ink Poster",
      +  "Jinx",
      +  "Knight",
      +  "Link",
      +  "Marble",
      +  "Mech",
      +  "Naruto",
      +  "Neon Dream",
      +  "No Art Style",
      +  "Oil Painting",
      +  "On Fire",
      +  "Painterly Anime",
      +  "Pixar",
      +  "Power Armor",
      +  "Power Ranger",
      +  "Radiant Anime",
      +  "Realistic Anime",
      +  "Realistic Pixar",
      +  "Retro Anime",
      +  "Samurai Bot",
      +  "Sharp Anime",
      +  "Soft Anime",
      +  "Starfield",
      +  "The Void",
      +  "Tomb Raider",
      +  "Underwater",
      +  "Van Gogh",
      +  "Viking",
      +  "Western Anime",
      +  "Wu Kong",
      +  "Wuxia Anime",
      +  "Zelda"
      +]
    • changedInput schema / properties / style / properties / model / enum
      Previous value: -[
      -  "Dreamshaper",
      -  "Absolute Reality",
      -  "Flat 2D Anime",
      -  "Soft Anime",
      -  "Kaywaii",
      -  "Western Anime",
      -  "3D Anime",
      -  "default"
      -]New value: +[
      +  "Dreamshaper",
      +  "Absolute Reality",
      +  "Flat 2D Anime",
      +  "Soft Anime",
      +  "Kaywaii",
      +  "Western Anime",
      +  "3D Anime",
      +  "Default",
      +  "default"
      +]
    • addedInput schema / properties / style / properties / model / x-sideko-enum-names
      Added value: +{
      +  "Default": "DefaultV3",
      +  "default": "Default"
      +}
    • changedInput schema / properties / style / properties / version / enum
      Previous value: -[
      -  "v1",
      -  "v2",
      -  "default"
      -]New value: +[
      +  "v1",
      +  "v2",
      +  "v3",
      +  "default"
      +]
    • addedInput schema / properties / width
      Added value: +{
      +  "description": "Source video width in integer pixels. Required and positive for v3; ignored for v1/v2.",
      +  "example": 1024,
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
  5. Added

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already declare this is a non-read-only, non-idempotent, open-world operation, and the description adds genuinely new context: it starts a background job, consumes credits, and returns a project id for polling. The v3 prerequisites (reference image plus positive width/height) are also flagged. It does not explain failure modes or whether re-submitting the same request is safe.

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

Conciseness3/5

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

The core capability and the async/credits model are front-loaded, which is good. However, several trailing sentences are generic policy boilerplate ('Preserve explicit requirements and all supplied inputs', 'Account balance alone does not prove a request is affordable') that dilute a tool definition rather than inform invocation.

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

Completeness4/5

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

For an 11-parameter tool with nested assets/style objects, an output schema, and full annotations, the description covers the important operational gaps: job lifecycle, credit cost, and the v3-only input requirements. Clip trimming semantics and attachment-field routing are only lightly touched, but the schema handles them.

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%, so the schema already documents every field including version, art_style, and the v3 width/height requirement. The description restates the v3 cross-field constraint but adds no syntax, format, or defaulting details beyond it. Baseline 3 is appropriate when the schema carries this much weight.

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

Purpose4/5

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

The description opens with a specific verb and resource: 'Restyles an existing video clip with an art-style preset or a custom prompt.' That is clearly distinct from siblings such as create_video_from_text or upscale_video. It never explicitly contrasts itself with the closest alternatives (edit_video, replace_character_in_video), so it stops short of full differentiation.

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

Usage Guidelines4/5

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

It gives real preconditions ('read get_account_info and the current parameter constraints') and routes the caller to the follow-up tool ('returns a project id for wait_for_video_project'). It also sets a behavioral expectation for blocked requests. What is missing is an explicit statement of when to pick this over the other video-editing siblings.

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.