Smithsonian MCP

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "rows": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "multipleOf": 1,
      "description": "Page size (default 20). A value above 1000 is served at 1000 with a notice."
    },
    "query": {
      "type": "string",
      "description": "Free-text search. Every word is required — OR does not widen a search, while NOT excludes. 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 — 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 — the full set is enumerable via smithsonian_list_terms (field \"date\")."
        },
        "name": {
          "type": "string",
          "description": "Indexed named party — 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 term, matched exactly (e.g. \"United States\"). Variants are separate terms with no hierarchy — \"United States of America\" is a different, far smaller term, and a record filed under a state alone carries no country term. 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 — 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 — 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 — 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 — 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 — \"button\" and \"Button\" each hold their own records, and neither casing is reliably the larger — 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 — finding aids, catalog cards, scanned books, full text, electronic resources — 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."
        },
        "scientific_name": {
          "type": "string",
          "description": "Exact indexed scientific name from smithsonian_get_object.scientific_names, e.g. \"Crotalus horridus\"; a bare genus (\"Crotalus\") also matches, across its species. Not enumerable via smithsonian_list_terms."
        },
        "online_media_type": {
          "type": "string",
          "description": "Exact indexed media category from smithsonian_list_terms { field: \"online_media_type\" }, e.g. \"Images\", \"3D Models\", \"Sound recordings\". Even Images does not guarantee attached or CC0 images; read smithsonian_get_object.media_summary for availability."
        }
      },
      "description": "Optional structured filters to narrow the search. A key outside this set is rejected by name.",
      "additionalProperties": false
    }
  },
  "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 — 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. Opens with the page size served when rows exceeded its cap."
    },
    "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 — commonly a decade (\"1960s\"), but the vocabulary also carries year ranges (\"500-1500\"), century terms (\"21st century\"), and BCE forms (\"-2500\", \"BCE 1000s\"). Sparse — 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 — 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 — not the online_only filter — predicts whether that call returns anything."
          },
          "record_id": {
            "type": "string",
            "description": "Unique object identifier — 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 — 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."
          },
          "holding_museum_name": {
            "type": "string",
            "description": "The unit that holds the object, from the record's own data source, when it differs from the unit that indexes it (unit_code). Absent otherwise."
          }
        },
        "description": "Curated summary of a single Smithsonian catalog object.",
        "additionalProperties": false
      },
      "description": "Curated object summaries for the current page."
    },
    "sources": {
      "type": "array",
      "items": {
        "enum": [
          "oa_mirror",
          "edan_api"
        ],
        "type": "string",
        "description": "oa_mirror: the server's local copy of the Smithsonian Open Access bulk metadata. edan_api: the live Smithsonian API."
      },
      "description": "Where this answer came from. A page served from oa_mirror lists its rows in mirror order, not the live API's, and its notice names the snapshot date. Present only on a server that keeps a mirror."
    },
    "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."
    },
    "mirror_snapshot": {
      "type": "string",
      "description": "Publication time (ISO 8601) of the Open Access snapshot the mirror held; what came from oa_mirror reflects the catalog as of then. Present when part of this answer came from oa_mirror."
    },
    "truncationCeiling": {
      "type": "number",
      "description": "Total matching objects (upper bound for omitted items)."
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "field"
  ],
  "properties": {
    "rows": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "multipleOf": 1,
      "description": "Number of terms to return per page (default 50). A value above 40000 is served at 40000 with a notice."
    },
    "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\" — 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 — 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 page size served: rows as requested, or its cap when rows exceeded it."
    },
    "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 for the corresponding smithsonian_search_objects filter. online_media_type values feed search only; browse_category supports museum (unit_code), culture, period (date), medium (object_type), and topic, with no media-type or place mode."
      },
      "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 — 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. Opens with the page size served when rows exceeded its cap."
    },
    "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) — upper bound for omitted items."
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}

