How to Use the Cleveland Museum of Art MCP in Mastra AI

Q: Is it possible to require human approval before my Mastra AI agent adds an artwork from the Cleveland Museum of Art to a list?

Absolutely. You can use Mastra AI's requireToolApproval option. Your agent would use a tool like searchartworks, and the workflow would pause, pending your approval, before it continues to the next step.

Q: What's the difference between searchcreators and searchmayshowcreators?

The searchcreators tool searches the entire collection's list of artists. searchmayshowcreators is a specialized tool that only searches for artists who participated in the museum's historic 'May Show' exhibitions.

Build resilient data pipelines for the Cleveland Museum of Art collection with Mastra AI's workflow engine.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cleveland Museum of Art MCP to Mastra AI

Create your Vinkius account to connect Cleveland Museum of Art 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 Cleveland Museum of Art with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Art Data Enrichment

Use the `search_artworks` tool to find pieces matching certain criteria, then run `get_artwork` for each one to pull full metadata. Mastra AI's workflow engine makes this a simple, two-step process. If a call to `get_artwork` fails for any reason, Mastra automatically retries with exponential backoff, so your data pipeline doesn't just stop. You can build workflows that search for art from a specific creator, enrich each piece with its full metadata, and then save it to your own database. The entire process is defined in TypeScript and runs reliably, pulling data from a single MCP endpoint without you writing custom retry logic.

Complex Queries with Mastra AI

Mastra AI lets you build conditional logic into your agent's tasks. For example, your agent could use `search_creators` to find an artist. If the search returns multiple results, your workflow can branch, perhaps using another data source to disambiguate before calling `get_creator` with the correct ID. This is way more than a simple API call. You're defining a state machine. 'If `search_exhibitions` for 'Monet' returns nothing, then search for 'Impressionism' and filter the results.' Mastra handles the state, so your agent can execute complex research tasks without getting stuck.

Build a Curation Workflow with this MCP Server

This server is perfect for building curation tools. An agent can use `search_similar_artworks` to suggest pieces for a collection. With Mastra AI's `requireToolApproval` feature, you can pause the workflow and wait for a human to approve the suggestions before the agent proceeds. Imagine a workflow: find ten impressionist paintings, ask a curator to pick three, then use `get_artwork` to fetch high-res image links for only the approved ones. Mastra AI manages the entire stateful interaction, from the initial search to the final human approval step.

Setup guide

Set up Cleveland Museum of Art 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 Cleveland Museum of Art 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: "cleveland-museum-of-art-mcp-client",
  servers: {
    "cleveland-museum-of-art-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Cleveland Museum of Art 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 Cleveland Museum of Art. 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 Cleveland Museum of Art 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 Cleveland Museum of Art MCP in Mastra AI

Yes, that's a core strength of Mastra AI. When you connect to the Cleveland Museum of Art MCP server, you can configure automatic retries with exponential backoff for any tool call. Your workflows become much more resilient.

You'd define a workflow in TypeScript. Your agent would call the `search_exhibitions` tool, and you could write an `if` statement based on the result count. If it's zero, the workflow could branch to call `search_artworks` with a related term instead.

Absolutely. You can use Mastra AI's `requireToolApproval` option. Your agent would use a tool like `search_artworks`, and the workflow would pause, pending your approval, before it continues to the next step.

The `search_creators` tool searches the entire collection's list of artists. `search_may_show_creators` is a specialized tool that only searches for artists who participated in the museum's historic 'May Show' exhibitions.

The server only processes the search terms and IDs your agent sends. Vinkius provides a zero-trust, ephemeral environment for this MCP Server. Your Mastra AI agent's session data is never stored or logged.

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