Skip to main content
Glama

Get one CC0 asset with download files

get_asset
Read-onlyIdempotent

Fetch an asset's details and download links by its search_assets ID, re-verifying at the source that it is still CC0 before inspection or download.

Instructions

Fetch one asset's details and download files by an id from search_assets, re-checking at the source that it is still CC0. Use it after search_assets when the user wants to download or inspect an item; it cannot search, so call search_assets first if you have no id. Returns an error (do not retry the same id) when the id is malformed, the item was removed, or the source no longer reports CC0. Behavior: read-only, no API key, one or two live HTTPS calls. Poly Haven lists up to 60 resolution/format variants; ambientCG returns zip packs; Sketchfab returns only the model page because its downloads need the user's own login.

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": {
      "id": "<id>"
    },
    "name": "get_asset"
  }
}

Input Schema

NameRequiredDescriptionDefault
idYesAsset id exactly as returned by search_assets: openverse:image:<uuid>, openverse:audio:<uuid>, polyhaven:<slug>, ambientcg:<assetId>, cleveland:<number>, met:<number>, commons:<pageid>, archive:<identifier> or sketchfab:<uid>

Output Schema

NameRequiredDescriptionDefault
idYesStable id to pass to get_asset, e.g. 'polyhaven:brown_planks_03' or 'met:436535'
kindYesAsset type
tagsYesUp to 20 source tags or categories
filesYesDownloadable files, at most 60; empty when the source offers none
titleYesTitle at the source
originYesSite the item originally came from (e.g. flickr, freesound, metmuseum.org)
creatorYesCreator or uploader name, null if the source gives none
fileUrlYesDirect file or preview URL when the search response includes one; use get_asset for all files
providerYesAPI that served the item
servedByYesCredit line required by the serving API's terms; show it next to results
filesNoteNoPresent when files were truncated
landingUrlYesHuman-facing page at the source; link this when showing the item
descriptionYesSource description or credit line, if any
thumbnailUrlYesSmall preview image URL, null for audio and some items
licenseEvidenceYesHow CC0 status was verified for this item

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv0.1.1
    • changedInput schema / properties / id / description
      Previous value: -"Asset id from search_assets"New value: +"Asset id exactly as returned by search_assets: openverse:image:<uuid>, openverse:audio:<uuid>, polyhaven:<slug>, ambientcg:<assetId>, cleveland:<number>, met:<number>, commons:<pageid>, archive:<identifier> or sketchfab:<uid>"
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "creator": {
      +      "description": "Creator or uploader name, null if the source gives none",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "description": {
      +      "description": "Source description or credit line, if any",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "fileUrl": {
      +      "description": "Direct file or preview URL when the search response includes one; use get_asset for all files",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "files": {
      +      "description": "Downloadable files, at most 60; empty when the source offers none",
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "label": {
      +            "description": "Variant, e.g. '2K-JPG (zip)', 'hdri / 4k / exr', 'primary'",
      +            "type": "string"
      +          },
      +          "sizeBytes": {
      +            "description": "File size in bytes when the source reports it",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "url": {
      +            "description": "Direct download URL (Sketchfab: model page, login required)",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "label",
      +          "url",
      +          "sizeBytes"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "filesNote": {
      +      "description": "Present when files were truncated",
      +      "type": "string"
      +    },
      +    "id": {
      +      "description": "Stable id to pass to get_asset, e.g. 'polyhaven:brown_planks_03' or 'met:436535'",
      +      "type": "string"
      +    },
      +    "kind": {
      +      "description": "Asset type",
      +      "enum": [
      +        "image",
      +        "audio",
      +        "video",
      +        "hdri",
      +        "texture",
      +        "model",
      +        "artwork"
      +      ],
      +      "type": "string"
      +    },
      +    "landingUrl": {
      +      "description": "Human-facing page at the source; link this when showing the item",
      +      "type": "string"
      +    },
      +    "licenseEvidence": {
      +      "additionalProperties": false,
      +      "description": "How CC0 status was verified for this item",
      +      "properties": {
      +        "declaredBy": {
      +          "description": "Who declared CC0. library = the studio that made it; institution = the museum holding the work; uploader = a site user, unreviewed and sometimes wrong (warn the user to verify ownership)",
      +          "enum": [
      +            "library",
      +            "institution",
      +            "uploader"
      +          ],
      +          "type": "string"
      +        },
      +        "license": {
      +          "const": "CC0-1.0",
      +          "description": "Always CC0-1.0; non-CC0 items are never returned",
      +          "type": "string"
      +        },
      +        "licenseUrl": {
      +          "description": "CC0 1.0 deed URL",
      +          "type": "string"
      +        },
      +        "method": {
      +          "description": "per-item-license-field: the item's own record says CC0; whole-library-cc0: the site publishes everything as CC0",
      +          "enum": [
      +            "per-item-license-field",
      +            "whole-library-cc0"
      +          ],
      +          "type": "string"
      +        },
      +        "source": {
      +          "description": "The exact field or policy page the check used, with its URL",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "license",
      +        "licenseUrl",
      +        "method",
      +        "source",
      +        "declaredBy"
      +      ],
      +      "type": "object"
      +    },
      +    "origin": {
      +      "description": "Site the item originally came from (e.g. flickr, freesound, metmuseum.org)",
      +      "type": "string"
      +    },
      +    "provider": {
      +      "description": "API that served the item",
      +      "enum": [
      +        "openverse",
      +        "polyhaven",
      +        "ambientcg",
      +        "cleveland",
      +        "met",
      +        "commons",
      +        "archive",
      +        "sketchfab"
      +      ],
      +      "type": "string"
      +    },
      +    "servedBy": {
      +      "description": "Credit line required by the serving API's terms; show it next to results",
      +      "type": "string"
      +    },
      +    "tags": {
      +      "description": "Up to 20 source tags or categories",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "thumbnailUrl": {
      +      "description": "Small preview image URL, null for audio and some items",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "title": {
      +      "description": "Title at the source",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "id",
      +    "kind",
      +    "title",
      +    "creator",
      +    "landingUrl",
      +    "fileUrl",
      +    "thumbnailUrl",
      +    "tags",
      +    "provider",
      +    "origin",
      +    "licenseEvidence",
      +    "servedBy",
      +    "description",
      +    "files"
      +  ],
      +  "type": "object"
      +}
  2. First observedv0.1.0

TDQS

A4.9/5.0
Behavior5/5

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

Annotations already cover read-only and open-world behavior, yet the description adds concrete operational detail: no API key, one or two live HTTPS calls, and three distinct error causes (malformed id, removed item, source no longer CC0). It also discloses per-source return shape differences (Poly Haven variants, ambientCG zips, Sketchfab page-only due to login), which annotations cannot express.

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, each doing distinct work: purpose and scope first, then usage and prerequisite, then behavior and error handling. No filler or restated title text.

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?

An output schema exists, so return-value detail is not required, and the description still covers the things an agent needs to call correctly: where the id comes from, what happens on failure, and why some sources yield fewer downloadable files.

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

Parameters4/5

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

Schema coverage is 100%, so the id formats and constraints are already documented in the schema; the description repeats the search_assets origin but adds operational meaning by tying malformed ids to an error and a no-retry rule. Small value added beyond the schema rather than a large one.

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 states a specific verb and resource ('Fetch one asset's details and download files'), names the required id provenance ('from search_assets'), and adds the distinguishing check ('re-checking at the source that it is still CC0'). It also explicitly says what the tool is not ('it cannot search'), which separates it cleanly from search_assets.

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 gives an explicit when-to-use ('after search_assets when the user wants to download or inspect an item') and a when-not / prerequisite ('call search_assets first if you have no id'), plus a do-not-retry rule for errors. Alternatives are named, not inferred.

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

Deploy Server

Other Tools