addedInput schema / properties / includeImages
Added value: +{
+ "default": false,
+ "description": "Also attach the web-display image (primaryImageSmall, about 600 px on the long edge) of the first 3 returned records that have hasCC0Image true, in request order, as image blocks in content[], each after a caption naming its objectID. images[] reports what happened for every returned record. The image bytes ride content[] only, so a client that hands the model only structuredContent will not show the images. Default false: no image is fetched.",
+ "type": "boolean"
+}
changedOutput schema / properties / error / properties / data / properties / reason / description
Previous value: -"Machine-readable failure mode. Declared by this tool: `all_not_found`: Every requested objectID returned a 404 — all IDs are stale or invalid. `all_failed`: Every requested objectID failed due to network errors or API downtime. `upstream_blocked`: No object was fetched and the Met API's firewall refused requests with HTTP 403 — it blocks this server's address, not one object. `retry_deadline_exceeded`: No object was fetched and every fetch ran out of the call's time budget, retries and backoff included — an ID whose fetch would have started after the budget was spent counts too. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `all_not_found`: Every requested objectID returned a 404 — all IDs are stale or invalid. `all_failed`: No object was fetched, no failure was a firewall block or a 500/502/503/504 outage, and the failures were neither all 404s nor all time-budget expiries — network errors, other HTTP errors, or 404s beside expiries. `upstream_blocked`: No object was fetched and the Met API's firewall refused requests with HTTP 403 — it blocks this server's address, not one object. `upstream_unavailable`: No object was fetched and a fetch exhausted its retries on HTTP 500, 502, 503, or 504 — an outage on the Met API's side, not a problem with the IDs. `retry_deadline_exceeded`: No object was fetched and every fetch ran out of the call's time budget, retries and backoff included — an ID whose fetch would have started after the budget was spent counts too. Other values are possible when a failure originates below the handler."
changedOutput schema / properties / error / properties / data / properties / reason / examples
Previous value: -[
- "all_not_found",
- "all_failed",
- "upstream_blocked",
- "retry_deadline_exceeded"
-]New value: +[
+ "all_not_found",
+ "all_failed",
+ "upstream_blocked",
+ "upstream_unavailable",
+ "retry_deadline_exceeded"
+]
addedOutput schema / properties / images
Added value: +{
+ "description": "Image outcome for each record in objects[], in request order; deferred and failed IDs get no entry. Present only when includeImages is true.",
+ "items": {
+ "additionalProperties": false,
+ "description": "A returned record's image outcome.",
+ "properties": {
+ "objectID": {
+ "description": "Object ID of a returned record.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "status": {
+ "description": "attached: the image rides content[], after a caption naming the objectID. no_cc0_image: the record has no CC0 image, so nothing was fetched. over_cap: 3 earlier CC0 records took the image slots — request this ID among the first 3 CC0 records of another call to see its image. unavailable: the image host returned no image in time, or the URL was not on the Met image host.",
+ "enum": [
+ "attached",
+ "no_cc0_image",
+ "over_cap",
+ "unavailable"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "objectID",
+ "status"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+}
addedOutput schema / properties / objects / items / properties / accessionYear
Added value: +{
+ "description": "Year the Met acquired the object, as sent (e.g., \"1960\") — occasionally a full date (e.g., \"2005-02-15\"). Can differ from the year in creditLine. Empty when the Met records none.",
+ "type": "string"
+}
changedOutput schema / properties / objects / items / properties / artistBeginDate / description
Previous value: -"Artist birth year, or a firm's founding year, as a string (e.g., \"1853\"). Occasionally a full date (e.g., \"1928-01-10\"). Empty for anonymous works."New value: +"Birth year of the person artistDisplayName names, or a firm's founding year, as a string (e.g., \"1853\") — that person's even when artistPrefix qualifies the attribution. Occasionally a full date (e.g., \"1928-01-10\"). Empty for anonymous works."
changedOutput schema / properties / objects / items / properties / artistDisplayName / description
Previous value: -"Primary artist name as displayed (e.g., \"Vincent van Gogh\"). Empty for anonymous or unknown works."New value: +"Name of the person or firm the attribution names (e.g., \"Vincent van Gogh\"), without the qualifier in artistPrefix or the text in artistSuffix — read those and artistRole with it. Empty for anonymous or unknown works."
changedOutput schema / properties / objects / items / properties / artistEndDate / description
Previous value: -"Artist death year, or a firm's closing year, as a string (e.g., \"1890\"). Occasionally a full date (e.g., \"1928-01-10\"). Empty for a living artist, a firm still active, or an anonymous work."New value: +"Death year of the person artistDisplayName names, or a firm's closing year, as a string (e.g., \"1890\") — that person's even when artistPrefix qualifies the attribution. Occasionally a full date (e.g., \"1928-01-10\"). Empty for a living artist, a firm still active, or an anonymous work."
addedOutput schema / properties / objects / items / properties / artistPrefix
Added value: +{
+ "description": "Qualifier the Met places before artistDisplayName (e.g., \"Style of\", \"Workshop of\", \"Attributed to\", \"Published by\"). Read the two together: \"Style of\" with \"Rembrandt\" is a work in Rembrandt's style, not one by him. Empty when the attribution is unqualified.",
+ "type": "string"
+}
addedOutput schema / properties / objects / items / properties / artistRole
Added value: +{
+ "description": "The named person's role for this object (e.g., \"Artist\", \"Maker\", \"Publisher\", \"Patron\") — a patron or publisher is not the maker. Empty when the record names no one.",
+ "type": "string"
+}
addedOutput schema / properties / objects / items / properties / artistSuffix
Added value: +{
+ "description": "Text the Met places after artistDisplayName (e.g., \"(r. 1876–1909)\", \", Paris\", \"(?)\"). Empty when the Met records none.",
+ "type": "string"
+}
changedOutput schema / properties / objects / items / properties / department / description
Previous value: -"Curatorial department (e.g., \"European Paintings\", \"Egyptian Art\")."New value: +"Curatorial department as the record names it (e.g., \"European Paintings\", \"Egyptian Art\"). Five departments carry a different name on their records than in met_list_departments — \"The American Wing\", \"The Michael C. Rockefeller Wing\", \"Costume Institute\", \"Robert Lehman Collection\", \"Modern and Contemporary Art\" — so match departments by departmentId, not by name."
addedOutput schema / properties / objects / items / properties / departmentId
Added value: +{
+ "anyOf": [
+ {
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The department's numeric ID, resolved from department, for the departmentId filter of met_list_objects and met_search_collections. Null when the record's department name was not recognized — never a guess."
+}
addedOutput schema / properties / objects / items / properties / metadataDate
Added value: +{
+ "description": "When the Met last created or revised this record: an ISO 8601 UTC timestamp, as sent (e.g., \"2026-10-01T04:59:29.693Z\"; fractional seconds run from none to three digits). Its UTC date is what met_list_objects updatedSince compares, that day included. Empty when the Met sends none.",
+ "type": "string"
+}
changedOutput schema / properties / objects / items / properties / primaryImageSmall / description
Previous value: -"Web-display image URL (~800px; CC0 objects only; empty string for non-public-domain works)."New value: +"Web-display image URL (about 600 px on the long edge; CC0 objects only; empty string for non-public-domain works)."
addedOutput schema / properties / objects / items / properties / rightsAndReproduction
Added value: +{
+ "description": "Rights holder and reproduction notice (e.g., \"© 2026 Pollock-Krasner Foundation / Artists Rights Society (ARS), New York\"). Most copyrighted records carry none, so an empty value does not make a work free to reuse — isPublicDomain decides that.",
+ "type": "string"
+}
changedOutput schema / properties / objects / items / required
Previous value: -[
- "objectID",
- "title",
- "isPublicDomain",
- "hasCC0Image",
- "primaryImage",
- "primaryImageSmall",
- "additionalImages",
- "objectURL",
- "department",
- "objectName",
- "classification",
- "isHighlight",
- "isTimelineWork",
- "artistDisplayName",
- "artistDisplayBio",
- "artistNationality",
- "artistBeginDate",
- "artistEndDate",
- "constituents",
- "objectDate",
- "objectBeginDate",
- "objectEndDate",
- "medium",
- "dimensions",
- "culture",
- "period",
- "dynasty",
- "accessionNumber",
- "creditLine",
- "country",
- "region",
- "geography",
- "measurements",
- "tags",
- "objectWikidata_URL",
- "GalleryNumber"
-]New value: +[
+ "objectID",
+ "title",
+ "isPublicDomain",
+ "hasCC0Image",
+ "primaryImage",
+ "primaryImageSmall",
+ "additionalImages",
+ "objectURL",
+ "department",
+ "departmentId",
+ "objectName",
+ "classification",
+ "isHighlight",
+ "isTimelineWork",
+ "artistPrefix",
+ "artistDisplayName",
+ "artistSuffix",
+ "artistRole",
+ "artistDisplayBio",
+ "artistNationality",
+ "artistBeginDate",
+ "artistEndDate",
+ "constituents",
+ "objectDate",
+ "objectBeginDate",
+ "objectEndDate",
+ "medium",
+ "dimensions",
+ "culture",
+ "period",
+ "dynasty",
+ "accessionNumber",
+ "accessionYear",
+ "creditLine",
+ "rightsAndReproduction",
+ "country",
+ "region",
+ "geography",
+ "measurements",
+ "tags",
+ "objectWikidata_URL",
+ "GalleryNumber",
+ "metadataDate"
+]