How to Use the HowLongToBeat MCP in Windsurf

Q: Can I search for different completion types with HowLongToBeat in Windsurf?

Yes. The searchgametimes tool returns data for 'Main Story', 'Main + Extras', and 'Completionist'. You can ask Windsurf to use a specific one when filtering or creating lists.

Stop guessing game lengths. Windsurf's Cascade agent now fetches completion times for you, automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HowLongToBeat MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Instantly Vet Your Game Backlog

The `search_game_times` tool gives your agent direct access to gameplay hour data. Feed Windsurf's Cascade agent a list of games from your backlog, and it will get the completion time for every single one. There's no need to prompt for each title. Cascade gets your goal, chains the `search_game_times` calls, and returns a clean list with the numbers. You'll know which games are a weekend project and which are a month-long commitment.

Plan Your Gaming with This MCP Server

Tell Windsurf something like, "Find me some RPGs I can finish in under 20 hours." Cascade takes that prompt and understands the goal. It can use this MCP server to find games that fit your schedule. Your agent queries for potential titles and then uses `search_game_times` to filter out the 100-hour epics. You get a list of games you can actually finish, not just a generic recommendation.

Build Formatted Game Lists

This isn't just for one-off questions. Ask Windsurf to create a markdown table of co-op games sorted by their 'Main + Extras' completion time. Cascade will plan the steps: find games, get their times, and format the output. The agent calls the `search_game_times` tool for each game and assembles the results into a ready-to-use file. This is how you turn a simple question into a finished document, all in one step.

Setup guide

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

mcp_config.json

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

Windsurf's Cascade agent takes your goal, like "find short games," and uses the `search_game_times` tool to get data. It then filters the results based on the hours you specified, giving you a targeted list.

No. Vinkius manages the connection. You just add the MCP server in Windsurf and its tools are ready to go.

Yes. The `search_game_times` tool returns data for 'Main Story', 'Main + Extras', and 'Completionist'. You can ask Windsurf to use a specific one when filtering or creating lists.

The tool will return a clear message stating the game wasn't found. Your Windsurf agent will see this and can either skip the title or let you know it couldn't get the data.

Your queries only contain game titles. The Vinkius platform processes these requests in an ephemeral, zero-trust sandbox. Your search history isn't stored, and the connection is secured end-to-end.

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