How to Use the Fanart.tv MCP in Windsurf
Grab high-res media art directly inside Windsurf. Let Cascade pull logos, posters, and fanart for your media dashboard automatically.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Fanart.tv MCP to Windsurf
Create your Vinkius account to connect Fanart.tv 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.
Fetch media artwork with Cascade
Cascade doesn't just find links. It uses `get_movie_art` and `get_tv_art` to grab specific assets like clear logos or fanart backgrounds based on your project context. Tell the agent you need assets for a show, and it uses `get_tv_art_hd` to pull high-res files. It then places them exactly where your UI code needs them.
Catalog media assets in real-time
Keep your media library fresh by checking the latest additions. The agent uses `get_latest_movies` and `get_latest_tv` to identify new releases without manual lookups. Everything stays current. You define the update frequency in Windsurf, and the server handles the rest.
Access music metadata for your app
Artist pages and album displays need visual pop. This MCP Server gives Cascade access to `get_music_artist_art` and `get_album_art` to source disc backgrounds or artist thumbs. It maps the MusicBrainz IDs automatically. Your code gets the high-quality assets it needs without you writing a single fetch function.
Set up Fanart.tv 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 Fanart.tv MCP
Paste the JSON snippet shown on the right into the
mcpServersobject. 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 Fanart.tv payment history." If connected, Cascade will call the Fanart.tv tools directly. You will see a green dot next to the server name in the MCP panel.
{
"mcpServers": {
"fanarttv-mcp": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Fanart.tv. 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.
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 Fanart.tv MCP in Windsurf
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Fanart.tv MCP today
We host it, we monitor it, we maintain it. You just paste one token.
