Skip to main content
Glama

Art Spotter - Eye of the Beholder

Find art for sale from independent artists

search_art
Read-onlyIdempotent

Find art for sale from independent artists. Searches works in independent artists' own shops and eBay art by words (subject, style, place, artist), kind, original or print, price, size and colour. Results show title, artist, size, price, where it ships from, an image and a link to buy straight from the artist.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
qNoWhat to look for, for example abstract blue, linocut bird, Scottish landscape or a dog portrait.
kindNoKind: painting, print, printmaking, photography, drawing, watercolour, ceramics, sculpture, textile, illustration or other.
unitNoUnit: in or cm. Defaults to in.
limitNoHow many results, 1 to 20.
colourNoA main colour, for example blue or ochre.
countryNoBuyer's two-letter country code, for eBay and currency, for example US or GB.
currencyNoCurrency for prices, for example USD, GBP or EUR.
max_sizeNoLargest longest side, in unit.
min_sizeNoSmallest longest side, in unit.
originalNoSet to true for one-off originals only, false for prints only.
max_priceNoHighest price, in the currency given (or the buyer's local currency).
min_priceNoLowest price.
ships_fromNoOnly artists based in this two-letter country.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare it read-only, idempotent, non-destructive and open-world, so the safety burden is lifted. The description adds genuinely useful behavior not in the annotations: the two underlying sources (independent shops and eBay) and the fields each result carries, which substitutes for the missing output schema.

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?

Two dense sentences, purpose front-loaded, no filler. The second sentence is long but earns its place by describing the result shape where no output schema exists.

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?

For a 13-parameter, no-required-params discovery tool with no output schema, the description covers both the source scope and the returned fields. Only the lack of guidance on result limits/pagination semantics (the limit param) keeps it from 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%, so the schema already documents all 13 parameters with examples and enum values. The description restates facets (kind, original/print, price, size, colour) at a high level without adding syntax, defaults, or interaction rules beyond what the schema provides, so 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?

States a specific verb and resource ('Find art for sale') and adds real scope: it searches independent artists' own shops plus eBay art. That clearly separates it from pricing/passport/royalty siblings, though no sibling is named explicitly.

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?

Usage is implied by the enumeration of search facets (subject, style, place, artist, kind, price, size, colour), so an agent can infer it is the discovery tool. However, there is no explicit when-to-use or when-not-to-use guidance, and no routing against check_art_listing, check_artworks_feed, or compare_where_to_sell.

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.