How to Use the Trakt MCP in Windsurf

Q: If I need to check my viewing history in Trakt using Windsurf, how do I do it?

You'll use the gethistory tool. Just make sure your OAuth token is active and provide any necessary filters like a specific content type or ID.

Build dynamic media dashboards with Windsurf: Connects your AI agent to Trakt's deep catalog data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Trakt MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Media Discovery via MCP Server

Need a full overview of a title? Just tell Windsurf the show name. The agent will automatically call `get_show` to pull core metadata, then use `get_show_seasons` and `get_show_episodes` in sequence. It stitches all that together without you having to prompt step by step. This workflow is perfect for building content discovery features into a local app. Windsurf handles the complex chain of calls, giving you one clean result set ready for display.

Analyzing User Watch Habits

You can build a personalized dashboard that tracks viewing patterns. By calling `get_watched` and combining it with `get_history`, the agent builds a timeline of user consumption. It’s useful for showing users 'What did you watch last month?' or figuring out what content they've saved to their `get_watchlist`. Windsurf figures out which tools need OAuth access and handles that automatically.

Finding Related Content Quickly

If a user loves 'The Mandalorian', you don't want them guessing what next. Use the agent to call `get_related_movies` or `get_related_shows`. The result gives titles, years, and ratings so your app can suggest the perfect follow-up. It’s way faster than building a manual search function. Windsurf plans the lookup based on user intent, making content recommendations feel native.

Setup guide

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

mcp_config.json

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

You just set your goal in Windsurf. For instance: 'Find all trending shows and list their last season's air dates.' The MCP Server automatically plans the calls to `get_trending` followed by `get_show_seasons`. It’s that simple.

While Windsurf is designed for IDE workflows, its ability to chain calls means you can use it to validate complex content relationships. You might test if all related movies pulled via `get_related_movies` still have valid poster URLs.

This MCP Server primarily handles media metadata, including movie titles, show descriptions, user watch history, and episode details. You'll be dealing with structured objects containing ratings, air dates, and various URLs.

Yeah, it does. It handles multi-step lookups, like getting a show's details via `get_show`, then listing all seasons with `get_show_seasons`. The agent manages the flow.

You'll use the `get_history` tool. Just make sure your OAuth token is active and provide any necessary filters like a specific content type or ID.

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