How to Use the Harvard Art Museums MCP in Mastra AI

Q: How do I run a multi-step exhibition audit with Mastra AI and the Harvard Art Museums?

You build a workflow that first calls searchexhibitions to find active shows, then loops through those results to fetch object details for every piece on display.

Run complex, self-healing curation workflows on Harvard Art Museums data with Mastra AI and this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Harvard Art Museums MCP to Mastra AI

Create your Vinkius account to connect Harvard Art Museums to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Harvard Art Museums with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Curation Workflows with this MCP Server

Running curation audits with `search_museum_objects` helps you flag incomplete records automatically. Mastra AI lets you build multi-step workflows that query the collection and automatically flag records missing critical provenance data. If a query fails, the built-in workflow engine retries with exponential backoff. You can set up conditional logic based on what the database returns. If `get_object_details` reveals an object lacks a verified artist, the workflow branches to query `search_museum_people` to find potential matches.

Self-Healing Gallery Audits using Mastra AI

Monitoring live exhibitions is much easier when you pair `list_museum_galleries` with active show data. Mastra AI can systematically audit which items are currently on display. If the connection drops mid-audit, the framework handles the failure gracefully. It won't crash your entire script; it simply pauses, checks `check_api_status`, and resumes the audit once the endpoint is online.

Build Human-in-the-Loop Pipelines with an MCP Server

Verifying biographical data with `search_museum_people` shouldn't happen without human oversight. This integration connects with Mastra's approval system, allowing you to pause workflows when querying artists. The agent gathers the raw biographical data and queues it up for manual review. Once a researcher approves the record, the pipeline continues, updating your local archive with verified museum data.

Setup guide

Set up Harvard Art Museums MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Harvard Art Museums tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "harvard-art-museums-mcp-client",
  servers: {
    "harvard-art-museums-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Harvard Art Museums Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Harvard Art Museums tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Harvard Art Museums transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Harvard Art Museums. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Harvard Art Museums now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Harvard Art Museums MCP in Mastra AI

Instantiate the client with your Vinkius endpoint and call the list tools method. You can then spread those tools directly into your Mastra agent definition.

Yes. Mastra has built-in retry logic that automatically kicks in if `search_museum_objects` or other endpoints return a rate limit error or timeout.

You build a workflow that first calls `search_exhibitions` to find active shows, then loops through those results to fetch object details for every piece on display.

Yes. You can require manual approval before your agent writes any fetched artist records to your production database.

This MCP Server handles your requests within an ephemeral V8 sandbox. Only the raw search terms, artist IDs, and gallery queries are sent to the museum endpoints, and no search history is stored.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript