MCP-Server

art-institute-chicago-mcp-server

io.github.cyanheads/art-institute-chicago-mcp-server
Wissen & Dokumentation Medien & Inhalte Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Searches and retrieves Art Institute of Chicago artwork, artist, exhibition, vocabulary, and audio-guide records.

artic_get_artworks
Get artworks
Fetch full Art Institute of Chicago records for up to 10 artworks by id: description, provenance, exhibition and publication history, dimensions, inscriptions, credit line, categorization, gallery, image URLs with rights status, and related multimedia. Long histories are opt-in through sections. Ids come from artic_search_artworks, artic_search_exhibitions, or artic_search_artists.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ids'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 10, 'minItems': 1, 'description': 'Artwork ids, 1 to 10, as an array or a comma-separated string; https://www.artic.edu/artworks/<id> page URLs are read as their id. Duplicates are dropped.'}, 'sections': {'type': 'array', 'items': {'enum': ['description', 'provenance', 'exhibition_history', 'publication_history', 'catalogue'], 'type': 'string'}, 'default': ['description', 'provenance'], 'maxItems': 5, 'description': 'Heavy text sections to include: description (also short_description), provenance, exhibition_history, publication_history, catalogue. Defaults to description and provenance; pass an empty array for none.'}, 'include_related_media': {'type': 'boolean', 'default': True, 'description': 'Load related multimedia (lectures, audio stops) for the records, up to 20 items per call.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['artworks', 'missing_ids', 'deferred_ids', 'license_text']}, {'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': ['rate_limited', 'request_blocked', 'upstream_rejected_query'], 'description': "Machine-readable failure mode. Declared by this tool: `rate_limited`: The Art Institute API throttled this server and retries ran out, or the shared request queue could not start the call in time. `request_blocked`: The Art Institute API's firewall blocked the request, as it does for markup or script-like text and for bursts of traffic. `upstream_rejected_query`: The Art Institute API rejected a request this server built from valid inputs. 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': {}}, 'notice': {'type': 'string', 'description': 'Guidance when ids are missing or deferred, or related media was capped or could not load.'}, 'artworks': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'is_public_domain', 'is_on_view', 'web_url', 'main_reference_number', 'artist_ids', 'styles', 'subjects', 'materials', 'techniques', 'themes'], 'properties': {'id': {'type': 'number', 'description': 'Artwork id; pass to artic_get_artworks.'}, 'image': {'type': 'object', 'required': ['url', 'iiif_info_url', 'rights'], 'properties': {'url': {'type': 'string', 'description': 'IIIF image 843 px wide, the museum display size; available for every image, public domain or not.'}, 'width': {'type': 'number', 'description': 'Full image width in pixels.'}, 'height': {'type': 'number', 'description': 'Full image height in pixels.'}, 'rights': {'enum': ['public_domain', 'in_copyright'], 'type': 'string', 'description': 'Reuse status: public_domain images are CC0; in_copyright images need a rights check before reuse.'}, 'alt_text': {'type': 'string', 'description': 'Alt text the museum wrote for the image.'}, 'url_large': {'type': 'string', 'description': 'IIIF image 1686 px wide; present only for public-domain works.'}, 'iiif_info_url': {'type': 'string', 'description': 'IIIF info.json URL listing the image dimensions, sizes, and tiles.'}}, 'description': 'Primary image with constructed IIIF URLs and its reuse status; absent when the work has no image.', 'additionalProperties': False}, 'style': {'type': 'string', 'description': 'Preferred style.'}, 'title': {'type': 'string', 'description': 'Title as catalogued; empty when the museum lists none.'}, 'medium': {'type': 'string', 'description': 'Medium and support as displayed.'}, 'styles': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Every style the museum assigns.'}, 'themes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Themes the museum assigns.'}, 'edition': {'type': 'string', 'description': 'Edition statement for prints and multiples.'}, 'gallery': {'type': 'string', 'description': 'Gallery where the work is on view, such as Gallery 240.'}, 'on_loan': {'type': 'string', 'description': 'Loan statement when the work is on loan.'}, 'web_url': {'type': 'string', 'description': 'Public page for the artwork on artic.edu.'}, 'date_end': {'type': 'number', 'description': 'Latest year of the date span, negative for BCE; omitted when absent or implausible.'}, 'subjects': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Subjects the museum assigns.'}, 'artist_id': {'type': 'number', 'description': 'Id of the preferred credited artist; pass as artist_id to artic_search_artworks.'}, 'catalogue': {'type': 'string', 'description': 'Catalogue raisonne entries; returned with the catalogue section.'}, 'materials': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Materials the museum records.'}, 'alt_images': {'type': 'array', 'items': {'type': 'object', 'required': ['url', 'iiif_info_url'], 'properties': {'url': {'type': 'string', 'description': 'IIIF image 843 px wide.'}, 'iiif_info_url': {'type': 'string', 'description': 'IIIF info.json URL for the image.'}}, 'description': 'One alternate image.', 'additionalProperties': False}, 'description': 'Alternate images (other views, details); same rights as the primary image.'}, 'alt_titles': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Other titles the work is known by.'}, 'artist_ids': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Ids of every credited artist; pass one as artist_id to artic_search_artworks.'}, 'date_start': {'type': 'number', 'description': 'Earliest year of the date span, negative for BCE; omitted when absent or implausible.'}, 'department': {'type': 'string', 'description': 'Curatorial department.'}, 'dimensions': {'type': 'string', 'description': 'Dimensions as catalogued.'}, 'is_on_view': {'type': 'boolean', 'description': 'True when the work is on view at the museum now.'}, 'provenance': {'type': 'string', 'description': 'Ownership history; returned with the provenance section.'}, 'techniques': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Techniques the museum records.'}, 'credit_line': {'type': 'string', 'description': 'Credit line naming how the museum acquired the work.'}, 'description': {'type': 'string', 'description': 'Curatorial description, CC BY 4.0: credit the Art Institute of Chicago and cite web_url. Present when the description section was requested and the museum wrote one.'}, 'artwork_type': {'type': 'string', 'description': 'Artwork type, such as Painting or Print.'}, 'date_display': {'type': 'string', 'description': 'Date as the museum displays it; the authority when the years are absent.'}, 'inscriptions': {'type': 'string', 'description': 'Inscriptions, signatures, and marks as catalogued.'}, 'manifest_url': {'type': 'string', 'description': 'IIIF Presentation manifest URL; present for public-domain works.'}, 'related_media': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string', 'description': 'Multimedia asset id (uuid).'}, 'url': {'type': 'string', 'description': 'Asset URL on artic.edu.'}, 'type': {'type': 'string', 'description': 'Asset type, such as sound.'}, 'title': {'type': 'string', 'description': 'Asset title; empty when the museum lists none.'}}, 'description': 'One related multimedia asset.', 'additionalProperties': False}, 'description': 'Related multimedia (lectures, audio stops) from the museum; present when requested and at least one linked item loaded, never an empty list.'}, 'artist_display': {'type': 'string', 'description': 'Artist, nationality, and life dates as the museum displays them.'}, 'classification': {'type': 'string', 'description': 'Preferred classification.'}, 'date_qualifier': {'type': 'string', 'description': 'What the date marks, such as Made or Printed.'}, 'place_of_origin': {'type': 'string', 'description': 'Place the work was made.'}, 'copyright_notice': {'type': 'string', 'description': 'Copyright notice for the work.'}, 'is_public_domain': {'type': 'boolean', 'description': 'True when the work is public domain, so its images are CC0.'}, 'short_description': {'type': 'string', 'description': 'Short curatorial description, attributed like description; returned with the description section.'}, 'exhibition_history': {'type': 'string', 'description': 'Exhibitions the work has appeared in; returned with the exhibition_history section.'}, 'publication_history': {'type': 'string', 'description': 'Publications citing the work; returned with the publication_history section.'}, 'main_reference_number': {'type': 'string', 'description': 'Museum reference (accession) number; empty when the museum lists none.'}}, 'description': 'One full artwork record.', 'additionalProperties': False}, 'description': 'Records in request order; ids the museum does not have are left out.'}, 'missing_ids': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Requested ids with no artwork, in request order.'}, 'deferred_ids': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Found ids left out because the response budget was reached; request them in a follow-up call.'}, 'license_text': {'type': 'string', 'description': 'License statement from the API for this data, verbatim.'}, 'description_attribution': {'type': 'string', 'description': 'Attribution owed for description text (CC BY 4.0); present when any is returned.'}}, 'additionalProperties': False}
artic_lookup_vocabulary
Look up collection vocabulary
List the values of an Art Institute of Chicago collection vocabulary with how many artworks carry each, most common first, optionally narrowed by a substring. Each value passes to the artic_search_artworks filter of the same name exactly as listed (case is ignored). Counts here span the whole collection; for counts within a filtered set of artworks, request facets from artic_search_artworks.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['vocabulary'], 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1, 'description': 'Values to return, most common first (1-100).'}, 'contains': {'type': 'string', 'maxLength': 60, 'description': 'Case- and accent-insensitive substring the values must contain, such as "impress" for Impressionism and Post-Impressionism, or "applique" for appliqué (technique). Omit to list the most common values.'}, 'vocabulary': {'enum': ['department', 'artwork_type', 'style', 'subject', 'classification', 'material', 'technique', 'theme', 'place_of_origin', 'gallery'], 'type': 'string', 'description': 'Vocabulary to list; its values feed the artic_search_artworks filter of the same name.'}, 'public_domain_only': {'type': 'boolean', 'default': False, 'description': 'Count only public-domain artworks.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['vocabulary', 'filter_param', 'values', 'truncated', 'shown', 'cap']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The limit 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': ['rate_limited', 'request_blocked', 'upstream_rejected_query'], 'description': "Machine-readable failure mode. Declared by this tool: `rate_limited`: The Art Institute API throttled this server and retries ran out, or the shared request queue could not start the call in time. `request_blocked`: The Art Institute API's firewall blocked the request, as it does for markup or script-like text and for bursts of traffic. `upstream_rejected_query`: The Art Institute API rejected a request this server built from valid inputs. 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': 'Values returned.'}, 'notice': {'type': 'string', 'description': 'Guidance when no value matched or the list was capped.'}, 'values': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'artwork_count'], 'properties': {'value': {'type': 'string', 'description': 'Value as the index stores it (place values are lower-case without accents); pass it back verbatim.'}, 'artwork_count': {'type': 'number', 'description': 'Artworks carrying this value.'}}, 'description': 'One vocabulary value and its artwork count.', 'additionalProperties': False}, 'description': 'Values, most common first.'}, 'truncated': {'type': 'boolean', 'description': 'True when more values exist beyond the limit.'}, 'vocabulary': {'enum': ['department', 'artwork_type', 'style', 'subject', 'classification', 'material', 'technique', 'theme', 'place_of_origin', 'gallery'], 'type': 'string', 'description': 'The vocabulary listed.'}, 'filter_param': {'enum': ['department', 'artwork_type', 'style', 'subject', 'classification', 'material', 'technique', 'theme', 'place_of_origin', 'gallery'], 'type': 'string', 'description': 'The artic_search_artworks parameter that accepts these values as listed.'}}, 'additionalProperties': False}
artic_search_artists
Search artists
Find artists, cultures, and organizations in the Art Institute of Chicago collection by name, or fetch them by id. Each result carries life dates, agent type, alternate names, how many of the museum's artworks credit them, and up to three of their works, the museum's highlighted works first. Pass an id to artic_search_artworks as artist_id to browse all of their works.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ids': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 25, 'description': "Agent ids to fetch (up to 25), such as an artwork's artist_id, as an array or a comma-separated string. Pass query or ids, not both; the other filters and page apply to query only."}, 'page': {'type': 'integer', 'default': 1, 'maximum': 100, 'minimum': 1, 'description': 'Query mode: page to return (1-based); page times limit may not exceed 1,000.'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 25, 'minimum': 1, 'description': 'Query mode: agents per page (1-25).'}, 'query': {'type': 'string', 'maxLength': 120, 'description': 'Name to find, matched against names and alternate names; every word must match. Pass query or ids, not both.'}, 'born_to': {'type': 'integer', 'maximum': 2100, 'minimum': -8000, 'description': 'Query mode: latest birth year, negative for BCE.'}, 'born_from': {'type': 'integer', 'maximum': 2100, 'minimum': -8000, 'description': 'Query mode: earliest birth year, negative for BCE.'}, 'artists_only': {'type': 'boolean', 'default': True, 'description': 'Query mode: only agents the museum records as artists. Set false to include donors, funds, and organizations.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['artists', 'page', 'has_more', 'artists_only_applied', 'license_text', 'totalCount', 'truncated', 'shown', 'cap']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The limit applied to this page, or the number of ids requested.'}, 'page': {'type': 'number', 'description': 'Page returned (1-based); always 1 when ids were passed.'}, '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': ['query_or_ids_required', 'query_and_ids_conflict', 'invalid_year_range', 'page_beyond_window', 'rate_limited', 'request_blocked', 'upstream_rejected_query'], 'description': "Machine-readable failure mode. Declared by this tool: `query_or_ids_required`: Neither query nor ids was given. `query_and_ids_conflict`: Both query and ids were given. `invalid_year_range`: born_from is later than born_to. `page_beyond_window`: page times limit exceeds 1,000, past the reachable search window. `rate_limited`: The Art Institute API throttled this server and retries ran out, or the shared request queue could not start the call in time. `request_blocked`: The Art Institute API's firewall blocked the request, as it does for markup or script-like text and for bursts of traffic. `upstream_rejected_query`: The Art Institute API rejected a request this server built from valid inputs. 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': 'Agents returned on this page.'}, 'notice': {'type': 'string', 'description': 'Guidance when nothing matched, ids were missing, more pages exist, the reachable window is exhausted, or artwork counts could not be loaded.'}, 'artists': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'alt_names', 'is_artist'], 'properties': {'id': {'type': 'number', 'description': 'Agent id; pass as artist_id to artic_search_artworks.'}, 'name': {'type': 'string', 'description': 'Name as the museum catalogues it; empty when the museum lists none.'}, 'alt_names': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Other names and spellings the museum records.'}, 'biography': {'type': 'string', 'description': 'Biography the museum wrote; present for about 1% of agents.'}, 'is_artist': {'type': 'boolean', 'description': 'True when the museum records the agent as an artist; false for donors, funds, and organizations.'}, 'sort_name': {'type': 'string', 'description': 'Name in sort order, such as surname first.'}, 'agent_type': {'type': 'string', 'description': 'Kind of agent as the museum records it, such as a person or an organization.'}, 'birth_year': {'type': 'number', 'description': 'Birth year, negative for BCE; omitted when unknown or implausible.'}, 'death_year': {'type': 'number', 'description': 'Death year, negative for BCE; omitted when unknown or implausible.'}, 'sample_works': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title'], 'properties': {'id': {'type': 'number', 'description': 'Artwork id; pass to artic_get_artworks.'}, 'title': {'type': 'string', 'description': 'Title as catalogued; empty when the museum lists none.'}, 'date_display': {'type': 'string', 'description': 'Date as the museum displays it.'}}, 'description': "One of the agent's artworks.", 'additionalProperties': False}, 'description': "Up to three of the agent's artworks, the museum's highlighted works first; absent only when counts could not be loaded."}, 'artwork_count': {'type': 'number', 'description': 'Artworks in the collection crediting this agent (0 when none); absent only when counts could not be loaded.'}}, 'description': 'One matching agent.', 'additionalProperties': False}, 'description': 'Matching agents: in relevance order for a name search, in request order for ids.'}, 'has_more': {'type': 'boolean', 'description': 'True when more matches exist beyond this page.'}, 'next_page': {'type': 'number', 'description': 'Page to request next; absent when nothing remains or the next page would pass the first 1,000 matches.'}, 'truncated': {'type': 'boolean', 'description': 'True when more matches exist beyond this page.'}, 'totalCount': {'type': 'number', 'description': 'Matches for the query and filters before paging, or agents found for ids.'}, 'missing_ids': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Requested ids with no agent, in request order; present when ids were passed.'}, 'license_text': {'type': 'string', 'description': 'License statement from the API for this data, verbatim.'}, 'artists_only_applied': {'type': 'boolean', 'description': 'Whether results were limited to artists; always false when ids were passed, since every requested agent is returned.'}}, 'additionalProperties': False}
artic_search_artworks
Search artworks
Search the Art Institute of Chicago collection by text and structured filters, ranked by relevance or sorted by date. Text matches all words across titles, artists, descriptions, provenance, and other catalog fields. Filters combine with AND. Results reach the first 1,000 matches; narrow with filters for more. Set limit to 0 with facets to get only counts. Use artic_lookup_vocabulary for filter values and artic_get_artworks for full records.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'default': 1, 'maximum': 1000, 'minimum': 1, 'description': 'Page to return (1-based); page times limit may not exceed 1,000.'}, 'sort': {'enum': ['relevance', 'date_asc', 'date_desc'], 'type': 'string', 'default': 'relevance', 'description': 'relevance ranks by query text, or by museum popularity without it; date_asc and date_desc sort by start year.'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 12, 'minimum': 0, 'description': 'Rows per page (0-12; capped so a page of long catalog records with every facet stays within common tool-output limits); 0 returns only totalCount and facets.'}, 'query': {'type': 'string', 'maxLength': 200, 'description': 'Text matched against titles, artists, descriptions, provenance, and other catalog fields; every word must match. Supports "exact phrase", -exclude, and a | b.'}, 'style': {'type': 'string', 'maxLength': 120, 'description': 'Style title as artic_lookup_vocabulary lists it (case ignored), such as Impressionism; matches preferred or alternate styles.'}, 'theme': {'type': 'string', 'maxLength': 120, 'description': 'Theme title as artic_lookup_vocabulary lists it (case ignored), such as Women artists.'}, 'artist': {'type': 'string', 'maxLength': 120, 'description': 'Artist or culture name matched against every credited artist (all words must match).'}, 'facets': {'type': 'array', 'items': {'enum': ['department', 'artwork_type', 'style', 'subject', 'classification', 'place_of_origin', 'artist'], 'type': 'string'}, 'maxItems': 7, 'description': 'Facet counts to compute over the filtered set (top 15 values each): department, artwork_type, style, subject, classification, place_of_origin, artist. An array or a comma-separated string.'}, 'gallery': {'type': 'string', 'maxLength': 120, 'description': 'Gallery where the work is on view, such as Gallery 240 (a bare 240 is read as Gallery 240). Only on-view works carry a gallery.'}, 'subject': {'type': 'string', 'maxLength': 120, 'description': 'Subject title as artic_lookup_vocabulary lists it (case ignored).'}, 'year_to': {'type': 'integer', 'maximum': 2100, 'minimum': -8000, 'description': 'Latest year; a work matches when its date span overlaps year_from to year_to. Negative for BCE.'}, 'material': {'type': 'string', 'maxLength': 120, 'description': 'Material title as artic_lookup_vocabulary lists it (case ignored), such as ink or gold leaf.'}, 'artist_id': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Agent id from artic_search_artists or an artist facet row; matches preferred and other credits.', 'exclusiveMinimum': 0}, 'has_image': {'type': 'boolean', 'default': False, 'description': 'Only works with an image.'}, 'technique': {'type': 'string', 'maxLength': 120, 'description': 'Technique title as artic_lookup_vocabulary lists it (case ignored), such as black-and-white photography or plain weaving.'}, 'year_from': {'type': 'integer', 'maximum': 2100, 'minimum': -8000, 'description': 'Earliest year; a work matches when its date span overlaps year_from to year_to. Negative for BCE.'}, 'department': {'type': 'string', 'maxLength': 120, 'description': 'Department title exactly as artic_lookup_vocabulary lists it (case ignored), such as Prints and Drawings.'}, 'artwork_type': {'type': 'string', 'maxLength': 120, 'description': 'Artwork type title as artic_lookup_vocabulary lists it (case ignored), such as Painting or Print.'}, 'on_view_only': {'type': 'boolean', 'default': False, 'description': 'Only works on view at the museum now.'}, 'classification': {'type': 'string', 'maxLength': 120, 'description': 'Classification title as artic_lookup_vocabulary lists it (case ignored), such as oil on canvas or etching.'}, 'place_of_origin': {'type': 'string', 'maxLength': 120, 'description': 'Place of origin as artic_lookup_vocabulary lists it (case ignored), such as france.'}, 'public_domain_only': {'type': 'boolean', 'default': False, 'description': 'Only public-domain works, whose images are CC0.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['artworks', 'page', 'has_more', 'sort_applied', 'license_text', 'totalCount', 'truncated', 'shown', 'cap']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The limit applied to this page.'}, 'page': {'type': 'number', 'description': 'Page returned (1-based).'}, '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': ['page_beyond_window', 'invalid_year_range', 'rate_limited', 'request_blocked', 'upstream_rejected_query'], 'description': "Machine-readable failure mode. Declared by this tool: `page_beyond_window`: page times limit exceeds 1,000, past the reachable search window. `invalid_year_range`: year_from is later than year_to. `rate_limited`: The Art Institute API throttled this server and retries ran out, or the shared request queue could not start the call in time. `request_blocked`: The Art Institute API's firewall blocked the request, as it does for markup or script-like text and for bursts of traffic. `upstream_rejected_query`: The Art Institute API rejected a request this server built from valid inputs. 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': 'Rows returned on this page.'}, 'facets': {'type': 'object', 'properties': {'style': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'count'], 'properties': {'count': {'type': 'number', 'description': 'Matching artworks carrying this value.'}, 'value': {'type': 'string', 'description': 'Value as indexed; pass it back verbatim as the style filter.'}}, 'description': 'One facet value and its count.', 'additionalProperties': False}, 'description': 'Top style values over the filtered set, most common first.'}, 'artist': {'type': 'array', 'items': {'type': 'object', 'required': ['artist_id', 'count'], 'properties': {'name': {'type': 'string', 'description': 'Artist name as written; absent when the museum record carries none.'}, 'count': {'type': 'number', 'description': 'Matching artworks crediting this artist.'}, 'artist_id': {'type': 'number', 'description': 'Agent id; pass it back as the artist_id filter.'}}, 'description': 'One artist facet row.', 'additionalProperties': False}, 'description': 'Top artists over the filtered set, most common first.'}, 'subject': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'count'], 'properties': {'count': {'type': 'number', 'description': 'Matching artworks carrying this value.'}, 'value': {'type': 'string', 'description': 'Value as indexed; pass it back verbatim as the subject filter.'}}, 'description': 'One facet value and its count.', 'additionalProperties': False}, 'description': 'Top subject values over the filtered set, most common first.'}, 'department': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'count'], 'properties': {'count': {'type': 'number', 'description': 'Matching artworks carrying this value.'}, 'value': {'type': 'string', 'description': 'Value as indexed; pass it back verbatim as the department filter.'}}, 'description': 'One facet value and its count.', 'additionalProperties': False}, 'description': 'Top department values over the filtered set, most common first.'}, 'artwork_type': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'count'], 'properties': {'count': {'type': 'number', 'description': 'Matching artworks carrying this value.'}, 'value': {'type': 'string', 'description': 'Value as indexed; pass it back verbatim as the artwork_type filter.'}}, 'description': 'One facet value and its count.', 'additionalProperties': False}, 'description': 'Top artwork_type values over the filtered set, most common first.'}, 'classification': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'count'], 'properties': {'count': {'type': 'number', 'description': 'Matching artworks carrying this value.'}, 'value': {'type': 'string', 'description': 'Value as indexed; pass it back verbatim as the classification filter.'}}, 'description': 'One facet value and its count.', 'additionalProperties': False}, 'description': 'Top classification values over the filtered set, most common first.'}, 'place_of_origin': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'count'], 'properties': {'count': {'type': 'number', 'description': 'Matching artworks carrying this value.'}, 'value': {'type': 'string', 'description': 'Value as indexed; pass it back verbatim as the place_of_origin filter.'}}, 'description': 'One facet value and its count.', 'additionalProperties': False}, 'description': 'Top place_of_origin values over the filtered set, most common first.'}}, 'description': 'Counts over the filtered set for each requested facet; present only when facets were requested.', 'additionalProperties': False}, 'notice': {'type': 'string', 'description': 'Guidance when nothing matched, more pages exist, or the reachable window is exhausted.'}, 'artworks': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'is_public_domain', 'is_on_view', 'web_url'], 'properties': {'id': {'type': 'number', 'description': 'Artwork id; pass to artic_get_artworks.'}, 'image': {'type': 'object', 'required': ['url', 'iiif_info_url', 'rights'], 'properties': {'url': {'type': 'string', 'description': 'IIIF image 843 px wide, the museum display size; available for every image, public domain or not.'}, 'width': {'type': 'number', 'description': 'Full image width in pixels.'}, 'height': {'type': 'number', 'description': 'Full image height in pixels.'}, 'rights': {'enum': ['public_domain', 'in_copyright'], 'type': 'string', 'description': 'Reuse status: public_domain images are CC0; in_copyright images need a rights check before reuse.'}, 'alt_text': {'type': 'string', 'description': 'Alt text the museum wrote for the image.'}, 'url_large': {'type': 'string', 'description': 'IIIF image 1686 px wide; present only for public-domain works.'}, 'iiif_info_url': {'type': 'string', 'description': 'IIIF info.json URL listing the image dimensions, sizes, and tiles.'}}, 'description': 'Primary image with constructed IIIF URLs and its reuse status; absent when the work has no image.', 'additionalProperties': False}, 'title': {'type': 'string', 'description': 'Title as catalogued; empty when the museum lists none.'}, 'medium': {'type': 'string', 'description': 'Medium and support as displayed.'}, 'gallery': {'type': 'string', 'description': 'Gallery where the work is on view, such as Gallery 240.'}, 'web_url': {'type': 'string', 'description': 'Public page for the artwork on artic.edu.'}, 'date_end': {'type': 'number', 'description': 'Latest year of the date span, negative for BCE; omitted when absent or implausible.'}, 'artist_id': {'type': 'number', 'description': 'Id of the preferred credited artist; pass as artist_id to artic_search_artworks.'}, 'date_start': {'type': 'number', 'description': 'Earliest year of the date span, negative for BCE; omitted when absent or implausible.'}, 'department': {'type': 'string', 'description': 'Curatorial department.'}, 'is_on_view': {'type': 'boolean', 'description': 'True when the work is on view at the museum now.'}, 'artwork_type': {'type': 'string', 'description': 'Artwork type, such as Painting or Print.'}, 'date_display': {'type': 'string', 'description': 'Date as the museum displays it; the authority when the years are absent.'}, 'artist_display': {'type': 'string', 'description': 'Artist, nationality, and life dates as the museum displays them.'}, 'place_of_origin': {'type': 'string', 'description': 'Place the work was made.'}, 'is_public_domain': {'type': 'boolean', 'description': 'True when the work is public domain, so its images are CC0.'}}, 'description': 'One matching artwork.', 'additionalProperties': False}, 'description': 'Matching artworks on this page, in ranked or sorted order.'}, 'has_more': {'type': 'boolean', 'description': 'True when more matches exist beyond this page.'}, 'next_page': {'type': 'number', 'description': 'Page to request next; absent when nothing remains or the next page would pass the first 1,000 matches.'}, 'truncated': {'type': 'boolean', 'description': 'True when more matches exist beyond this page.'}, 'totalCount': {'type': 'number', 'description': 'Matches for the query and filters, before paging.'}, 'license_text': {'type': 'string', 'description': 'License statement from the API for this data, verbatim.'}, 'sort_applied': {'enum': ['relevance', 'popularity', 'date_asc', 'date_desc'], 'type': 'string', 'description': 'Order applied; popularity when relevance was requested without query text (the museum popularity ranking).'}}, 'additionalProperties': False}
artic_search_audio_guide
Search audio guide
Search the Art Institute of Chicago's mobile audio-guide stops by text, matching stop titles and transcripts. Returns each stop's title, MP3 URL, and transcript text. Stops carry no artwork id, so match a stop to a work by its title; for a known artwork, artic_get_artworks related_media lists the recordings linked to it. Some stops are in Spanish, and titles are sometimes internal file names. This content is for noncommercial educational and personal use only: keep the copyright notice and cite the Art Institute of Chicago.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'page': {'type': 'integer', 'default': 1, 'maximum': 200, 'minimum': 1, 'description': 'Page to return (1-based); page times limit may not exceed 1,000.'}, 'limit': {'type': 'integer', 'default': 5, 'maximum': 20, 'minimum': 1, 'description': 'Stops per page (1-20).'}, 'query': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "Text matched against stop titles and transcripts; every word must match. An artwork's title or the artist's surname works well."}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['stops', 'page', 'has_more', 'license_text', 'source_citation', 'totalCount', 'truncated', 'shown', 'cap']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The limit applied to this page.'}, 'page': {'type': 'number', 'description': 'Page returned (1-based).'}, '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': ['page_beyond_window', 'rate_limited', 'request_blocked', 'upstream_rejected_query'], 'description': "Machine-readable failure mode. Declared by this tool: `page_beyond_window`: page times limit exceeds 1,000, past the reachable search window. `rate_limited`: The Art Institute API throttled this server and retries ran out, or the shared request queue could not start the call in time. `request_blocked`: The Art Institute API's firewall blocked the request, as it does for markup or script-like text and for bursts of traffic. `upstream_rejected_query`: The Art Institute API rejected a request this server built from valid inputs. 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': 'Stops returned on this page.'}, 'stops': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title'], 'properties': {'id': {'type': 'number', 'description': 'Audio-guide stop id; no tool fetches a stop by id, so each row carries the full stop.'}, 'title': {'type': 'string', 'description': 'Stop title; sometimes an internal file name, and empty when the museum lists none.'}, 'audio_url': {'type': 'string', 'description': 'MP3 URL of the recording, already percent-encoded; absent when none is recorded.'}, 'transcript': {'type': 'string', 'description': 'Transcript of the recording, sometimes in Spanish; absent when the museum has none.'}}, 'description': 'One matching audio-guide stop.', 'additionalProperties': False}, 'description': 'Matching stops on this page, in relevance order.'}, 'notice': {'type': 'string', 'description': 'Guidance when nothing matched, more pages exist, or the reachable window is exhausted.'}, 'has_more': {'type': 'boolean', 'description': 'True when more matches exist beyond this page.'}, 'next_page': {'type': 'number', 'description': 'Page to request next; absent when nothing remains or the next page would pass the first 1,000 matches.'}, 'truncated': {'type': 'boolean', 'description': 'True when more matches exist beyond this page.'}, 'totalCount': {'type': 'number', 'description': 'Matches for the query, before paging.'}, 'license_text': {'type': 'string', 'description': 'License statement from the API, verbatim: noncommercial educational and personal use, with notices retained and the source cited.'}, 'source_citation': {'type': 'string', 'description': 'Citation to keep with any use of this content.'}}, 'additionalProperties': False}
artic_search_exhibitions
Search exhibitions
Search Art Institute of Chicago exhibitions by text and date: what is on now, what is coming, or past shows on a topic. Results carry dates, gallery, summary, web page, and the artworks shown when the museum lists them. Pass artwork ids to artic_get_artworks for full records.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'default': 1, 'maximum': 40, 'minimum': 1, 'description': 'Page to return (1-based, 1-40); page times limit may not exceed 1,000.'}, 'sort': {'enum': ['relevance', 'start_desc', 'start_asc'], 'type': 'string', 'description': 'relevance ranks by query text; start_desc and start_asc sort by opening date. Defaults to relevance with a query, else start_desc; relevance without a query sorts as start_desc.'}, 'when': {'enum': ['any', 'current', 'upcoming', 'past'], 'type': 'string', 'default': 'any', 'description': 'current: open today; upcoming: opens after today; past: closed before today; any: no date condition.'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 25, 'minimum': 1, 'description': 'Exhibitions per page (1-25).'}, 'query': {'type': 'string', 'maxLength': 200, 'description': 'Text matched against exhibition titles, descriptions, and other fields; every word must match.'}, 'date_to': {'type': 'string', 'format': 'date', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$', 'description': 'Latest date, YYYY-MM-DD; an exhibition matches when its run overlaps date_from to date_to.'}, 'date_from': {'type': 'string', 'format': 'date', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$', 'description': 'Earliest date, YYYY-MM-DD; an exhibition matches when its run overlaps date_from to date_to.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['exhibitions', 'when_applied', 'sort_applied', 'page', 'has_more', 'license_text', 'totalCount', 'truncated', 'shown', 'cap']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The limit applied to this page.'}, 'page': {'type': 'number', 'description': 'Page returned (1-based).'}, '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_date_range', 'page_beyond_window', 'rate_limited', 'request_blocked', 'upstream_rejected_query'], 'description': "Machine-readable failure mode. Declared by this tool: `invalid_date_range`: date_from is later than date_to. `page_beyond_window`: The API refused the page as past the first 1,000 matches (the page and limit bounds keep calls inside it). `rate_limited`: The Art Institute API throttled this server and retries ran out, or the shared request queue could not start the call in time. `request_blocked`: The Art Institute API's firewall blocked the request, as it does for markup or script-like text and for bursts of traffic. `upstream_rejected_query`: The Art Institute API rejected a request this server built from valid inputs. 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': 'Exhibitions returned on this page.'}, 'notice': {'type': 'string', 'description': 'Guidance when nothing matched, more pages exist, or the reachable window is exhausted.'}, 'has_more': {'type': 'boolean', 'description': 'True when more matches exist beyond this page.'}, 'next_page': {'type': 'number', 'description': 'Page to request next; absent when nothing remains or the next page would pass the first 1,000 matches.'}, 'truncated': {'type': 'boolean', 'description': 'True when more matches exist beyond this page.'}, 'totalCount': {'type': 'number', 'description': 'Matches for the query and filters, before paging.'}, 'exhibitions': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'artwork_count', 'artworks', 'artist_ids'], 'properties': {'id': {'type': 'number', 'description': 'Exhibition id; no tool fetches an exhibition by id, so each row carries the full record.'}, 'end': {'type': 'string', 'description': 'Closing date and time, ISO 8601 with offset.'}, 'start': {'type': 'string', 'description': 'Opening date and time, ISO 8601 with offset.'}, 'title': {'type': 'string', 'description': 'Exhibition title; empty when the museum lists none.'}, 'status': {'type': 'string', 'description': 'Museum status label (Closed, Confirmed, Traveling). It does not say whether the show is on now; the when filter does.'}, 'gallery': {'type': 'string', 'description': 'Gallery where the exhibition is held.'}, 'summary': {'type': 'string', 'description': 'Short description the museum wrote.'}, 'web_url': {'type': 'string', 'description': 'Exhibition page on artic.edu.'}, 'artworks': {'type': 'array', 'items': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number', 'description': 'Artwork id; pass to artic_get_artworks.'}, 'title': {'type': 'string', 'description': "Artwork title; absent when the museum's id and title lists do not pair up."}}, 'description': 'One artwork shown.', 'additionalProperties': False}, 'description': 'Artworks shown, when the museum lists them; pass ids to artic_get_artworks.'}, 'image_url': {'type': 'string', 'description': "Exhibition image: an 843 px IIIF URL when the museum links an image id, else the museum's own image URL."}, 'artist_ids': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Ids of artists in the show; pass as ids to artic_search_artists or one as artist_id to artic_search_artworks.'}, 'is_featured': {'type': 'boolean', 'description': 'True when the museum features the exhibition; absent when not recorded.'}, 'artwork_count': {'type': 'number', 'description': 'Artworks the museum lists for the show; 0 when none.'}}, 'description': 'One matching exhibition.', 'additionalProperties': False}, 'description': 'Matching exhibitions on this page, in ranked or sorted order.'}, 'license_text': {'type': 'string', 'description': 'License statement from the API for this data, verbatim.'}, 'sort_applied': {'enum': ['relevance', 'start_desc', 'start_asc'], 'type': 'string', 'description': 'Order applied.'}, 'when_applied': {'enum': ['any', 'current', 'upcoming', 'past'], 'type': 'string', 'description': 'The when condition applied.'}}, 'additionalProperties': False}
Hinzugefügt
artic_lookup_vocabulary
3. October 2026 02:40
Hinzugefügt
artic_search_audio_guide
3. October 2026 02:40
Hinzugefügt
artic_search_exhibitions
3. October 2026 02:40
Hinzugefügt
artic_search_artists
3. October 2026 02:40
Hinzugefügt
artic_get_artworks
3. October 2026 02:40
Hinzugefügt
artic_search_artworks
3. October 2026 02:40