How to Use the Europeana MCP in Windsurf

Q: What's the main difference between using searchrecords and oaipmhrequest with Europeana in Windsurf?

searchrecords is for quick, interactive searches inside Windsurf. oaipmhrequest is for pulling large amounts of metadata in bulk from Europeana, which is slower but more thorough for offline work.

Let Windsurf's Cascade agent autonomously explore Europe's cultural archives. Set a research goal and it does the rest.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Europeana MCP to Windsurf

Create your Vinkius account to connect Europeana to Windsurf 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 Europeana with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Find and Examine Cultural Artifacts

Start with a high-level goal, not a specific command. Tell Windsurf "find drawings of ships from the Dutch Golden Age" and its Cascade agent uses `search_records` to build a list. It works on its own, chaining actions without you prompting every step. From there, Cascade automatically runs `get_record` on the most relevant results. You get back the full object details—provenance, materials, high-res image links—without having to manually request each one.

Uncover Connections with this MCP Server

A record is just the start. When Cascade pulls an artifact's data with `get_record`, it also finds linked entities like artists, patrons, or historical figures. It won't just stop at a name. The agent then automatically calls `get_entity` to pull biographies, timelines, and related works for those people. This turns a simple search into a full-blown research session, connecting the dots for you.

Prep Offline Datasets with OAI-PMH

For bigger projects, you can direct Cascade to perform a bulk metadata harvest. It uses the `oaipmh_request` tool to pull down entire collections as XML for offline analysis or local caching. This is for when you need the whole dataset, not just a few items. Set it up as a background task in Windsurf and let it run. Just be aware that you're trading the real-time speed of `search_records` for the completeness of a bulk download.

Setup guide

Set up Europeana MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Europeana MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Europeana payment history." If connected, Cascade will call the Europeana tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "europeana-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Europeana. 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 Europeana 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 Europeana MCP in Windsurf

You give Windsurf a goal, and its Cascade agent plans the steps. It uses `search_records` to find matching items in Europeana, then `get_record` to get details, presenting a final report.

Yes. Ask Windsurf to compare two artists. It will likely use `search_records` for each, then `get_entity` to pull their biographical data for a side-by-side summary.

`search_records` is for quick, interactive searches inside Windsurf. `oaipmh_request` is for pulling large amounts of metadata in bulk from Europeana, which is slower but more thorough for offline work.

Absolutely. You can task Windsurf to find events or artworks within a date range using `search_records`. It can then organize the results chronologically to build a basic timeline for you.

This server only handles public cultural heritage metadata from Europeana, like artwork titles, artist names, and creation dates. Vinkius sandboxes the connection, and your MCP access token is ephemeral, so your private data is never involved.

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