How to Use the Artsy MCP in Windsurf

Let Windsurf's Cascade agent dig through the Artsy database for you. Give it a research goal and watch it work.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Artsy MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous Art Research in Your IDE

Stop asking one question at a time. Tell Windsurf's Cascade agent what you're looking for, and it will chain together the right tools to find it. Ask it to "find contemporary artists similar to Warhol" and it might `search_artsy`, then run `get_artist_details` on the results without you lifting a finger. This isn't just about fetching data; it's about automated discovery. Cascade can start with a broad query, identify interesting art movements with `list_genes`, and then `list_artworks` within that category. You get the final answer, not a bunch of intermediate steps to manage.

Explore Art Fairs and Shows with Windsurf

Planning a trip or just curious about the art scene? You can ask Windsurf to find upcoming events. A single prompt like "what are the biggest art fairs in Europe next spring?" kicks off a sequence. Cascade will use the `list_fairs` and `list_shows` tools, maybe cross-referencing artists with `get_artist_details` to see who's featured. The whole process is hands-off. It's the fastest way to get from a question to a curated list of events, right in your editor.

This Artsy MCP Server Connects in Seconds

Getting started is simple. Find the Artsy server in Windsurf's built-in MCP Marketplace and click install. That's it. Your agent immediately knows about all the available tools. There's no manual config unless you want it. Once connected, Cascade automatically discovers the `get_artwork_details`, `list_shows`, and other tools. This MCP server gives your agent direct access to a world of art data.

Setup guide

Set up Artsy 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 Artsy 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 Artsy payment history." If connected, Cascade will call the Artsy tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "artsy-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 Artsy. 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 Artsy 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 Artsy MCP in Windsurf

You'd give Cascade a goal like "find me some Cubist art." It would likely use `list_genes` to find the 'Cubism' gene, then `list_artworks` with that filter, and maybe `get_artwork_details` on a few results. It handles the entire multi-step query for you.

Yes, absolutely. Just ask Windsurf something like, "get me details on the artist Banksy." It will use the `search_artsy` or `get_artist_details` tool to pull that information directly into your IDE.

Speed and autonomy. Instead of you clicking through pages, Windsurf's Cascade agent navigates the data programmatically. You state your research goal, and it executes the required API calls in the background.

No. The Artsy MCP Server on Vinkius is ephemeral. It processes your request and immediately forgets it, storing no query history or user data.

The server only sees the specific query, like a request for artist details or artwork lists. Vinkius runs the server in a zero-trust, ephemeral sandbox. No personal data from your Windsurf client is ever sent, and the server doesn't log or store any information about the art data you request.

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