Skip to main content
Glama

Get capture asset

get_capture_asset
Read-onlyIdempotent

Materialize an archived resource or stored screenshot/MP4/WebM by relative path. Returns path, URI, hash, MIME and size without embedding bytes. Discover resources with list_archived_assets/get_fonts and recordings with get_page_artifacts. Full page JSON is excluded.

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": {
      "product": "<product>",
      "platform": "<platform>",
      "version": "<version>",
      "path": "<path>"
    },
    "name": "get_capture_asset"
  }
}

Input Schema

NameRequiredDescriptionDefault
pathYesCapture-relative archived file path returned by an inventory tool. Use forward slashes; absolute paths and traversal are not allowed.
productYesProduct key, for example finance-ozon-ru
versionYesExact capture version returned by list_versions. Pin the same version across related calls; do not use latest as an alias.
platformYesPlatform type ID from list_platforms.options.platforms[].id (backend CatalogPlatform.view). Use backend IDs verbatim; desktop/mobile are current examples. Environment is selected separately.
environmentNoEnvironment ID from the selected backend platform type in list_platforms.options.platforms[].environments[].id (backend implementation). Omit only when the version has one captured environment. Use captured pairs from list_platforms/list_versions for actual availability.

Output Schema

NameRequiredDescriptionDefault
pathYesText value
assetYes
productYesproduct
versionYesversion
platformYesplatform
environmentYesenvironment

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed10 schema fields changed
    • changedOutput schema / additionalProperties
      Previous value: -falseNew value: +true
    • changedOutput schema / description
      Previous value: -"Structured result. Existing text or image content remains available in content."New value: +"Archived media materialization"
    • addedOutput schema / properties / asset
      Added value: +{
      +  "$ref": "#/$defs/asset"
      +}
    • addedOutput schema / properties / environment
      Added value: +{
      +  "description": "environment",
      +  "type": "string"
      +}
    • addedOutput schema / properties / path
      Added value: +{
      +  "description": "Text value",
      +  "type": "string"
      +}
    • addedOutput schema / properties / platform
      Added value: +{
      +  "description": "platform",
      +  "type": "string"
      +}
    • addedOutput schema / properties / product
      Added value: +{
      +  "description": "product",
      +  "type": "string"
      +}
    • removedOutput schema / properties / result
      Removed value: -{
      -  "additionalProperties": true,
      -  "description": "Archived media materialization",
      -  "properties": {
      -    "asset": {
      -      "$ref": "#/$defs/asset"
      -    },
      -    "environment": {
      -      "description": "environment",
      -      "type": "string"
      -    },
      -    "path": {
      -      "description": "Text value",
      -      "type": "string"
      -    },
      -    "platform": {
      -      "description": "platform",
      -      "type": "string"
      -    },
      -    "product": {
      -      "description": "product",
      -      "type": "string"
      -    },
      -    "version": {
      -      "description": "version",
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "product",
      -    "platform",
      -    "environment",
      -    "version",
      -    "path",
      -    "asset"
      -  ],
      -  "type": "object"
      -}
    • addedOutput schema / properties / version
      Added value: +{
      +  "description": "version",
      +  "type": "string"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "result"
      -]New value: +[
      +  "product",
      +  "platform",
      +  "environment",
      +  "version",
      +  "path",
      +  "asset"
      +]
  2. Changed5 schema fields changed
    • addedInput schema / properties / path / description
      Added value: +"Capture-relative archived file path returned by an inventory tool. Use forward slashes; absolute paths and traversal are not allowed."
    • addedInput schema / properties / platform / description
      Added value: +"Platform type ID from list_platforms.options.platforms[].id (backend CatalogPlatform.view). Use backend IDs verbatim; desktop/mobile are current examples. Environment is selected separately."
    • addedInput schema / properties / product / description
      Added value: +"Product key, for example finance-ozon-ru"
    • addedInput schema / properties / version / description
      Added value: +"Exact capture version returned by list_versions. Pin the same version across related calls; do not use latest as an alias."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "asset": {
      +      "additionalProperties": true,
      +      "description": "Materialized or original media reference; inline content is optional",
      +      "properties": {
      +        "content": {
      +          "description": "Inline base64 bytes or reference when requested and within size limit",
      +          "type": "string"
      +        },
      +        "hash": {
      +          "description": "hash",
      +          "type": "string"
      +        },
      +        "kind": {
      +          "description": "kind",
      +          "type": "string"
      +        },
      +        "mime": {
      +          "description": "mime",
      +          "type": "string"
      +        },
      +        "path": {
      +          "anyOf": [
      +            {
      +              "description": "Text value",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "size": {
      +          "description": "Byte count or source-reference length",
      +          "type": "integer"
      +        },
      +        "uri": {
      +          "anyOf": [
      +            {
      +              "description": "Text value",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        }
      +      },
      +      "required": [
      +        "kind",
      +        "mime",
      +        "size",
      +        "hash",
      +        "path",
      +        "uri"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "description": "Structured result. Existing text or image content remains available in content.",
      +  "properties": {
      +    "result": {
      +      "additionalProperties": true,
      +      "description": "Archived media materialization",
      +      "properties": {
      +        "asset": {
      +          "$ref": "#/$defs/asset"
      +        },
      +        "environment": {
      +          "description": "environment",
      +          "type": "string"
      +        },
      +        "path": {
      +          "description": "Text value",
      +          "type": "string"
      +        },
      +        "platform": {
      +          "description": "platform",
      +          "type": "string"
      +        },
      +        "product": {
      +          "description": "product",
      +          "type": "string"
      +        },
      +        "version": {
      +          "description": "version",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "product",
      +        "platform",
      +        "environment",
      +        "version",
      +        "path",
      +        "asset"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "result"
      +  ],
      +  "type": "object"
      +}
  3. First observed

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already declare readOnly/idempotent/non-destructive, so the safety profile is covered; the description adds the genuinely useful behavioral fact that it returns path, URI, hash, MIME and size without embedding bytes, which matters for context budgeting. It doesn't say whether missing assets error or return empty, or anything about size limits, so it isn't exhaustive.

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?

Three sentences, front-loaded with the capability, then the return contract, then discovery routing. No filler and nothing repeated from the annotations or schema verbatim.

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?

Output schema exists, so return values need not be explained, and the description still summarizes them compactly; input discovery is covered and the schema handles addressing rules. The remaining gap is disambiguation against the large family of sibling asset/image getters, which the description never addresses.

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 all five parameters (including the optional environment and the version-pinning rule) are documented in the schema itself. The description only echoes the relative-path constraint and doesn't add format or constraint detail beyond it, so the baseline 3 applies.

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 ("Materialize an archived resource or stored screenshot/MP4/WebM") plus the addressing mechanism (relative path) and the return shape. It also carves out a scope boundary ("Full page JSON is excluded"), so an agent can tell it apart from the page-JSON getters 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 Guidelines4/5

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

Gives explicit routing for inputs: discover resources via list_archived_assets/get_fonts and recordings via get_page_artifacts, and notes the page-JSON exclusion. It stops short of explaining how this differs from the many sibling image getters (get_page_image, get_component_image, get_element_asset, get_stage_image), which is the ambiguity an agent is most likely to hit.

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