{"openapi":"3.1.0","info":{"title":"Gallery API","version":"0.1.0","description":"Search open-access artworks across the Met, Art Institute of Chicago and Cleveland Museum of Art; artwork detail, artists, highlights, artwork of the day, departments, art movements.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://gallery.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/gallery/docs"},"termsOfService":"https://connectorbay.com/gallery/terms"},"servers":[{"url":"https://gallery.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/gallery/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_artworks":{"post":{"operationId":"search_artworks","summary":"Search artworks with images across the Met, Art Institute of Chicago and Cleveland Museum of Art, interleaved","description":"Search artworks with images across the Met, Art Institute of Chicago and Cleveland Museum of Art, interleaved\n    by museum. Use for \"Van Gogh paintings\", \"Japanese woodblock prints\", \"Chola bronzes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Artist, title, subject, culture or medium.","examples":["Van Gogh","Great Wave","Mughal miniature","bronze Buddha","sunflowers"],"title":"Query","type":"string"},"sources":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comma list of met, aic, cma (default all).","title":"Sources"},"limit":{"default":9,"maximum":24,"minimum":1,"title":"Limit","type":"integer"}},"required":["query"],"title":"search_artworksArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/artwork":{"post":{"operationId":"artwork","summary":"Full record for one artwork: artist and bio, date, medium, dimensions, department, culture/period, credit,","description":"Full record for one artwork: artist and bio, date, medium, dimensions, department, culture/period, credit,\n    on-view location, public-domain status, image and wall text. Use after `search_artworks`.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Artwork id: met:<objectID>, aic:<id> or cma:<id>.","examples":["met:436532","aic:16568","cma:124089"],"title":"Id","type":"string"}},"required":["id"],"title":"artworkArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/artist":{"post":{"operationId":"artist","summary":"An artist's works across the three museums (filtered to that artist where the API allows) plus dates and a","description":"An artist's works across the three museums (filtered to that artist where the API allows) plus dates and a\n    short bio when the Art Institute has one. Use for \"works by Rembrandt\", \"who was Amrita Sher-Gil\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Artist name.","examples":["Claude Monet","Raja Ravi Varma","Hokusai","Georgia O'Keeffe"],"title":"Name","type":"string"},"limit":{"default":9,"maximum":24,"minimum":1,"title":"Limit","type":"integer"}},"required":["name"],"title":"artistArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/highlights":{"post":{"operationId":"highlights","summary":"Curated highlights — the Met's 'highlight' objects, the Art Institute's boosted works and Cleveland CC0 works","description":"Curated highlights — the Met's 'highlight' objects, the Art Institute's boosted works and Cleveland CC0 works\n    with images — for a topic. Use for \"masterpieces of Indian art\", \"must-see paintings\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"default":"painting","description":"Topic to pick highlights from.","examples":["painting","sculpture","India","Egypt","Impressionism"],"title":"Query","type":"string"},"sources":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"met, aic, cma (default all).","title":"Sources"},"limit":{"default":9,"maximum":18,"minimum":1,"title":"Limit","type":"integer"}},"title":"highlightsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/artwork_of_the_day":{"post":{"operationId":"artwork_of_the_day","summary":"A deterministic artwork for today (same answer all day) from the Met's highlights on a theme, with full","description":"A deterministic artwork for today (same answer all day) from the Met's highlights on a theme, with full\n    detail. Use for \"art for today\", \"daily painting\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"default":"painting","description":"Optional theme.","examples":["painting","landscape","portrait","Asia"],"title":"Topic","type":"string"}},"title":"artwork_of_the_dayArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/departments":{"post":{"operationId":"departments","summary":"The Metropolitan Museum's 19 curatorial departments with ids (usable as context for searches).","description":"The Metropolitan Museum's 19 curatorial departments with ids (usable as context for searches).","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"departmentsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/art_movement":{"post":{"operationId":"art_movement","summary":"A guide to an art movement — period, where, traits, key artists and works — or the list of all 31 covered","description":"A guide to an art movement — period, where, traits, key artists and works — or the list of all 31 covered\n    (Renaissance to Street Art, including the Bengal School and the Bombay Progressives). Use for \"what is\n    Fauvism\", \"which movement was Dalí\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Movement, alias or an artist in it.","examples":["Cubism","Impressionism","Bengal School","Pollock"],"title":"Name"}},"title":"art_movementArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}