# Harvard Art Museums MCP > Harvard Art Museums MCP connects your AI client directly to over 250,000 art objects and rich historical data. Search by color, period, culture, or person—and get everything from scholarly publications to gallery layouts in natural conversation. ## Overview - **Category:** knowledge-management - **Price:** Free - **Tags:** art-history, museum-collection, cultural-data, research, metadata, api-integration ## Description Need to write a paper on the shift in American painting during the late nineteenth century? Instead of visiting dozens of separate museum databases, you ask your agent directly. This MCP turns art history into an interactive research tool. You can use it to find specific objects by filtering across centuries and materials, then pull up related profiles for artists or donors. If a work was part of a major show, you'll know that too. Vinkius hosts this MCP so you connect one time from your preferred client and get access to museum data like this, plus thousands of others. It lets you query scholarly publications connected to the art, trace physical galleries within the institution, or even pull technical details about how an image was created for research. You're not just looking at pictures; you're accessing a structured record of cultural history. ## Tools ### get_annotation Retrieves specific details about notes or commentary attached to an artwork image. ### get_audio Gets detailed information for audio descriptions of artworks. ### get_exhibition Fetches specific details about a particular museum exhibition. ### get_gallery Retrieves detailed information for a physical gallery space within the museum. ### get_iiif_gallery_manifest Gets the required manifest file to view all objects displayed in a specific gallery online. ### get_iiif_object_manifest Generates the necessary manifest for viewing an individual artwork object digitally. ### get_iiif_top_collection Retrieves the main manifest file listing all objects in the top-level collection. ### get_image Fetches specific details about a high-resolution image of an artwork. ### get_object Gets the complete record for any single object in the collection, including provenance and description. ### get_person Retrieves detailed profiles and biographies of people associated with the art (artists, donors, etc.). ### get_publication Gets specific details about a scholarly publication mentioning or featuring artwork. ### get_video Retrieves information for videos produced by the museums concerning art history or works. ### list_activities Lists historical activities related to an object, like when it was moved or edited in the collection records. ### list_annotations Lists all manual and machine-generated notes attached to artwork images. ### list_audios Provides a list of audio descriptions or visual interpretations for artworks. ### list_centuries Lists the available centuries used to date and categorize art objects. ### list_classifications Provides a list of curatorial categories, such as Prints or Sculpture. ### list_colors Lists all recognized color terms and CSS3 identifiers used in the collection's metadata. ### list_cultures Provides a list of cultural associations (e.g., Dutch, Greek) related to the art objects. ### list_exhibitions Lists all past, current, and upcoming museum exhibitions by name and date. ### list_galleries Provides a list of every physical space or gallery within the museum building. ### list_groups Lists pre-curated groupings, like 'Collection Highlights,' for focused viewing. ### list_images Lists metadata details about the image files produced by the museum's research department. ### list_mediums Provides a list of materials used to create the art, such as Watercolor or Resin. ### list_objects Lists all individual items and objects housed within the Harvard Art Museums collection. ### list_people Lists every person recorded in the database, including artists, donors, or patrons. ### list_periods Provides a list of art movements and historical time periods (e.g., Baroque, Romantic). ### list_places Lists geographic locations associated with the collection's origins or subjects. ### list_publications Provides a list of scholarly publications that contain information about museum artworks. ### list_sites Lists the major physical facilities and sites associated with the museum complex. ### list_spectrums Lists the specific color ranges used in the museum's branding or art analysis spectra. ### list_supports Provides a list of physical surfaces where the artwork was created (e.g., Wood, Slate). ### list_techniques Lists specific methods used in art production, like Etching or Red-figure. ### list_videos Provides a list of video assets produced by or related to the museum's collection. ### list_worktypes Lists specific object types, such as 'fragment,' 'vessel,' or 'painting.' ## Prompt Examples **Prompt:** ``` Search for 19th-century French paintings in the Harvard Art Museums collection. ``` **Response:** ``` I've found several 19th-century French paintings. Notable works include 'The Rehearsal' by Edgar Degas (ID: 299842) and 'The Gare Saint-Lazare' by Claude Monet. Would you like the full details for any of these? ``` **Prompt:** ``` List all current exhibitions and their venues. ``` **Response:** ``` There are currently 4 active exhibitions. Highlights include 'Objects of Addiction' at the Arthur M. Sackler Museum and 'American Watercolors' at the Fogg Museum. Which one would you like to explore further? ``` **Prompt:** ``` Get the full record for object ID 303935. ``` **Response:** ``` Fetching record 303935... This is 'Self-Portrait' by Vincent van Gogh, oil on canvas, dated 1887. It is currently located in Gallery 2400. It features a vibrant palette of blues and yellows with characteristic brushwork. ``` ## Capabilities ### Researching Artworks Retrieve full records on any object, allowing filtering by classification, culture, or material used. ### Mapping Collections and Venues List specific physical spaces within the museum building, identifying where objects are actually displayed on a given floor. ### Building Biographical Profiles Pull detailed information for artists, donors, or any other people associated with the collection's works. ### Tracking Historical Context Identify which exhibitions were held in a given time period and find related scholarly publications about the art. ### Analyzing Image Data Access detailed metadata, including annotations or visual descriptions, for high-resolution images of artworks. ### Cataloging Object Attributes Filter and list objects based on specific criteria like the time period (e.g., Victorian) or the cultural origin (e.g., Greek). ## Use Cases ### Writing a Comparative Study on Donor Art A student needs to compare works funded by two different families. They start by listing all donors using `list_people`, find the key names, and then use `get_person` combined with `get_object` to pull up every piece associated with those individuals for comparison. ### Planning a Thematic Exhibition Tour A curator wants to create an exhibit focused on 19th-century French art. They use `list_periods` and then narrow the scope by checking `get_iiif_gallery_manifest` for available physical spaces that match the criteria. ### Tracing a Piece's Entire Life Cycle A researcher finds an object ID and needs to know everything about it. They use `get_object`, then follow up with `list_annotations` and `list_audios` to gather all available scholarly commentary. ### Identifying Missing Context A user knows the object's style but not its origin. They use `list_cultures` and then query for related artifacts using `get_object` filtered by those cultural associations, helping them pinpoint the region of origin. ## Benefits - Pinpoint details: Use `get_object` to pull the full record on any piece, or use `list_activities` to see its entire documented history within the museum's records. - Build a narrative profile: Running through `list_people` and then using `get_person` lets you map out the lives of artists and donors connected to the collection. - Understand the physical space: Don't just look at flat images. Use `list_galleries` and `get_iiif_gallery_manifest` to understand exactly where pieces are displayed in person. - Contextualize your search: Instead of guessing, use broad tools like `list_cultures` or `list_periods` first. This narrows the focus so you can efficiently run targeted searches using `get_object`. - Access deep academic context: You can pull related scholarly information by listing publications with `list_publications`, giving your research an immediate layer of peer-reviewed backup. ## How It Works The bottom line is that you talk to your agent like a museum docent, and it talks back using millions of records. 1. Subscribe to this MCP and enter your Harvard Art Museums API Key in Vinkius. 2. Connect your agent via any compatible client, then prompt it with a research question (e.g., 'Show me all Dutch sculptures from the 17th century'). 3. The AI tool automatically accesses the collection data to provide structured answers, complete with object details and context. ## Frequently Asked Questions **How do I find all works by a specific person using list_people?** You first use `list_people` to confirm the name. Then, you ask your agent to get all related objects or details for that individual using `get_person`. This gathers their full professional history within the collection. **Can I list_exhibitions to find out what was shown in 1950?** Yes. You run `list_exhibitions` and filter by date range or topic. This tells you about past shows, which is perfect for understanding a collection's historical focus. **What if I need to know the colors used in an object?** You can list available color terms with `list_colors`. Then, when looking at a specific piece, you check its metadata using `get_image` or `get_object` for the extracted palette. **How do I find out about a gallery's contents?** First, use `list_galleries` to know the location. Then, pass that name to `get_iiif_gallery_manifest`. This gets you all the manifest files needed to view everything displayed there. **What credentials are needed before I can use tools like list_objects?** You must provide a valid API key during setup. This connection secures your access and allows your agent to perform actions across the collection. Always store this key in an environment variable for safety. **When I call get_object, what core data points should I expect to find?** The full object record includes details like its date, medium (from list_mediums), classification, and associated cultural groups. This gives you a complete picture of the piece's context. **How can I narrow down my search before listing objects using list_classifications?** You should use list_classifications to retrieve valid curatorial categories first. Then, pass those returned IDs into your main query to filter the results effectively. **What is the output format when I request image data using get_iiif_object_manifest?** This tool returns a JSON manifest describing how the object should be viewed. It provides all necessary technical parameters for standard, compliant web viewers. **How can I find artworks from a specific culture or time period?** You can use the `list_objects` tool and apply filters like `culture` (e.g., 'Japanese') or `century` (e.g., '19th century'). You can also use `yearmade` for more precise dating. **Is it possible to see which exhibitions are currently running at the museum?** Yes! Use the `list_exhibitions` tool with the `status` parameter set to 'current'. This will return a list of all active shows with their details. **Can I search for artworks based on their location within the museum building?** Absolutely. You can use `list_galleries` to find specific room IDs or floors, and then use the `gallery` filter in `list_objects` to see what is displayed in that specific space.