How to Use the Cooper Hewitt MCP in Pydantic AI

Build type-safe Pydantic AI agents that connect to the Cooper Hewitt MCP Server with zero silent failures.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cooper Hewitt MCP to Pydantic AI

Create your Vinkius account to connect Cooper Hewitt to Pydantic 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 Cooper Hewitt with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate museum metadata with Pydantic AI

Fetching object details requires `get_object_info` to retrieve design history and creator records. Pydantic AI validates this incoming museum data against strict Python schemas, ensuring your application never ingests corrupted fields. If the Smithsonian API structure changes, your agent raises a validation error immediately. This prevents silent failures and keeps your production database clean.

Parse complex exhibition timelines safely

Tracking museum displays relies on `list_exhibitions` and `get_object_exhibitions` to build accurate timelines. Pydantic AI maps these nested API responses directly to typed Python models. You don't have to write manual parsing code or worry about missing keys in the JSON. The MCP Server delivers clean payloads, and the framework guarantees their structure before your logic runs.

Extract color records and creator metadata

Gathering design details uses `get_object_colors` and `get_person_objects` to link creators with their work. Pydantic AI ensures the returned color hex codes and participant lists match your exact type definitions. This makes it simple to run automated design analysis. Your code stays type-safe from the moment the agent queries the MCP Server to the final output.

Setup guide

Set up Cooper Hewitt MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "cooper-hewitt-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Cooper Hewitt tools.",
)

result = await agent.run("List recent Cooper Hewitt transactions")
print(result.output)

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 Cooper Hewitt. 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 Cooper Hewitt 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 Cooper Hewitt MCP in Pydantic AI

The framework validates every response from the MCP Server against your defined models. If the schema doesn't match, it raises a validation error instead of passing bad data.

Yes, the framework is model-agnostic. You can connect it to local models or commercial APIs while using this server for museum data.

You should use the MCPToolset with the HTTP transport. This lets your agent talk to the hosted MCP Server over a secure web connection.

No, the single package handles everything. All 22 tools are exposed through the same unified endpoint.

All transport layers use TLS encryption to protect your search terms and retrieved museum data. Vinkius runs the integration in a zero-trust sandbox, so your requests are processed ephemerally and never saved.

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