How to Use the Harvard Art Museums Alternative MCP in OpenAI Agents SDK

Q: Can my agent fetch high-resolution images using Harvard Art Museums Alternative and OpenAI Agents SDK?

Yes, your agent uses getiiifobjectmanifest to get the IIIF presentation manifest for any artwork. This manifest contains the high-resolution image endpoints that your vision models can process.

Q: How does this MCP Server handle complex queries like finding works by medium or technique?

The server exposes specialized endpoints like listmediums and listtechniques. Your agent calls these tools to filter down the museum's vast catalog before pulling specific object records.

Query over 250,000 art objects directly from your OpenAI Agents SDK with auto-discovered museum metadata tools.

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 Alternative MCP to OpenAI Agents SDK

Create your Vinkius account to connect Harvard Art Museums Alternative to OpenAI Agents SDK 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 Alternative with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Deep Collection Research

`list_objects` lets your agent search the entire Harvard Art Museums database to pull back full metadata records. The agent uses `get_object` to inspect specific pieces, pulling up acquisition details, physical dimensions, and artist associations. You don't have to write custom JSON parsers or manually map endpoints. This MCP Server registers these tools natively, meaning your agent knows how to query the collection without you writing boilerplate code.

Visual Asset Retrieval

`get_iiif_object_manifest` and `get_iiif_gallery_manifest` fetch deep zoom images and layout manifests directly. This lets your agent inspect high-resolution visual assets and gallery placements for research pipelines. With this MCP integration, your agent can pull raw image metadata via `list_images` and `get_image` to check color palettes or dimensions. These tools feed clean image URLs directly to your downstream vision agents.

Curatorial Mapping with OpenAI Agents SDK

`list_exhibitions` and `list_galleries` expose physical layouts and past shows to your agent. By combining these with `get_gallery`, your agent maps out how objects are distributed across different physical spaces. This MCP Server lets your OpenAI Agents SDK build complex historical timelines. Your agent calls `list_periods` and `list_centuries` to contextualize objects within historical movements.

Setup guide

Set up Harvard Art Museums Alternative MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Harvard Art Museums Alternative tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Harvard Art Museums Alternative tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Harvard Art Museums Alternative tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Harvard Art Museums Alternative Agent",
            instructions="You have access to Harvard Art Museums Alternative tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 Alternative 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 Alternative MCP in OpenAI Agents SDK

You pass the server URL to the MCPServerStreamableHttp constructor and include it in your agent's mcp_servers list. The SDK automatically registers all 35 tools like list_objects and get_object at runtime.

Yes, your agent uses get_iiif_object_manifest to get the IIIF presentation manifest for any artwork. This manifest contains the high-resolution image endpoints that your vision models can process.

The server exposes specialized endpoints like list_mediums and list_techniques. Your agent calls these tools to filter down the museum's vast catalog before pulling specific object records.

No, this is a read-only integration designed for research and data retrieval. Tools like list_people and get_publication only fetch existing historical data from the museum catalog.

Your queries for art metadata, object IDs, and artist profiles go through a secure V8 sandbox. We never store your search terms or API keys, ensuring your research parameters remain private.

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