{"openapi":"3.0.3","info":{"title":"Gnist Context — Art & Museum Collections","description":"Search 470K+ artworks from the Metropolitan Museum of Art and 120K+ from the Art Institute of Chicago — titles, artists, dates, media, images, and full provenance.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/museum/`\n- **Toolkit page:** `/toolkits/museum`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/museum/search_artworks":{"post":{"tags":["Media"],"summary":"search_artworks","description":"Search artworks across the Metropolitan Museum of Art (470K+ objects) and Art Institute of Chicago (120K+ objects).\n\nReturns titles, artists, dates, media, dimensions, departments, images, and more.\nSearch both institutions at once or filter to one.\n\nExamples:\n    search_artworks(\"impressionism\") → Impressionist works from both museums\n    search_artworks(\"armor\", institution=\"met\", department_id=4) → Arms and Armor at the Met\n    search_artworks(\"Monet water lilies\", institution=\"aic\") → Monet at Art Institute of Chicago\n\nReturns:\n    total, results (list of artworks with metadata and image URLs), query.","operationId":"museum_search_artworks","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Search term — artist, title, style, subject. Example: 'Van Gogh sunflowers'.","type":"string"},"institution":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by institution: 'met' (Metropolitan Museum of Art) or 'aic' (Art Institute of Chicago). Omit to search both."},"department_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Met Museum department ID filter (use get_departments to list). Only applies when institution='met'."},"is_highlight":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Only return highlighted/notable works. Met only."},"has_images":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Only return works with images. Met only."},"medium":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by medium, e.g. 'Paintings', 'Sculpture', 'Photographs'. Met only."},"date_begin":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Start year filter, e.g. 1800. Met only."},"date_end":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"End year filter, e.g. 1900. Met only."},"limit":{"default":5,"description":"Max results to return (1-10).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/museum/get_artwork":{"post":{"tags":["Media"],"summary":"get_artwork","description":"Get full details for a specific artwork by ID and institution.\n\nReturns complete metadata: title, artist, dates, medium, dimensions, department,\nclassification, culture, period, credit line, public domain status, image URLs,\ntags, and Wikidata links (Met) or provenance, exhibition history, and description (AIC).\n\nExamples:\n    get_artwork(436535, \"met\") → Van Gogh's Wheat Field with Cypresses\n    get_artwork(27992, \"aic\") → Seurat's A Sunday on La Grande Jatte\n\nReturns:\n    Full artwork metadata dict.","operationId":"museum_get_artwork","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"object_id":{"description":"Artwork ID from the institution.","type":"integer"},"institution":{"description":"Institution: 'met' (Metropolitan Museum) or 'aic' (Art Institute of Chicago).","type":"string"}},"required":["object_id","institution"],"type":"object"}}}}}},"/rest/museum/get_departments":{"post":{"tags":["Media"],"summary":"get_departments","description":"List all curatorial departments at the Metropolitan Museum of Art.\n\nReturns department IDs and names. Use department IDs to filter search_artworks results.\n\nDepartments include: American Decorative Arts, Ancient West Asian Art, Arms and Armor,\nAsian Art, The Cloisters, European Paintings, Egyptian Art, Photographs, Modern Art, and more.\n\nReturns:\n    departments (list of {id, name}).","operationId":"museum_get_departments","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/museum/report_feedback":{"post":{"tags":["Media"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"museum_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Media","description":"Data sources: Media"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}