How to Use the Context7 MCP in Windsurf

Q: How does Context7 prevent Windsurf from using deprecated library APIs?

Context7 uses resolvelibrary to pin the exact version path, then querydocs pulls the active documentation for that version. Cascade reads this direct documentation instead of relying on outdated training data, stopping deprecated code generation before it starts.

Q: How do I configure Context7 inside my Windsurf MCP settings?

You add the server configuration to your /.codeium/windsurf/mcpconfig.json file under the mcpServers key. Once saved, Cascade immediately discovers the tools and uses them during code generation.

Feed live, accurate documentation directly to Cascade in Windsurf using this dedicated MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Context7 MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resolving exact library paths for Cascade

The `resolve_library` tool translates vague framework names into exact, deterministic version paths like `/facebook/react/18.2.0` inside Windsurf. Cascade uses these precise paths to target the exact code library you need without guessing. This stops Cascade from writing outdated code based on stale training data. When you tell Cascade to build a component, it invokes this tool first to pin down the exact version. You get clean, version-specific code templates immediately. No more manual searching for matching version numbers.

Pulling live code examples into Windsurf

The `query_docs` tool pulls real-world code examples and documentation matching your specific library ID and topic directly into your Windsurf workspace. Cascade chains this tool right after finding the library version to gather actual context before writing any files. This prevents Cascade from hallucinating methods. Instead of searching web forums, Cascade grabs the exact API signatures it needs. You see the correct syntax implemented immediately in your active editor. Your workspace stays clean and free of deprecated code.

Autonomous library research using this MCP Server

The `resolve_library` and `query_docs` tools work together within this MCP Server to let Cascade execute multi-step research tasks autonomously when you specify a library name. Cascade runs the resolution tool to locate the package, then immediately calls the query tool to pull the exact code templates. This happens without you needing to prompt each step. Cascade handles the entire sequence in the background, updating your workspace with working code that matches the library's latest specifications. You avoid copy-pasting code from browser tabs. The agent does the heavy lifting.

Setup guide

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

mcp_config.json

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

Context7 uses `resolve_library` to pin the exact version path, then `query_docs` pulls the active documentation for that version. Cascade reads this direct documentation instead of relying on outdated training data, stopping deprecated code generation before it starts.

Yes. When you ask Cascade to use a specific library, it automatically chains `resolve_library` and `query_docs` to fetch the correct documentation. You do not have to trigger each tool manually.

You add the server configuration to your `~/.codeium/windsurf/mcp_config.json` file under the `mcpServers` key. Once saved, Cascade immediately discovers the tools and uses them during code generation.

Unlike generic search engines that return cluttered web pages, this tool returns clean, deterministic JSON containing only the relevant code blocks and API references. This reduces token usage and keeps Cascade focused.

Vinkius runs this tool inside a secure V8 Isolate Sandbox. Your documentation queries and library IDs are processed ephemerally, meaning no search history or code snippets are stored on our servers after the request completes.

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