Skip to main content
Glama

Price a video

quote_video
Read-only

What a video with these choices costs in credits, and whether the team's balance covers it. Free.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "quote_video"
  }
}

Input Schema

NameRequiredDescriptionDefault
adNoAn ad to build the video like, its moves made for this product: a link of an ad in the Meta Ad Library, an ad's id from that library or from list_ads, which lists TikTok's ads too, or one of the team's own videos as v- and its id from get_video, with - and its part after for any but its first. A Meta Ad Library link not seen before is looked up in that library and counted against the team's ad links of the day. Not with lines or script_id.
keepNoWhat to keep of the ad: structure, the default, or pacing, its pace and its shots alone.
sizeNoThe shape the video is filmed in. 9:16 is the default.
angleNoThe angle the video argues: auto, the default, or one of the angle ids read_product lists for the product. Not with lines, script_id or ad, which argue their own.
countNoHow many videos to make, each a different take. Not with a script, which is made once for each presenter.
scriptNoWhich of its scripts, from 1. 1 by default.
qualityNofast, the default, uses Seedance 2.0 mini for trying ideas; best uses Wan 3.0 for the videos the team publishes; priority uses Wan 3.0 Prime, first in our line, at a higher price of its own, refused while it is not offered. seedance25 selects Seedance 2.5 explicitly, independent of the model used by best. Send these quality values, not model names.
secondsNoThe length: fast videos are 15 seconds, best and priority videos 15 or 30 seconds.
captionsNoCaptions of what is said, on screen. On by default.
languageNoThe language the video is spoken in. Left out, the team's ad language. Arabic, Hungarian and Japanese require quality best or priority.
languagesNoUp to 3 languages to make a script in at once, each its own video at one video's price, the first taking the place of language. Only with script_id, and not with language or lines; a script with words said as typed is made in one language, and the Arabic dialects go together, apart from every other language. Arabic, Hungarian and Japanese require quality best or priority.
placementNoWhere the product is in the video. auto by default.
script_idNoThe id write_scripts answered, to make one of its scripts as a video.
presentersNoPresenter ids from list_presenters. Left out, one is chosen for the product.
resolutionNoThe resolution it is filmed in, a higher one at a higher price: 480p or 720p for fast; 480p, 720p or 1080p for best and priority while 1080p is offered, one not offered being refused with the ones that are. Left out, the one its scripts were written for where script_id names them, else 480p while the team's balance is its free videos, else 720p. An Arabic video whose voice is added after filming is filmed in 720p whatever is asked. quote_video says which.
video_styleNocasual (the default), professional or energetic.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / quality / description
      Previous value: -"fast, the default, uses Seedance 2.0 mini for trying ideas; best uses Wan 3.0 for the videos the team publishes; priority uses Wan 3.0 Prime, first in our line, at a higher price of its own, refused while it is not offered. Send these quality values, not model names."New value: +"fast, the default, uses Seedance 2.0 mini for trying ideas; best uses Wan 3.0 for the videos the team publishes; priority uses Wan 3.0 Prime, first in our line, at a higher price of its own, refused while it is not offered. seedance25 selects Seedance 2.5 explicitly, independent of the model used by best. Send these quality values, not model names."
    • changedInput schema / properties / quality / enum
      Previous value: -[
      -  "fast",
      -  "best",
      -  "priority"
      -]New value: +[
      +  "fast",
      +  "best",
      +  "priority",
      +  "seedance25"
      +]
  2. Changed5 schema fields changed
    • changedInput schema / properties / language / description
      Previous value: -"The language the video is spoken in. Left out, the team's ad language."New value: +"The language the video is spoken in. Left out, the team's ad language. Arabic, Hungarian and Japanese require quality best or priority."
    • changedInput schema / properties / language / enum
      Previous value: -[
      -  "en-us",
      -  "ar-eg",
      -  "ar-ae",
      -  "ar-lb",
      -  "ar",
      -  "ar-ma",
      -  "cs",
      -  "da",
      -  "nl-be",
      -  "nl",
      -  "en-au",
      -  "en-gb",
      -  "fi",
      -  "fr-ca",
      -  "fr",
      -  "de-at",
      -  "de",
      -  "de-ch",
      -  "id",
      -  "it",
      -  "no",
      -  "pl",
      -  "pt-br",
      -  "pt",
      -  "ro",
      -  "es-ar",
      -  "es-419",
      -  "es-mx",
      -  "es",
      -  "sv",
      -  "tr"
      -]New value: +[
      +  "en-us",
      +  "ar-eg",
      +  "ar-ae",
      +  "ar-lb",
      +  "ar",
      +  "ar-ma",
      +  "cs",
      +  "da",
      +  "nl-be",
      +  "nl",
      +  "en-au",
      +  "en-gb",
      +  "fi",
      +  "fr-ca",
      +  "fr",
      +  "de-at",
      +  "de",
      +  "de-ch",
      +  "hu",
      +  "id",
      +  "it",
      +  "ja",
      +  "no",
      +  "pl",
      +  "pt-br",
      +  "pt",
      +  "ro",
      +  "es-ar",
      +  "es-cl",
      +  "es-co",
      +  "es-419",
      +  "es-mx",
      +  "es",
      +  "sv",
      +  "tr"
      +]
    • changedInput schema / properties / languages / description
      Previous value: -"Up to 3 languages to make a script in at once, each its own video at one video's price, the first taking the place of language. Only with script_id, and not with language or lines; a script with words said as typed is made in one language, and the Arabic dialects go together, apart from every other language."New value: +"Up to 3 languages to make a script in at once, each its own video at one video's price, the first taking the place of language. Only with script_id, and not with language or lines; a script with words said as typed is made in one language, and the Arabic dialects go together, apart from every other language. Arabic, Hungarian and Japanese require quality best or priority."
    • changedInput schema / properties / languages / items / enum
      Previous value: -[
      -  "en-us",
      -  "ar-eg",
      -  "ar-ae",
      -  "ar-lb",
      -  "ar",
      -  "ar-ma",
      -  "cs",
      -  "da",
      -  "nl-be",
      -  "nl",
      -  "en-au",
      -  "en-gb",
      -  "fi",
      -  "fr-ca",
      -  "fr",
      -  "de-at",
      -  "de",
      -  "de-ch",
      -  "id",
      -  "it",
      -  "no",
      -  "pl",
      -  "pt-br",
      -  "pt",
      -  "ro",
      -  "es-ar",
      -  "es-419",
      -  "es-mx",
      -  "es",
      -  "sv",
      -  "tr"
      -]New value: +[
      +  "en-us",
      +  "ar-eg",
      +  "ar-ae",
      +  "ar-lb",
      +  "ar",
      +  "ar-ma",
      +  "cs",
      +  "da",
      +  "nl-be",
      +  "nl",
      +  "en-au",
      +  "en-gb",
      +  "fi",
      +  "fr-ca",
      +  "fr",
      +  "de-at",
      +  "de",
      +  "de-ch",
      +  "hu",
      +  "id",
      +  "it",
      +  "ja",
      +  "no",
      +  "pl",
      +  "pt-br",
      +  "pt",
      +  "ro",
      +  "es-ar",
      +  "es-cl",
      +  "es-co",
      +  "es-419",
      +  "es-mx",
      +  "es",
      +  "sv",
      +  "tr"
      +]
    • changedInput schema / properties / quality / description
      Previous value: -"fast, the default, for trying ideas; best, for the videos the team publishes; or priority: best made sooner, first in our line, at a higher price of its own, refused while it is not offered."New value: +"fast, the default, uses Seedance 2.0 mini for trying ideas; best uses Wan 3.0 for the videos the team publishes; priority uses Wan 3.0 Prime, first in our line, at a higher price of its own, refused while it is not offered. Send these quality values, not model names."
  3. Changed5 schema fields changed
    • changedInput schema / properties / ad / description
      Previous value: -"An ad to build the video like, its moves made for this product: a link of an ad in the Meta Ad Library, an ad's id from list_ads or the library, or one of the team's own videos as v- and its id from get_video, with - and its part after for any but its first. A library link not seen before is looked up in the library and counted against the team's ad links of the day. Not with lines or script_id."New value: +"An ad to build the video like, its moves made for this product: a link of an ad in the Meta Ad Library, an ad's id from that library or from list_ads, which lists TikTok's ads too, or one of the team's own videos as v- and its id from get_video, with - and its part after for any but its first. A Meta Ad Library link not seen before is looked up in that library and counted against the team's ad links of the day. Not with lines or script_id."
    • changedInput schema / properties / quality / description
      Previous value: -"fast (the default) or best."New value: +"fast, the default, for trying ideas; best, for the videos the team publishes; or priority: best made sooner, first in our line, at a higher price of its own, refused while it is not offered."
    • changedInput schema / properties / quality / enum
      Previous value: -[
      -  "fast",
      -  "best"
      -]New value: +[
      +  "fast",
      +  "best",
      +  "priority"
      +]
    • addedInput schema / properties / resolution
      Added value: +{
      +  "description": "The resolution it is filmed in, a higher one at a higher price: 480p or 720p for fast; 480p, 720p or 1080p for best and priority while 1080p is offered, one not offered being refused with the ones that are. Left out, the one its scripts were written for where script_id names them, else 480p while the team's balance is its free videos, else 720p. An Arabic video whose voice is added after filming is filmed in 720p whatever is asked. quote_video says which.",
      +  "enum": [
      +    "480p",
      +    "720p",
      +    "1080p"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / seconds / description
      Previous value: -"The length: fast videos are 15 seconds, best videos 15 or 30 seconds."New value: +"The length: fast videos are 15 seconds, best and priority videos 15 or 30 seconds."
  4. First observed

TDQS

A3.5/5.0
Behavior3/5

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

The annotations already declare readOnlyHint=true and destructiveHint=false, so the safety profile is covered. The description adds two useful facts beyond that: the call is free, and it returns both a credit cost and a balance-coverage verdict. It says nothing about whether a quote is binding, whether it expires, or that resolving a new Meta ad link consumes the team's daily ad-link allowance.

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

Conciseness5/5

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

Two short sentences with no waste, front-loaded with what the tool returns and finished with the cost of calling it. Nothing is repeated from the schema.

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

Completeness3/5

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

With no output schema, the description usefully names the two return values (credit cost and whether the balance covers it), which is the main burden it had to carry. But for a 16-parameter pricing tool that gates a costly make_video call, the absence of any workflow or prerequisite guidance leaves the definition only minimally complete.

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% across all 16 parameters, including the intricate interactions between script_id, languages, language, quality and resolution. The description adds no parameter meaning beyond the schema, so the baseline 3 applies.

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 names a specific verb ('costs in credits') and resource ('a video with these choices'), and adds that it reports balance coverage. That is more precise than the title alone. It never distinguishes itself from the sibling quote_image_ads or quote_product_video, so an agent must infer the scope from the name.

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

Usage Guidelines3/5

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

The word 'Free' implies you can call this before committing to make_video, but that workflow is never stated. There is no explicit when-to-use, no when-not-to-use, and no naming of the alternative pricing tools. Usage is implied rather than guided.

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.