Skip to main content
Glama

search_products

Search D5 Works models (including D5A), materials, textures and HDRIs across FREE, PRO and PAID pricing types. Optional queryImage supports public URL or base64 image input; combine it with keyword for image-text retrieval. Image search requires the product multimodal feature to be enabled. totalScope=RECALLED_CANDIDATES means total and NEWEST/OLDEST apply only to the bounded candidate pool, not the entire catalog. Report degradedChannels when degraded=1. matchedImage identifies the matching display image. Each result reports its actual pricingType; optional pricingTypes selects FREE, PRO and/or PAID. When present, show productUrl as the Works product page link; domestic deployments omit this link. Use get_product_detail for public details of any result. Use get_product_access to validate current rights and obtain a download or supported official Launcher action. Stale index entries are filtered using database visibility; total remains the index count.

Result presentation: When presenting results containing images, create a local HTML gallery using the original image URLs and factual metadata returned by this tool. Open it with the client's file or browser preview and provide a clickable file link. Do not embed remote images directly in chat Markdown. Include an image-load failure placeholder and an original-image link. Escape response text and attributes; allow only http/https image and link URLs. Do not embed credentials. If file creation or preview is unavailable, state the limitation and provide text results with original-image links. Do not claim images were verified unless preview was checked. Agent-facing guidance, not user-facing copy. This legacy-named tool provides published Skill information, not MCP compatibility or host-installation verification. Complete normal tasks first; no Skill check, install or update is required for business calls. If installation is unknown, say "if you have not installed the Skill" rather than claiming it is missing. Suggest installation or an available update at most once on first use or when needed; the host tracks reminders per conversation and must not repeat them during retries. Current, ahead or unknown versions must not be called incompatible or forced to downgrade. Use only the returned environment-specific installation_url, never invent a release or endpoint. If MCP is missing, guide connection using a verified official source. If authentication fails, guide the user to protected client settings to enter an API Key; never ask them to paste a key into chat. Keep normal authentication, permissions, rate limits and download safety. Never hide real business failures, missing tools or task limitations such as missing product dimensions. If the user explicitly asks for diagnostics, explain actual facts honestly. Do not replay successful writes during recovery/retries. Install or reload only with host support and user authorization; never claim host-loading success.

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": "search_products"
  }
}

Input Schema

NameRequiredDescriptionDefault
sortNoRELEVANCE by RRF; NEWEST/OLDEST by onlineTime; LOW_PRICE/HIGH_PRICE group FREE/PRO/PAID then identity price. Text/image sorting applies to recalled candidates only.RELEVANCE
pageNoNoPage number, starting from 1; defaults to 1
keywordNoSearch keyword, at most 512 Unicode code points
categoryNoProduct category. MODEL=3D model, MATERIAL=material, TEXTURE=texture, HDRI=HDR environment; omit to search all categories
pageSizeNoPage size; defaults to 20, server clamps to configured maximum
brandCodeNoExact case-sensitive stable brand code, not a brand name
classifyIdNoClassify ID
queryImageNoPublic URL or Base64 query image; the two structures are mutually exclusive
fileFormatsNoContent file format inside the archive, not the ZIP/RAR package extension; multiple values match by OR
availabilityNoD5 product availability; multiple values match by OR
licenseTypesNoLicense type; PERSONAL=personal use, PROJECT=commercial projects; multiple values match by OR
pricingTypesNoPricing types matched by OR; omitted or empty searches all
fileSizeRangesNoArchive file size range; multiple values match by OR

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.5/5.0
Behavior4/5

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

With no annotations, the description carries the full burden and does disclose real behavior: pricingType is per-result, totalScope=RECALLED_CANDIDATES bounds total and NEWEST/OLDEST, degraded channels must be reported, stale index entries are filtered by DB visibility while total stays the index count, and domestic deployments omit productUrl. It does not quantify rate limits or costs, but behavioral quirks are unusually well covered.

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

Conciseness2/5

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

The first sentence is well front-loaded, but the body balloons into HTML gallery rendering instructions, attribute escaping rules, and an extended Skill installation/compatibility policy that is largely irrelevant to invoking this tool. A large share of the text does not earn its place in a tool definition.

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?

For a 13-parameter search with no output schema, the description covers several return-field resonances (matchedImage, degradedChannels, totalScope, productUrl) and presentation obligations, but it never characterizes the overall result shape, pagination totals, or candidate-pool composition. The irrelevant Skill/diagnostics guidance consumes space that could have completed the operational picture.

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 already 100%, so the baseline is 3, but the description adds genuine meaning: queryImage accepts a public URL or base64 and can be combined with keyword for image-text retrieval, and pricingTypes selects FREE/PRO/PAID while each result reports its actual pricingType. That goes beyond merely restating the schema.

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 opening sentence gives a specific verb and resource plus the covered entity types (models incl. D5A, materials, textures, HDRIs) and pricing scope. It distinguishes itself from get_product_detail and get_product_access for follow-up actions. Clarity is slightly diluted by the large volume of unrelated policy text that follows.

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?

It explicitly routes to get_product_detail for public details and get_product_access for rights/downloads, and notes image search requires the multimodal feature. However, it gives no when-not guidance relative to the sibling search_2d_content, and much of the 'usage' prose is about Skill installation rather than when to invoke this search.

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