{
  "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",
        "notes",
        "scientific_names",
        "coordinates",
        "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": {}
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "label",
          "content"
        ],
        "properties": {
          "label": {
            "type": "string",
            "description": "Catalog note label, or Note when absent."
          },
          "content": {
            "type": "string",
            "description": "Plain-text note content."
          }
        },
        "description": "A labeled catalog note.",
        "additionalProperties": false
      },
      "description": "All nonempty catalog notes in source order, including repeated labels."
    },
    "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 — 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."
    },
    "sources": {
      "type": "array",
      "items": {
        "enum": [
          "oa_mirror",
          "edan_api"
        ],
        "type": "string",
        "description": "oa_mirror: the server's local copy of the Smithsonian Open Access bulk metadata. edan_api: the live Smithsonian API."
      },
      "description": "Where this answer came from. A page served from oa_mirror lists its rows in mirror order, not the live API's, and its notice names the snapshot date. Present only on a server that keeps a mirror."
    },
    "taxonomy": {
      "type": "object",
      "properties": {
        "class": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "A class value."
          },
          "description": "Reported class values."
        },
        "order": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "An order value."
          },
          "description": "Reported order values."
        },
        "family": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "A family value."
          },
          "description": "Reported family values."
        },
        "phylum": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "A phylum value."
          },
          "description": "Reported phylum values."
        },
        "kingdom": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "A kingdom value."
          },
          "description": "Reported kingdom values."
        }
      },
      "description": "Reported taxonomic ranks; absent ranks remain omitted.",
      "additionalProperties": false
    },
    "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 the object is indexed under — the value a unit_code filter matches."
    },
    "dimensions": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "A dimension or measurement string."
      },
      "description": "Dimension and measurement strings."
    },
    "coordinates": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "latitude",
          "longitude"
        ],
        "properties": {
          "latitude": {
            "type": "number",
            "description": "Reported decimal latitude in degrees."
          },
          "locality": {
            "type": "string",
            "description": "Locality reported alongside this point."
          },
          "longitude": {
            "type": "number",
            "description": "Reported decimal longitude in degrees."
          }
        },
        "description": "A valid reported decimal coordinate pair.",
        "additionalProperties": false
      },
      "description": "Collection points without inferred precision or geocoding; empty when no valid decimal pairs exist."
    },
    "credit_line": {
      "type": "string",
      "description": "Attribution or credit string."
    },
    "description": {
      "type": "string",
      "description": "Best available prose description from Summary, Physical Description, Brief Description, Description, Description (Brief), or Citation notes. Absent when only administrative notes exist."
    },
    "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",
        "non_image_media"
      ],
      "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."
        },
        "non_image_media": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "type",
              "is_cc0"
            ],
            "properties": {
              "url": {
                "type": "string",
                "description": "The item's link — a 3D viewer, a scanned book, a document viewer, or a PDF. Absent when the catalog gives none."
              },
              "type": {
                "type": "string",
                "description": "Upstream media type, e.g. \"3d_voyager\", \"Scanned books\", \"slideshowXML\", \"Electronic resource\"."
              },
              "is_cc0": {
                "type": "boolean",
                "description": "True when this item is CC0 open access."
              }
            },
            "description": "A non-image media item.",
            "additionalProperties": false
          },
          "description": "Every media item smithsonian_get_media does not deliver — each item typed as something other than Images — in catalog order. Empty when there are none."
        }
      },
      "description": "Media availability summary, with a link to each non-image item. Call smithsonian_get_media for full image URLs.",
      "additionalProperties": false
    },
    "object_rights": {
      "type": "string",
      "description": "Rights statement from the catalog."
    },
    "mirror_snapshot": {
      "type": "string",
      "description": "Publication time (ISO 8601) of the Open Access snapshot the mirror held; what came from oa_mirror reflects the catalog as of then. Present when part of this answer came from oa_mirror."
    },
    "scientific_names": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "A catalog-reported scientific name."
      },
      "description": "All reported scientific names in source order; no accepted-name inference."
    },
    "holding_museum_name": {
      "type": "string",
      "description": "The unit that holds the object, from the record's own data source, when it differs from the unit that indexes it (unit_code). Absent otherwise."
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}

