Fanart.tv MCP Server for Windsurf 8 tools — connect in under 2 minutes
Windsurf brings agentic AI coding to a purpose-built IDE. Connect Fanart.tv through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install Fanart.tv and 2,500+ MCP Servers from a single visual interface.
{
"mcpServers": {
"fanarttv": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Fanart.tv MCP Server
Connect to Fanart.tv and access the world's largest fan-created artwork database through natural conversation.
Windsurf's Cascade agent chains multiple Fanart.tv tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 8 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
What you can do
- Movie Art — Get posters, fanart backgrounds, logos, clear art, disc art and more for any movie
- TV Show Art — Retrieve show banners, season posters, season banners, clear logos and show thumbs
- HD TV Art — Get high-resolution backgrounds and banners suitable for large displays
- Music Artist Art — Find artist thumbs, backgrounds, music logos, banners and concert thumbs
- Album Art — Get CD art, album covers, disc backgrounds and spine images for albums
- Latest Artwork — Browse recently added artwork for movies, TV shows and music
The Fanart.tv MCP Server exposes 8 tools through the Vinkius. Connect it to Windsurf in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect Fanart.tv to Windsurf via MCP
Follow these steps to integrate the Fanart.tv MCP Server with Windsurf.
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Add the server
Paste the JSON configuration above into mcp_config.json
Save and reload
Windsurf will detect the new server automatically
Start using Fanart.tv
Open Cascade and ask: "Using Fanart.tv, help me...". 8 tools available
Why Use Windsurf with the Fanart.tv MCP Server
Windsurf provides unique advantages when paired with Fanart.tv through the Model Context Protocol.
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
JSON-based configuration means zero code changes: paste a URL, reload, and all 8 tools are immediately available
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
Fanart.tv + Windsurf Use Cases
Practical scenarios where Windsurf combined with the Fanart.tv MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from Fanart.tv and generate models, types, or handlers based on real API responses
Live debugging: query Fanart.tv tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from Fanart.tv and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine Fanart.tv data with Cascade's code generation to scaffold entire features in minutes
Fanart.tv MCP Tools for Windsurf (8)
These 8 tools become available when you connect Fanart.tv to Windsurf via MCP:
get_album_art
Returns album art including: CD art, album covers, disc backgrounds and spine images. Get artwork for a music album by MusicBrainz ID
get_latest_movies
tv. Returns a list of movies with their TMDb IDs and recently added artwork types. Useful for discovering new artwork additions. Get latest movie artwork added to Fanart.tv
get_latest_music
tv. Returns a list of artists with their MusicBrainz IDs and recently added artwork. Get latest music artist artwork added to Fanart.tv
get_latest_tv
tv. Returns a list of TV shows with their TVDb IDs and recently added artwork. Get latest TV show artwork added to Fanart.tv
get_movie_art
Returns movie art including: movie posters, fanart backgrounds, logos, banners, clear art, clear logos, disc art and movie thumbs. Each image includes URL, language, likes count and dimensions. Get artwork for a movie by TMDb ID
get_music_artist_art
Returns artist art including: artist thumbs, artist backgrounds (fanart), music logos, music banners, artist logos and concert thumbs. Get artwork for a music artist by MusicBrainz ID
get_tv_art
Returns show art including: show banners, fanart backgrounds, season posters, season banners, clear logos, season thumbs and show thumbs. Get artwork for a TV show by TVDb ID
get_tv_art_hd
Returns high-resolution versions of backgrounds and banners suitable for large displays. Get HD artwork for a TV show by TVDb ID
Example Prompts for Fanart.tv in Windsurf
Ready-to-use prompts you can give your Windsurf agent to start working with Fanart.tv immediately.
"Get artwork for The Matrix (TMDb ID: 603)."
"Get artwork for Game of Thrones (TVDb ID: 121361)."
"Get artwork for The Beatles (MBID: b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d)."
Troubleshooting Fanart.tv MCP Server with Windsurf
Common issues when connecting Fanart.tv to Windsurf through the Vinkius, and how to resolve them.
Server not connecting
Fanart.tv + Windsurf FAQ
Common questions about integrating Fanart.tv MCP Server with Windsurf.
How does Windsurf discover MCP tools?
mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.Can Cascade chain multiple MCP tool calls?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.Connect Fanart.tv with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect Fanart.tv to Windsurf
Get your token, paste the configuration, and start using 8 tools in under 2 minutes. No API key management needed.