# Harvard Art Museums MCP > Harvard Art Museums MCP lets you search art objects, artists, and exhibitions using your agent's natural conversation. Get detailed metadata on thousands of museum pieces, audit artist portfolios across different periods, or query historical and upcoming exhibition themes—all without visiting a museum website. ## Overview - **Category:** knowledge-management - **Price:** Free - **Tags:** art-history, museum-collections, metadata, cultural-heritage, curation, archival-data ## Description This connector gives your AI client direct access to the Harvard Art Museums collection data. Instead of manually clicking through dozens of gallery pages and copying dates, you talk to your agent and it handles the heavy lifting. Need details on an object? Just ask for it. Want to see how a specific artist's work was displayed across different decades? Your agent pulls that data together instantly. The system acts like a real-time art curator, ensuring every piece of information comes straight from verified museum records. Because this MCP is hosted on Vinkius, you connect once and get access to the entire catalog, making your research flow simple. Whether you’re writing an academic paper or just looking for visual inspiration, your agent retrieves object metadata by title, artist, or period. You can list all available galleries to map out the collection structure, search through past exhibitions to understand thematic trends, and even pull direct links to high-quality primary images for context. ## Tools ### check_api_status Confirms whether the Harvard Art Museums API is currently running and accessible. ### get_object_details Fetches complete records for a single art object once you know its unique identifier (ID). ### list_museum_galleries Retrieves the names and details of every physical gallery space within the museum complex. ### search_exhibitions Searches for both active and past exhibitions hosted by the institution. ### search_museum_objects Conducts a general search across thousands of art pieces using keywords, artists, or object types. ### search_museum_people Searches for profiles and works associated with specific historical figures or artists. ## Prompt Examples **Prompt:** ``` Search for art objects by 'Vincent van Gogh' in Harvard Art Museums. ``` **Response:** ``` I've retrieved 10 works by Vincent van Gogh in the collection. Notable objects include 'Self-Portrait' and 'The Three Sunflowers'. Would you like the image links or full metadata for any of these? ``` **Prompt:** ``` Show details for exhibition with name 'Modernism'. ``` **Response:** ``` I've identified several exhibitions related to Modernism. Notable matches include 'French Modernism' and 'American Modernist Prints'. I can provide the dates and gallery locations if you'd like. ``` **Prompt:** ``` List all galleries in the museum. ``` **Response:** ``` I've scanned the gallery catalog. There are over 50 galleries listed, categorized by floor and theme (e.g., 'Ancient Art', 'Contemporary Art'). I can provide the specific gallery IDs for further object searches. ``` ## Capabilities ### Search objects by criteria Find specific art pieces across the entire museum collection using details like title, artist name, or medium. ### Analyze artists' contributions Review an artist’s full record within the museum to see all their associated works and historical context. ### Map gallery locations Get a complete list of every physical gallery space managed by Harvard Art Museums. ### Discover exhibition history Query details on past or upcoming museum shows to understand the collection's thematic focus over time. ### Get object metadata and images Retrieve full technical data points for a single piece, including its period, material, and direct image links. ## Use Cases ### Checking provenance for a paper A student needs to cite three pieces of work by Van Gogh and their associated mediums. They ask their agent, which uses `search_museum_people` first, then gathers the necessary data using `get_object_details`, resulting in a formatted bibliography. ### Curating an exhibit theme A curator needs to build an exhibit around 'Modernism.' They use their agent to run `search_exhibitions` and then compare the results with objects found via `search_museum_objects` to fill gaps in the current collection. ### Mapping museum logistics An operations lead needs to know which galleries exist on the third floor. They run `list_museum_galleries`, getting a structured list of locations that they can then feed into a planning spreadsheet for staffing assignments. ### Researching cross-period art A designer wants to find visual inspiration spanning two centuries. They use the agent to search objects by period via `search_museum_objects` and compare results against artist profiles using `search_museum_people`, generating a diverse mood board. ## Benefits - You get deep object metadata instantly. Instead of checking a gallery catalog for period or medium info, your agent retrieves all those details using `get_object_details` in one step. - Never miss an exhibition theme. Use `search_exhibitions` to query historical and upcoming shows, giving you a full picture of the museum's thematic focus over time. - Track an artist’s entire career easily. By calling `search_museum_people`, you see all their recorded contributions in the collection without manually checking decade by decade. - Understand the physical layout fast. Run `list_museum_galleries` to map out every space available, helping you plan a virtual walk-through of the collections. - Search broad concepts and get specific results. Start with `search_museum_objects` using general keywords; then narrow down to exact data points like image links or periods. ## How It Works The bottom line is you get verified art collection intelligence without ever leaving your chat window or IDE. 1. Subscribe to this MCP and enter your Harvard Art Museums API Key in the Vinkius Marketplace. 2. Tell your AI client what you need—for example, 'Find all objects related to Impressionism.' 3. The agent executes the necessary tool calls against the museum data and returns a structured list of objects, artists, or exhibitions. ## Frequently Asked Questions **How do I start researching an artist with search_museum_people?** You tell your agent the name, and it returns all records associated with that person. This is the best starting point for understanding a figure's impact on the collection. **Can I find out what exhibits happened in 1950 using search_exhibitions?** Yes, you can query historical exhibitions by date or theme. This helps you understand how the museum displayed art at specific points in history. **What is the difference between search_museum_objects and get_object_details?** Use `search_museum_objects` when you have a general idea (a keyword or artist). Use `get_object_details` only when you already know the specific ID of the object. **Does list_museum_galleries help with my research?** It gives you a complete directory of all physical galleries. This is useful for mapping out collection organization or understanding where certain types of art are housed. **After setting up the API key, how can I use `check_api_status` to confirm the connection works?** Running `check_api_status` gives you immediate confirmation that your credentials and access are active. A successful response means your AI client can reliably communicate with the Harvard Art Museums collection. **When using `search_museum_objects`, what parameters can I use to narrow the search beyond title or artist?** You can filter results by specific criteria such as period, medium, and even cultural origin. This lets you run highly targeted searches without having to browse the entire catalog manually. **When I run `get_object_details`, what kind of visual information can I expect besides standard metadata?** The details include direct, high-quality links to the primary image for the art object. This lets your agent pull in immediate visual context alongside all the text data. **When using `search_museum_objects`, how can I confirm that the retrieved art piece belongs to a specific gallery area?** The metadata returned by the search includes location tags. This lets you cross-reference your object findings with the data gathered from listing all museum galleries. **How do I find my Harvard Art Museums API Key?** Request a free API Key by filling out the form on the [**Harvard Art Museums API portal**](https://harvardartmuseums.org/collections/api). Your key will be sent to you via email. **Can the agent show images of the art?** Yes. The `search_museum_objects` and `get_object_details` tools retrieve primary image URLs for objects where available in the digital collection. **Is it possible to search for specific artists?** Yes. Use the `search_museum_people` tool providing the artist's name. Your agent will return their profile ID and identifying metadata instantly.