{
  "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 — the media is entirely non-image types such as 3D models, scanned books, or documents. `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 — 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."
    },
    "sources": {
      "type": "array",
      "items": {
        "enum": [
          "oa_mirror",
          "edan_api"
        ],
        "type": "string",
        "description": "oa_mirror: the server's local copy of the Smithsonian Open Access bulk metadata. edan_api: the live Smithsonian API."
      },
      "description": "Where this answer came from. A page served from oa_mirror lists its rows in mirror order, not the live API's, and its notice names the snapshot date. Present only on a server that keeps a mirror."
    },
    "record_id": {
      "type": "string",
      "description": "Smithsonian catalog record ID for the object."
    },
    "mirror_snapshot": {
      "type": "string",
      "description": "Publication time (ISO 8601) of the Open Access snapshot the mirror held; what came from oa_mirror reflects the catalog as of then. Present when part of this answer came from oa_mirror."
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}

{
  "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,
      "minimum": 1,
      "multipleOf": 1,
      "description": "Number of sample objects to return (default 10). A value above 1000 is served at 1000 with a notice."
    },
    "start": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Pagination offset — 0-indexed. Page contiguously by advancing start by the number of objects returned; a truncated page names the next start in its notice."
    },
    "value": {
      "type": "string",
      "description": "Category value appropriate to the mode. museum: a unit code like \"NASM\", \"SAAM\", or \"NMNHBIRDS\", matched literally and case-sensitively — not a museum name. culture: term, often plural or qualified (\"Aztecs\", \"Plains Indian\"). period: an indexed date term — 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 — 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 page size served: rows as requested, or its cap when rows exceeded it."
    },
    "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 — 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. Opens with the page size served when rows exceeded its cap."
    },
    "sources": {
      "type": "array",
      "items": {
        "enum": [
          "oa_mirror",
          "edan_api"
        ],
        "type": "string",
        "description": "oa_mirror: the server's local copy of the Smithsonian Open Access bulk metadata. edan_api: the live Smithsonian API."
      },
      "description": "Where this answer came from. A page served from oa_mirror lists its rows in mirror order, not the live API's, and its notice names the snapshot date. Present only on a server that keeps a mirror."
    },
    "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 — read thumbnail_url for that."
          },
          "record_id": {
            "type": "string",
            "description": "Object identifier — 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, or in mirror order when sources names oa_mirror. Empty when start is past the end of the category."
    },
    "mirror_snapshot": {
      "type": "string",
      "description": "Publication time (ISO 8601) of the Open Access snapshot the mirror held; what came from oa_mirror reflects the catalog as of then. Present when part of this answer came from oa_mirror."
    },
    "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
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}

{
  "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,
      "minimum": 1,
      "multipleOf": 1,
      "description": "Maximum number of related objects to return (default 10). A value above 1000 is served at 1000 with a notice."
    },
    "start": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Pagination offset — 0-indexed. Page contiguously by advancing start by the number of objects returned (a truncated page names the next start in its notice); 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 page size served: limit as requested, or its cap when limit exceeded it."
    },
    "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": "Composed page-size, partial-failure, empty-result, and paging guidance. Opens with the page size served when limit exceeded its cap. Failed signals carry safe categories; start pages the related set and signals[].search_continuation reaches a broader signal."
    },
    "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 — read thumbnail_url for that."
          },
          "record_id": {
            "type": "string",
            "description": "Object identifier — 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."
          },
          "holding_museum_name": {
            "type": "string",
            "description": "The unit that holds the object, from the record's own data source, when it differs from the unit that indexes it (unit_code). Absent otherwise."
          }
        },
        "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 — 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."
    },
    "sources": {
      "type": "array",
      "items": {
        "enum": [
          "oa_mirror",
          "edan_api"
        ],
        "type": "string",
        "description": "oa_mirror: the server's local copy of the Smithsonian Open Access bulk metadata. edan_api: the live Smithsonian API."
      },
      "description": "Where this answer came from. A page served from oa_mirror lists its rows in mirror order, not the live API's, and its notice names the snapshot date. Present only on a server that keeps a mirror."
    },
    "truncated": {
      "type": "boolean",
      "description": "True when the related list is incomplete — either capped by the limit or more results exist upstream past the current page (advance start to retrieve them)."
    },
    "mirror_snapshot": {
      "type": "string",
      "description": "Publication time (ISO 8601) of the Open Access snapshot the mirror held; what came from oa_mirror reflects the catalog as of then. Present when part of this answer came from oa_mirror."
    },
    "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 — 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
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true
}

skill://smithsonian-guide/SKILL.md

skill://{+path}