smithsonian-mcp-server

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['mode', 'value'], 'properties': {'mode': {'enum': ['museum', 'culture', 'period', 'medium', 'topic'], 'type': 'string', 'description': 'Browse dimension: "museum" (by unit code), "culture" (by culture term), "period" (by indexed date term like "1940s" or "500-1500"), "medium" (by object type like "Paintings"), "topic" (by subject term like "Quilts").'}, 'rows': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Number of sample objects to return (default 10, max 50).'}, 'start': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset â\x80\x94 0-indexed. Page contiguously with start = page Ã\x97 rows.'}, 'value': {'type': 'string', 'description': 'Category value appropriate to the mode. museum: a unit code like "NASM", "SAAM", or "NMNHBIRDS", matched literally and case-sensitively â\x80\x94 not a museum name. culture: term, often plural or qualified ("Aztecs", "Plains Indian"). period: an indexed date term â\x80\x94 commonly a decade ("1940s", "1860s"), but year ranges ("500-1500"), century terms ("21st century"), and BCE forms ("-2500", "BCE 1000s") are indexed too. medium: object type, usually plural ("Paintings", "Aircraft"). topic: subject term ("Quilts", "Aviation"). Smithsonian uses a controlled vocabulary â\x80\x94 for museum (unit_code), culture, period (date), and topic, call smithsonian_list_terms to find exact terms; medium (object_type) is not enumerable there, so harvest it from smithsonian_search_objects results. Every mode matches its value exactly and case-sensitively, and for medium that split is load-bearing: casing variants are indexed as SEPARATE categories, each reporting its own total_count ("button" and "Button" are different categories, and neither casing is reliably the larger), so browse the variants of a harvested value rather than assuming one covers the concept.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['mode', 'value', 'total_count', 'sample_objects', 'museum_breakdown']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The rows cap that was applied.'}, 'mode': {'type': 'string', 'description': 'Browse dimension used for this request (one of "museum", "culture", "period", "medium", "topic").'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['invalid_category'], 'description': 'Machine-readable failure mode. Declared by this tool: `invalid_category`: The category value matched no objects â\x80\x94 a browse category is an exact indexed facet, so a zero match means the value did not resolve to retrievable objects. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'shown': {'type': 'number', 'description': 'Number of sample objects returned.'}, 'value': {'type': 'string', 'description': 'Category value queried, as provided in the request.'}, 'notice': {'type': 'string', 'description': 'Guidance naming the input that retrieves the objects this page omitted.'}, 'truncated': {'type': 'boolean', 'description': 'True when matching objects remain past this page. False on a terminal or past-the-end page, where nothing is being withheld.'}, 'total_count': {'type': 'number', 'description': 'Total number of Smithsonian objects matching this category.'}, 'sample_objects': {'type': 'array', 'items': {'type': 'object', 'required': ['record_id', 'title', 'unit_code', 'is_cc0'], 'properties': {'title': {'type': 'string', 'description': 'Object title.'}, 'is_cc0': {'type': 'boolean', 'description': 'True when the object metadata is CC0 (open access). The Smithsonian Open Access corpus is CC0 throughout, so this flag rarely varies and cannot gate an image download â\x80\x94 read thumbnail_url for that.'}, 'record_id': {'type': 'string', 'description': 'Object identifier â\x80\x94 pass to smithsonian_get_object or smithsonian_get_media.'}, 'unit_code': {'type': 'string', 'description': 'Museum unit code.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL if available.'}}, 'description': 'A sample object from the requested page of category matches.', 'additionalProperties': False}, 'description': 'The requested page of objects matching the category, in upstream order. Empty when start is past the end of the category.'}, 'museum_breakdown': {'type': 'array', 'items': {'type': 'object', 'required': ['unit_code', 'museum_name', 'count'], 'properties': {'count': {'type': 'number', 'description': 'Estimated object count from sample (not exact).'}, 'unit_code': {'type': 'string', 'description': 'Smithsonian unit code for this museum (e.g. "NMNHPALEO", "SAAM").'}, 'museum_name': {'type': 'string', 'description': 'Full name of the museum. A few rarely-indexed archive sub-unit codes have no mapped name and fall back to the raw unit code.'}}, 'description': 'A single museum contribution entry.', 'additionalProperties': False}, 'description': 'When mode is not "museum": top contributing museums from the sample, helping plan museum-focused follow-up searches.'}, 'truncationCeiling': {'type': 'number', 'description': 'Total matching objects (upper bound for omitted items).'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'record_id of the anchor object (e.g. "nasm_A19670093000") from smithsonian_search_objects or smithsonian_get_object.'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 20, 'minimum': 1, 'description': 'Maximum number of related objects to return (default 10, max 20).'}, 'start': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': "Pagination offset â\x80\x94 0-indexed. Page contiguously with start = page Ã\x97 limit; each signal is reachable to a depth of 5000 objects, beyond which truncated stays true but deeper pages aren't retrievable."}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['anchor', 'related', 'search_signals_used', 'signals']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The limit cap that was applied.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'invalid_id'], 'description': 'Machine-readable failure mode. Declared by this tool: `not_found`: The anchor object ID does not exist in the Smithsonian catalog. `invalid_id`: The ID is empty or contains only whitespace. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'shown': {'type': 'number', 'description': 'Number of related objects returned.'}, 'anchor': {'type': 'object', 'required': ['record_id', 'title', 'unit_code'], 'properties': {'title': {'type': 'string', 'description': 'Title of the input object from the catalog.'}, 'record_id': {'type': 'string', 'description': 'Smithsonian catalog record ID for the input object.'}, 'unit_code': {'type': 'string', 'description': 'Museum unit code for the input object (e.g. "NASM").'}}, 'description': 'Summary of the anchor object used to drive the fan-out searches.', 'additionalProperties': False}, 'notice': {'type': 'string', 'description': "Guidance naming the inputs that retrieve the related objects this page omitted â\x80\x94 start for the next page, signals[].search_continuation for a signal past this tool's reach."}, 'related': {'type': 'array', 'items': {'type': 'object', 'required': ['record_id', 'title', 'unit_code', 'museum_name', 'is_cc0', 'similarity_signals'], 'properties': {'title': {'type': 'string', 'description': 'Object title.'}, 'is_cc0': {'type': 'boolean', 'description': 'True when the object metadata is CC0 (open access). The Smithsonian Open Access corpus is CC0 throughout, so this flag rarely varies and cannot gate an image download â\x80\x94 read thumbnail_url for that.'}, 'record_id': {'type': 'string', 'description': 'Object identifier â\x80\x94 pass to smithsonian_get_object or smithsonian_get_media.'}, 'unit_code': {'type': 'string', 'description': 'Museum unit code.'}, 'museum_name': {'type': 'string', 'description': 'Full museum name. A few rarely-indexed archive sub-unit codes have no mapped name and fall back to the raw unit code.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail URL if available.'}, 'similarity_signals': {'type': 'array', 'items': {'type': 'string', 'description': 'A metadata signal that connected this object to the anchor (e.g. "culture: Plains Indian").'}, 'description': 'Metadata terms that connected this object to the anchor.'}}, 'description': 'A related object with its connecting metadata signals.', 'additionalProperties': False}, 'description': 'Related objects interleaved across the fan-out signals so each signal contributes. Empty when no related objects were found across all fan-out searches.'}, 'signals': {'type': 'array', 'items': {'type': 'object', 'required': ['signal', 'row_count', 'search_continuation'], 'properties': {'signal': {'type': 'string', 'description': 'Matches an entry in search_signals_used and in related[].similarity_signals.'}, 'row_count': {'type': 'number', 'description': "True upstream match count for this signal, uncapped â\x80\x94 it can exceed the 5000-per-signal depth this tool's own paging reaches."}, 'search_continuation': {'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': "Pass verbatim as smithsonian_search_objects's query. Empty when the signal is expressed entirely through filters."}, 'filters': {'type': 'object', 'properties': {'date': {'type': 'string', 'description': 'smithsonian_search_objects filters.date value.'}, 'name': {'type': 'string', 'description': 'smithsonian_search_objects filters.name value.'}, 'topic': {'type': 'string', 'description': 'smithsonian_search_objects filters.topic value.'}, 'culture': {'type': 'string', 'description': 'smithsonian_search_objects filters.culture value.'}, 'object_type': {'type': 'string', 'description': 'smithsonian_search_objects filters.object_type value.'}}, 'description': "Pass verbatim as smithsonian_search_objects's filters. Omitted when the signal's constraint is already carried entirely by query.", 'additionalProperties': False}}, 'description': "Exact smithsonian_search_objects input that reproduces this signal's full match set, at any depth.", 'additionalProperties': False}}, 'description': 'One fan-out signal with its true size and its retrieval path.', 'additionalProperties': False}, 'description': "Per-signal breakdown of every fan-out that returned. Use search_continuation with smithsonian_search_objects to retrieve a signal's matches past this tool's 5000-per-signal reach. A signal whose upstream call failed is omitted."}, 'truncated': {'type': 'boolean', 'description': 'True when the related list is incomplete â\x80\x94 either capped by the limit or more results exist upstream past the current page (advance start to retrieve them).'}, 'truncationCeiling': {'type': 'number', 'description': "Upper bound on the related objects reachable by paging with start. Cross-signal overlaps are not subtracted, so it can overcount. Signals larger than this tool's per-signal reach are counted at that reach â\x80\x94 see signals[].row_count for their true size."}, 'search_signals_used': {'type': 'array', 'items': {'type': 'string', 'description': 'A metadata signal used for a fan-out search.'}, 'description': 'Metadata fields that drove the fan-out searches.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'record_id of the object (e.g. "nasm_A19670093000") from smithsonian_search_objects or smithsonian_get_object.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['record_id', 'title', 'is_cc0', 'images']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'no_media', 'no_images', 'not_cc0', 'invalid_id'], 'description': 'Machine-readable failure mode. Declared by this tool: `not_found`: No object with the given ID exists in the Smithsonian catalog. `no_media`: The object exists but has no digitized online media. `no_images`: The object has digitized media, but none of it is an image â\x80\x94 the media is entirely non-image types such as scanned books, 3D models, or sound recordings. `not_cc0`: The object has media but none of its images are CC0 open access. `invalid_id`: The ID is empty or contains only whitespace. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'title': {'type': 'string', 'description': 'Object title from the catalog record.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['media_id', 'is_cc0'], 'properties': {'is_cc0': {'type': 'boolean', 'description': 'True when this specific image is CC0 (may differ from the object-level flag). Always true on returned images â\x80\x94 non-CC0 images are filtered out before the response.'}, 'alt_text': {'type': 'string', 'description': 'Accessibility alt text for the image.'}, 'media_id': {'type': 'string', 'description': 'IDS media identifier.'}, 'screen_url': {'type': 'string', 'description': 'Screen-size URL (~800px).'}, 'description': {'type': 'string', 'description': 'Extended accessibility description.'}, 'high_res_jpeg': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'Direct download URL for the image.'}, 'width': {'type': 'number', 'description': 'Image width in pixels.'}, 'height': {'type': 'number', 'description': 'Image height in pixels.'}}, 'description': 'Full-resolution JPEG download when available.', 'additionalProperties': False}, 'high_res_tiff': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'Direct download URL for the image.'}, 'width': {'type': 'number', 'description': 'Image width in pixels.'}, 'height': {'type': 'number', 'description': 'Image height in pixels.'}}, 'description': 'Archival TIFF download when available.', 'additionalProperties': False}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail URL (~120px).'}}, 'description': 'A single CC0 image item with resolution variants.', 'additionalProperties': False}, 'description': 'CC0-licensed images for this object.'}, 'is_cc0': {'type': 'boolean', 'description': 'True when the object-level metadata is CC0. The Open Access corpus is CC0 throughout, so this rarely varies; the per-image is_cc0 flag is what gates delivery.'}, 'record_id': {'type': 'string', 'description': 'Smithsonian catalog record ID for the object.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Object record_id from smithsonian_search_objects results (e.g. "nasm_A19670093000").'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['record_id', 'title', 'unit_code', 'museum_name', 'dates', 'makers', 'materials', 'dimensions', 'place', 'culture', 'topics', 'exhibitions', 'identifiers', 'is_cc0', 'media_summary']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'dates': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'label': {'type': 'string', 'description': 'Date field label (e.g. "Date", "Accession Date").'}, 'value': {'type': 'string', 'description': 'Date value string.'}}, 'description': 'A single labeled date entry.', 'additionalProperties': False}, 'description': 'All date fields in the catalog record.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'invalid_id'], 'description': 'Machine-readable failure mode. Declared by this tool: `not_found`: No object with the given ID exists in the Smithsonian catalog. `invalid_id`: The ID format is clearly malformed (empty string, whitespace only). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'place': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'label': {'type': 'string', 'description': 'Place field label.'}, 'value': {'type': 'string', 'description': 'Place name or description.'}}, 'description': 'A single labeled place entry.', 'additionalProperties': False}, 'description': 'Geographic place associations.'}, 'title': {'type': 'string', 'description': 'Object title.'}, 'is_cc0': {'type': 'boolean', 'description': 'True when the object metadata is CC0 (open access). The Smithsonian Open Access corpus is CC0 throughout, so this flag rarely varies â\x80\x94 read media_summary.has_cc0_images to predict whether smithsonian_get_media returns images.'}, 'makers': {'type': 'array', 'items': {'type': 'object', 'required': ['role', 'name'], 'properties': {'name': {'type': 'string', 'description': 'Name of the party.'}, 'role': {'type': 'string', 'description': 'Role of the named party (e.g. "Artist", "Manufacturer", "Pilot").'}}, 'description': 'A single named party entry.', 'additionalProperties': False}, 'description': 'All named parties associated with this object.'}, 'topics': {'type': 'array', 'items': {'type': 'string', 'description': 'A subject or topic term.'}, 'description': 'Subject and topic terms.'}, 'culture': {'type': 'array', 'items': {'type': 'string', 'description': 'A culture term.'}, 'description': 'Culture associations.'}, 'materials': {'type': 'array', 'items': {'type': 'string', 'description': 'A material or physical description string.'}, 'description': 'Physical material descriptions.'}, 'record_id': {'type': 'string', 'description': 'Unique object identifier.'}, 'unit_code': {'type': 'string', 'description': 'Museum unit code.'}, 'dimensions': {'type': 'array', 'items': {'type': 'string', 'description': 'A dimension or measurement string.'}, 'description': 'Dimension and measurement strings.'}, 'credit_line': {'type': 'string', 'description': 'Attribution or credit string.'}, 'description': {'type': 'string', 'description': 'Best available prose description (Summary, Physical Description, or Brief Description notes).'}, 'exhibitions': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Exhibition name.'}, 'building': {'type': 'string', 'description': 'Building or venue where the exhibition was held.'}}, 'description': 'A single exhibition entry.', 'additionalProperties': False}, 'description': 'Exhibition history.'}, 'identifiers': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'label': {'type': 'string', 'description': 'Identifier type (e.g. "Accession Number", "Call Number").'}, 'value': {'type': 'string', 'description': 'Identifier value.'}}, 'description': 'A single labeled identifier.', 'additionalProperties': False}, 'description': 'All accession and catalog identifiers.'}, 'museum_name': {'type': 'string', 'description': 'Full museum name. A few rarely-indexed archive sub-unit codes have no mapped name and fall back to the raw unit code.'}, 'record_link': {'type': 'string', 'description': 'Canonical Smithsonian Institution URL for this object.'}, 'media_summary': {'type': 'object', 'required': ['count', 'cc0_image_count', 'has_cc0_images'], 'properties': {'count': {'type': 'number', 'description': 'Total number of online media items, across all types (includes non-image media such as 3D models).'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail URL from the first media item.'}, 'has_cc0_images': {'type': 'boolean', 'description': 'True when at least one CC0 image is available (cc0_image_count > 0).'}, 'cc0_image_count': {'type': 'number', 'description': 'Number of CC0 images smithsonian_get_media returns for this object. Lower than count when the object has non-image media (e.g. 3D models) or non-CC0 images.'}}, 'description': 'Media availability summary. Call smithsonian_get_media for full image URLs.', 'additionalProperties': False}, 'object_rights': {'type': 'string', 'description': 'Rights statement from the catalog.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['field'], 'properties': {'rows': {'type': 'integer', 'default': 50, 'maximum': 100, 'minimum': 1, 'description': 'Number of terms to return per page (default 50, max 100).'}, 'field': {'enum': ['unit_code', 'culture', 'place', 'date', 'online_media_type', 'topic'], 'type': 'string', 'description': 'Indexed field to enumerate. Choices: unit_code (museum codes like "NASM"), culture (e.g. "Aztecs"), place (geographic terms), date (decade/era values like "1920s"), online_media_type (media formats like "Images", "3D Models"), topic (subject terms like "Quilts" â\x80\x94 133k terms, so pair it with contains).'}, 'start': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset (0-indexed). Use with rows to page through large vocabularies.'}, 'contains': {'type': 'string', 'description': 'Case-insensitive substring filter on the term vocabulary â\x80\x94 resolve a filter value (e.g. "greek") to its exact controlled-vocabulary term(s). For unit_code the substring also matches each code\'s museum name, so "National Air and Space" resolves to "NASM".'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['field', 'terms', 'total']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The rows cap that was applied.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['no_terms'], 'description': 'Machine-readable failure mode. Declared by this tool: `no_terms`: The field returned no indexed terms. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'field': {'type': 'string', 'description': 'The enumerated field, as provided in the request.'}, 'shown': {'type': 'number', 'description': 'Number of terms returned in this page.'}, 'terms': {'type': 'array', 'items': {'type': 'string', 'description': 'A term value â\x80\x94 pass directly as the filter value in smithsonian_search_objects or smithsonian_browse_category.'}, 'description': "The field's distinct term values for this page, in the Smithsonian index's native order. No per-term object counts are available upstream."}, 'total': {'type': 'number', 'description': 'Total number of distinct terms for this field (the full vocabulary size; terms is one page of it).'}, 'labels': {'type': 'object', 'description': 'Museum name for each unit_code on this page that has one â\x80\x94 present only when field is "unit_code". A few rarely-indexed archive sub-unit codes have no mapped name and are absent from this map; their term is still returned in terms.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'notice': {'type': 'string', 'description': 'Guidance naming the input that retrieves the terms this page omitted, or how to broaden a contains filter that matched nothing.'}, 'truncated': {'type': 'boolean', 'description': 'True when matching terms remain past this page. False on a terminal or past-the-end page, where nothing is being withheld.'}, 'truncationCeiling': {'type': 'number', 'description': 'Distinct terms available for this query (the full vocabulary, or the contains-match count) â\x80\x94 upper bound for omitted items.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'rows': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Page size (default 20, max 100).'}, 'query': {'type': 'string', 'description': 'Free-text search. Use specific terms for precision ("Tlingit totem pole") or broad terms for browsing ("quilt").'}, 'start': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset â\x80\x94 0-indexed. Use with rows for paging through large result sets.'}, 'filters': {'type': 'object', 'properties': {'date': {'type': 'string', 'description': 'Indexed date term. Decades ("1920s", "1960s") are the most common form, but the vocabulary also carries year ranges ("500-1500"), century terms ("21st century"), and BCE forms ("-2500", "BCE 1000s"). The value must be an exact term â\x80\x94 the full set is enumerable via smithsonian_list_terms (field "date").'}, 'name': {'type': 'string', 'description': 'Indexed named party â\x80\x94 maker, collector, donor, issuing authority, or any other role the catalog records. Written surname-first (e.g. "Warhol, Andy"). This field is not enumerable via smithsonian_list_terms. A smithsonian_find_related name signal carries the indexed form verbatim and is the reliable source; smithsonian_get_object\'s makers[] is the catalog\'s free-text form of the same parties and is often written differently ("Major J. A. L. Möller (Jacob A.L. Möller/Monty Möller), Non-Indian, 1883-1957" for the indexed "Möller, Major J. A. L."), so treat it as a starting guess.'}, 'place': {'type': 'string', 'description': 'Geographic place (e.g. "United States of America"). The full set is enumerable via smithsonian_list_terms (field "place").'}, 'topic': {'type': 'string', 'description': 'Subject term from the controlled vocabulary (e.g. "Quilts", "Aviation"). Matches the topics[] values smithsonian_get_object returns, and is a hard constraint â\x80\x94 topic "Quilts" matches 1,134 objects where the same word as free text matches 2,677. The full set is enumerable via smithsonian_list_terms (field "topic").'}, 'culture': {'type': 'string', 'description': 'Culture term from the controlled vocabulary â\x80\x94 often plural or qualified (e.g. "Aztecs", "Plains Indian"). The vocabulary is enumerable via smithsonian_list_terms (field "culture").'}, 'cc0_only': {'type': 'boolean', 'description': 'When true, restrict to records that have CC0-licensed media attached (the Lucene term media_usage:CC0). This selects on media presence, not license status â\x80\x94 the roughly 9.2M records it excludes are CC0 too, they simply have nothing digitized. Read has_media on each result to decide whether smithsonian_get_media will return anything.'}, 'unit_code': {'type': 'string', 'description': 'Museum unit code (e.g. "NASM", "SAAM", "NMAH", "NMAAHC", "NMAI", "NPG", "CHNDM", "SIL"); the National Museum of Natural History is indexed under discipline sub-units like "NMNHBIRDS" and "NMNHPALEO", not a bare "NMNH". The full set is enumerable via smithsonian_list_terms (field "unit_code").'}, 'object_type': {'type': 'string', 'description': 'Object type term from Smithsonian\'s controlled vocabulary â\x80\x94 commonly plural (e.g. "Paintings", "Photographs", "Aircraft"). Singular everyday forms like "Painting" usually return nothing. This field is not enumerable via smithsonian_list_terms; harvest valid values from the object_type field in smithsonian_search_objects results. Matched exactly and case-sensitively, and casing variants are indexed as SEPARATE categories â\x80\x94 "button" and "Button" each hold their own records, and neither casing is reliably the larger â\x80\x94 so probe a harvested value\'s other casings rather than assuming one covers the concept.'}, 'online_only': {'type': 'boolean', 'description': 'When true, restrict to records carrying an indexed online_media_type value. That vocabulary covers digitized surrogates â\x80\x94 finding aids, catalog cards, scanned books, full text, electronic resources â\x80\x94 alongside images, 3D models, and video, and the surrogate types often have no deliverable media attached, so a match can still report has_media: false. Read has_media on each result to decide whether smithsonian_get_media will return anything.'}}, 'description': 'Optional structured filters to narrow the search.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['objects', 'total_count']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The rows cap that was applied.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['no_results', 'invalid_filter'], 'description': 'Machine-readable failure mode. Declared by this tool: `no_results`: An unfiltered query matched no objects. `invalid_filter`: A filtered search matched nothing â\x80\x94 most often a filter value outside the Smithsonian controlled vocabulary (e.g. a singular "Painting" instead of "Paintings"). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'shown': {'type': 'number', 'description': 'Number of objects returned in this page.'}, 'notice': {'type': 'string', 'description': 'Guidance naming the input that retrieves the objects this page omitted.'}, 'objects': {'type': 'array', 'items': {'type': 'object', 'required': ['record_id', 'title', 'unit_code', 'museum_name', 'is_cc0', 'has_media'], 'properties': {'date': {'type': 'string', 'description': 'Indexed date term for the object â\x80\x94 commonly a decade ("1960s"), but the vocabulary also carries year ranges ("500-1500"), century terms ("21st century"), and BCE forms ("-2500", "BCE 1000s"). Sparse â\x80\x94 omitted when the record has no indexed date.'}, 'title': {'type': 'string', 'description': 'Object title from the catalog.'}, 'is_cc0': {'type': 'boolean', 'description': 'True when the object metadata is CC0 (open access). The Smithsonian Open Access corpus is CC0 throughout, so this flag rarely varies and cannot gate an image download â\x80\x94 read has_media for that.'}, 'has_media': {'type': 'boolean', 'description': 'True when the object carries deliverable online media items. This is the signal smithsonian_get_media reads, so it â\x80\x94 not the online_only filter â\x80\x94 predicts whether that call returns anything.'}, 'record_id': {'type': 'string', 'description': 'Unique object identifier â\x80\x94 pass to smithsonian_get_object, smithsonian_get_media, or smithsonian_find_related.'}, 'unit_code': {'type': 'string', 'description': 'Museum unit code (e.g. "NASM", "SAAM", "NMNHBIRDS"). Use as a filter in future searches.'}, 'museum_name': {'type': 'string', 'description': 'Full museum name for the unit code. A few rarely-indexed archive sub-unit codes have no mapped name and fall back to the raw unit code.'}, 'object_type': {'type': 'string', 'description': 'Object type term (e.g. "Aircraft", "Paintings", "Photographs"). Harvest it here to filter a later search, but it is case-sensitive and casing variants are separate categories upstream â\x80\x94 this row carries one casing of the concept, not all of it.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL (~120px) if the object has online media.'}}, 'description': 'Curated summary of a single Smithsonian catalog object.', 'additionalProperties': False}, 'description': 'Curated object summaries for the current page.'}, 'truncated': {'type': 'boolean', 'description': 'True when matching objects remain past this page. False on a terminal or past-the-end page, where nothing is being withheld.'}, 'total_count': {'type': 'number', 'description': 'Total matching objects in the Smithsonian catalog before pagination.'}, 'truncationCeiling': {'type': 'number', 'description': 'Total matching objects (upper bound for omitted items).'}}, 'additionalProperties': False}