Artbook Society — Public Catalog
Server Details
Read-only access to the Artbook Society published catalog: books, artists, editors and events.
- Status
- Healthy
- Uptime
- 99.9% over 22 days
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
TDQS
Scored across 5 tools
Each tool targets a distinct resource and action: three single-entity getters (artist, editor, product), one event lister, and one product search. There is no realistic way to confuse them, since search_products is explicitly scoped to books/artbooks while list_events is scoped to events.
All names follow a clean verb_noun snake_case pattern: get_artist, get_editor, get_product, list_events, search_products. The mix of get/list/search verbs is meaningful and consistent with the operations rather than arbitrary.
Five tools is lean but defensible for a narrow read-only public catalog surface, with each tool earning its place. It sits at the low end of the ideal range, so any expansion of the domain would quickly need more tools.
get_artist and get_editor require numeric ids, but there is no list_artists, list_editors, or artist search to discover those ids, and no get_event counterpart to list_events. Product coverage is solid via search_products, but the artist/editor paths are dead ends for discovery.
Available Tools
5 toolsget_artistGet artist profileBRead-onlyIdempotentInspect
Fetch full public details for a single artist by their numeric id.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Numeric artist id. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | No | |
| url | No | |
| name | No | |
| image | No | |
| biography | No | |
| specialties | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and a closed-world scope, so the safety profile is fully covered. The description adds one useful bit beyond that: the result is the "full public details" view, implying complete but publicly-scoped data. It does not mention auth requirements, rate limits, or error behavior for a missing id.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One sentence, zero filler, with the action, scope, and key all front-loaded. Nothing to trim.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need not be described, and this is a trivial single-parameter read. The only omission is guidance on behavior when the id does not resolve to an artist, which is minor for a tool of this complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the single id parameter is fully documented there as "Numeric artist id." The description's "by their numeric id" merely restates the schema, adding no format, range, or validity detail beyond it.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ("Fetch full public details for a single artist") plus the lookup key (numeric id), which is enough to distinguish it from the resource-oriented siblings get_editor and get_product. It stops short of explicitly contrasting itself with any sibling, but the single-resource scope is unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The word "single" implies this is the direct-lookup path rather than a list or search, but the description never states when to use this versus a search tool or what preconditions apply. No alternatives or exclusions are named, so usage must be inferred.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_editorGet publisher profileARead-onlyIdempotentInspect
Fetch full public details for a single editor by their numeric id.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Numeric editor id. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | No | |
| url | No | |
| logo | No | |
| title | No | |
| website | No | |
| biography | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and a closed-world scope, so safety is covered. The description adds only the mild nuance that returned data is 'public', with no detail on missing-id behavior or error handling, so it adds modest value on top of the annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One short sentence, front-loaded with the verb and resource, with no filler. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need no explanation, and annotations cover the safety profile. The only remaining gap is guidance on invalid or unknown ids, which is minor for a single-id lookup.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and there is a single documented 'id' parameter, so the schema already carries the semantics. The description restates 'numeric id' but adds no format, range, or sourcing guidance beyond it — baseline 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (Fetch) and resource (public details for a single editor) scoped to one numeric id, which cleanly distinguishes it from the search/list siblings. It does not, however, explicitly contrast itself with the structurally similar get_artist and get_product siblings.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'single editor by their numeric id' implies the usage context (you already have an id and want one entity), but no when-to-use conditions, prerequisites, or named alternatives are given. Usage is inferred rather than stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_productGet book detailsARead-onlyIdempotentInspect
Fetch full public details for a single published product by its numeric id.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Numeric product id. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | No | |
| url | No | |
| isbn | No | |
| image | No | |
| price | No | |
| title | No | |
| author | No | |
| editor | No | |
| currency | No | |
| versions | No | |
| description | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly, idempotent, non-destructive and closed-world behavior, so the safety profile is covered. The description adds scoping context ('published', 'public details' only), which tells the agent unpublished/internal fields are excluded, but it says nothing about error behavior for missing or unpublished ids.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with no filler, stating verb, resource, scope and key before any subordinate clause. It is efficient, though the title's 'book details' framing versus the description's 'product' wording introduces minor terminological drift.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With one required parameter, full schema coverage, an output schema covering return values, and annotations covering the safety profile, the description only needs to establish scope — and it does so via 'published' and 'public'. Nothing essential for a correct call is missing, though the relationship to search_products remains unstated.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with a single integer 'id' parameter already documented in the schema. The description only restates that the id is numeric, adding no format, range, or example semantics beyond what the schema provides, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description gives a specific verb (Fetch) and resource (full public details for a single published product) plus the lookup key (numeric id), so the agent knows exactly what it returns. It does not, however, contrast itself with the sibling search_products, which is the main ambiguity for an agent choosing between them.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
'A single published product' implies the retriever-by-id use case and implicitly excludes bulk or unfiltered listing, hinting that search_products is the alternative for discovery. But no explicit when-to-use/when-not-to-use statement or sibling reference is given, so the guidance remains inferred rather than stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_eventsList upcoming eventsARead-onlyIdempotentInspect
List published upcoming Artbook Society events, soonest first.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of events (default 10, max 20). |
Output Schema
| Name | Required | Description |
|---|---|---|
| results | No | Published events. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), so the description's added value is the filtering semantics — only published events, only upcoming ones — and the guaranteed sort order, both of which the annotations do not convey. It stops short of describing pagination behavior, but with an output schema present that gap is minor.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single sentence that leads with the action and resource, then the scope qualifiers and ordering. No padding, no restatement of the title.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple filtered list tool with full annotation coverage and an output schema, the description supplies the scope and ordering an agent needs to call it correctly. It could be slightly stronger by noting the result cap behavior, but nothing essential is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There is a single optional parameter whose schema entry is fully documented (default 10, max 20), giving 100% schema coverage. The description adds nothing about the limit parameter, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description gives a specific verb (List), a specific resource (published upcoming Artbook Society events), and even the ordering (soonest first). The sibling tools operate on entirely different resources (artists, editors, products), so there is no ambiguity to resolve.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The filters 'published' and 'upcoming' implicitly tell the agent this is for browsing future public events, but the description never states when to prefer this tool over alternatives or what conditions exclude its use. Usage is inferred rather than declared.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_productsSearch booksARead-onlyIdempotentInspect
Search published books and artbooks on Artbook Society. Every keyword must match the title, subtitle, description, an author or contributor, the publisher or the edition type. Optional filters: price range, signed, numbered, limited edition, language.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results (default 10, max 20). | |
| query | No | Keywords (at most 8), in English or French. Each keyword must match. Optional when a filter is given. | |
| signed | No | Only signed copies. | |
| language | No | Language of the text, ISO 639-1 code (for example fr or en). | |
| numbered | No | Only numbered copies. | |
| max_price | No | Maximum price in the currency shown in results. | |
| min_price | No | Minimum price in the currency shown in results. | |
| limited_edition | No | Only limited or collector's editions. |
Output Schema
| Name | Required | Description |
|---|---|---|
| results | No | Matching published products. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly, idempotent, closed-world and non-destructive, so the safety profile is covered. The description adds a genuinely non-obvious behavioral trait: match is conjunctive across title, subtitle, description, contributor, publisher and edition type — an AND across many fields, unlike typical OR keyword search.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, zero waste: the scope and matching rule come first, then the filter inventory. Nothing repeats the schema verbatim.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present and rich annotations, the description needs only to explain search semantics — which it does. It omits result ordering and the behavior of an empty query with no filters, minor gaps for an 8-parameter, all-optional tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so baseline is 3, but the description goes beyond the schema by explaining what the query string is actually matched against — field coverage the query parameter's own description does not supply. It also names the filter dimensions as a coherent set rather than leaving the agent to infer that price/signed/numbered/limited/language are refinements.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (search) plus the resource (published books and artbooks on Artbook Society), and the query-matching semantics make the retrieval model unambiguous. The 'search' framing cleanly separates it from the singular get_product / get_artist / get_editor siblings.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies the tool is for finding books by keyword or by the listed filters, but it never states when to choose it over get_product (single-item lookup) or what to do with the IDs a search returns. No exclusions or prerequisites are given; usage is inferred rather than directed.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
- Changed
search_products12 fields changed- added
Input schema / properties / languageAdded value: +{ + "description": "Language of the text, ISO 639-1 code (for example fr or en).", + "maxLength": 2, + "minLength": 2, + "type": "string" +} - added
Input schema / properties / limited_editionAdded value: +{ + "description": "Only limited or collector's editions.", + "type": "boolean" +} - added
Input schema / properties / max_priceAdded value: +{ + "description": "Maximum price in the currency shown in results.", + "maximum": 1000000, + "minimum": 0, + "type": "number" +} - added
Input schema / properties / min_priceAdded value: +{ + "description": "Minimum price in the currency shown in results.", + "maximum": 1000000, + "minimum": 0, + "type": "number" +} - added
Input schema / properties / numberedAdded value: +{ + "description": "Only numbered copies.", + "type": "boolean" +} - changed
Input schema / properties / query / descriptionPrevious value: -"Text to search for in product titles, author names or contributor names."New value: +"Keywords (at most 8), in English or French. Each keyword must match. Optional when a filter is given." - added
Input schema / properties / query / maxLengthAdded value: +200 - added
Input schema / properties / query / minLengthAdded value: +1 - added
Input schema / properties / signedAdded value: +{ + "description": "Only signed copies.", + "type": "boolean" +} - removed
Input schema / requiredRemoved value: -[ - "query" -] - added
Output schema / properties / results / items / properties / edition_typeAdded value: +{ + "type": "string" +} - added
Output schema / properties / results / items / properties / editorAdded value: +{ + "properties": { + "name": { + "type": "string" + } + }, + "type": "object" +}
1 tool update
- Changed
get_product1 field changed- added
Output schema / properties / versionsAdded value: +{ + "items": { + "properties": { + "available": { + "type": "boolean" + }, + "name": { + "type": "string" + }, + "price": { + "type": "string" + } + }, + "type": "object" + }, + "type": "array" +}
1 tool update
- Changed
search_products1 field changed- changed
Input schema / properties / query / descriptionPrevious value: -"Text to search for in product titles."New value: +"Text to search for in product titles, author names or contributor names."
5 tool updates
- First observed
get_artist - First observed
get_editor - First observed
get_product - First observed
list_events - First observed
search_products
Related MCP Connectors
Anonymous read-only access to source-backed public SHAR Production knowledge.
Read-only access to The Family Almanac's parenting-focused book library, grounded guide metadata...
Search a catalog of 1.7 million books and find books by mood, vibe, pace or genre. Read-only.
Find public creator tools, work and conversation. Read-only; no wallet, posting or payment.
Related MCP Servers
- FlicenseNot gradedqualityAmaintenanceProvides a read-only API over a book catalogue, offering tools to search books, retrieve book details and series, and inspect provenance and source agreement data.-
- AlicenseNot gradedqualityDmaintenanceProvides read-only access to the Family Office Knowledge Graph, enabling resolution of family offices, retrieval of public records with provenance, and listing of events, aliases, and nodes.MIT
- AlicenseAqualityCmaintenanceEnables read-only search and retrieval of the public Reknihy.cz book catalog, including filtering, sorting, ISBN lookup, category browsing, and access to product details such as price, availability, and images.4ISC

geolens-mcpofficial
AlicenseAqualityAmaintenanceRead-only access to a self-hosted GeoLens geospatial catalog: dataset search, schemas, GeoJSON features, saved maps, and sandboxed read-only SQL over PostGIS.6282Apache 2.0
Glama MCP Gateway
Add one secure layer between your agents and this server.