How to Use the Jellyfin (Plex Alternative) MCP in Windsurf
Use Windsurf to manage your media library and track playback status directly through your AI agent.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Jellyfin (Plex Alternative) MCP to Windsurf
Create your Vinkius account to connect Jellyfin (Plex Alternative) 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.
Manage your library with Windsurf
Cascade automatically indexes your media collection when you connect this MCP Server. You can query specific titles or browse entire libraries using `list_items` without leaving your IDE. It handles the heavy lifting of library navigation. Just ask Cascade to find a specific show or movie, and it calls `get_item` to pull the metadata directly into your workspace.
Monitor playback in Windsurf
Keep tabs on what is currently streaming on your server. Your agent uses `session_playing` and `session_playing_progress` to track exactly where a user left off in a file. This gives you real-time visibility into your home media usage. You can see which users are active and check their progress without opening a browser dashboard.
Inspect server health in Windsurf
Check the status of your host machine and Jellyfin (Plex Alternative) instance instantly. Use `get_system_info` to see version details or verify your current load. Configuration management becomes trivial. You can view your server settings with `get_system_configuration` to ensure your local media host is running exactly how you want it.
Set up Jellyfin (Plex Alternative) 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 Jellyfin (Plex Alternative) 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 Jellyfin (Plex Alternative) payment history." If connected, Cascade will call the Jellyfin (Plex Alternative) tools directly. You will see a green dot next to the server name in the MCP panel.
{
"mcpServers": {
"jellyfin-plex-alternative-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 Jellyfin. 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 Jellyfin (Plex Alternative) MCP in Windsurf
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Jellyfin (Plex Alternative) MCP today
We host it, we monitor it, we maintain it. You just paste one token.
