Skip to main content
Glama

Import a shared asset

import_asset
Idempotent

Import one image or song up to 32 MiB: an attached file (file), or a public https link (url, for Claude and hosts with no attachments). logo: true marks the brand’s logo. Returns an asset_staging_key for create_video’s asset_staging_keys (or music_staging_key for a song), good for seven days. Not for footage (edit_video).

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": {
      "operation_id": "<operation_id>"
    },
    "name": "import_asset"
  }
}

Input Schema

NameRequiredDescriptionDefault
urlNoA public https link to the image (PNG, JPEG, WebP, GIF) or song (MP3, WAV, M4A), up to 32 MiB: the file itself, not a page that shows it.
fileNoA file attached in ChatGPT. Hosts that cannot attach files send url instead.
logoNotrue when the image is the brand's logo: the video uses it as the brand's mark.
file_nameNoA name for the file.
operation_idYesSame id retries run once.

Output Schema

NameRequiredDescriptionDefault
codeNo
costNo
errorNo
stateNo
statusNo
dry_runNo
messageNo
plan_idNo
style_idNo
video_idNo
availableNo
import_idNo
mime_typeNo
output_idNo
studio_urlNo
version_idNo
asset_staging_keyNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • removedInput schema / properties / operation_id / pattern
      Removed value: -"^[a-zA-Z0-9_.:-]{1,100}$"
  2. Changed2 schema fields changed
    • changedInput schema / properties / operation_id / description
      Previous value: -"A retry with the same id runs once."New value: +"Same id retries run once."
    • changedInput schema / properties / url / description
      Previous value: -"A public https link to the image (PNG, JPEG, WebP, GIF) or song (MP3, WAV, M4A), up to 32 MiB. Use it from Claude or any host that cannot attach a file: the direct link to the file itself, not a page that shows it."New value: +"A public https link to the image (PNG, JPEG, WebP, GIF) or song (MP3, WAV, M4A), up to 32 MiB: the file itself, not a page that shows it."
  3. Changed1 schema field changed
    • changedInput schema / properties / operation_id / description
      Previous value: -"The same id on a retry runs it once; a new id is a new request."New value: +"A retry with the same id runs once."
  4. Changed2 schema fields changed
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • addedInput schema / properties / operation_id / description
      Added value: +"The same id on a retry runs it once; a new id is a new request."
  5. Changed5 schema fields changed
    • addedInput schema / properties / file / description
      Added value: +"A file attached in ChatGPT. Hosts that cannot attach files send url instead."
    • addedInput schema / properties / file_name
      Added value: +{
      +  "description": "A name for the file.",
      +  "maxLength": 120,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / logo
      Added value: +{
      +  "description": "true when the image is the brand's logo: the video uses it as the brand's mark.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / url
      Added value: +{
      +  "description": "A public https link to the image (PNG, JPEG, WebP, GIF) or song (MP3, WAV, M4A), up to 32 MiB. Use it from Claude or any host that cannot attach a file: the direct link to the file itself, not a page that shows it.",
      +  "format": "uri",
      +  "maxLength": 2000,
      +  "type": "string"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "operation_id",
      -  "file"
      -]New value: +[
      +  "operation_id"
      +]
  6. Changed1 schema field changed
    • changedInput schema / $schema
      Previous value: -"https://json-schema.org/draft/2020-12/schema"New value: +"http://json-schema.org/draft-07/schema#"
  7. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "description": "Clypmint import_asset result. Error results carry error; successful requests expose the identifiers and state available for the next step. Signed media stays in private metadata.",
      +  "properties": {
      +    "asset_staging_key": {
      +      "type": "string"
      +    },
      +    "available": {
      +      "type": "boolean"
      +    },
      +    "code": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "cost": {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    "dry_run": {
      +      "type": "boolean"
      +    },
      +    "error": {
      +      "type": "string"
      +    },
      +    "import_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "message": {
      +      "type": "string"
      +    },
      +    "mime_type": {
      +      "type": "string"
      +    },
      +    "output_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "plan_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "state": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "status": {
      +      "type": [
      +        "string",
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "studio_url": {
      +      "format": "uri",
      +      "type": "string"
      +    },
      +    "style_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "version_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "video_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  8. Changed1 schema field changed
    • changedInput schema / properties / file / required
      Previous value: -[
      -  "download_url",
      -  "file_id",
      -  "mime_type",
      -  "file_name"
      -]New value: +[
      +  "download_url",
      +  "file_id"
      +]
  9. Added

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare a non-read-only, open-world, idempotent, non-destructive mutation, and the description adds context beyond that: the 32 MiB ceiling, the seven-day lifetime of the returned staging key, and how the result feeds create_video. It stops short of permission or failure-mode details, but for an import tool the key behavioral facts are present.

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 verb, resource and size limit, then the input modes, then the return value, then the exclusion. Every clause carries information, though the density of colon-delimited asides makes it slightly harder to scan than a clean sentence-per-idea layout.

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 a five-parameter, nested-object, open-world mutation with an output schema, the description covers scope, size limit, mode selection, the logo flag's effect, the returned staging key and its expiry, and the excluded use case. Nothing an agent needs to call it correctly is missing.

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 url, file, logo, file_name and operation_id in detail. The description adds only the host-conditional framing for url and the downstream use of logo, leaving it at the baseline for a fully documented schema.

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?

The description opens with a specific verb and resource plus a hard bound ('Import one image or song up to 32 MiB') and immediately enumerates the two input modes (file vs url). It also names what it is not ('Not for footage (edit_video)'), so an agent can distinguish it from edit_video and import_media without opening a 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?

It states the selection rule between the two modes explicitly ('url, for Claude and hosts with no attachments'), gives a purpose flag ('logo: true marks the brand's logo'), and routes the excluded case to a named alternative ('Not for footage (edit_video)'). When-to-use and when-not-to-use are both covered.

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