How to Use the MongoDB Atlas Vector Search MCP in Windsurf

Q: Can I use Windsurf to automate index creation?

Absolutely. You can instruct Cascade to run createindex whenever your schema changes. It handles the definition and triggers the update for you.

Windsurf connects directly to your database, letting Cascade execute vector searches and MQL queries without leaving your editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MongoDB Atlas Vector Search MCP to Windsurf

Create your Vinkius account to connect MongoDB Atlas Vector Search 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 MongoDB Atlas Vector Search with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Direct vector search via Windsurf

Cascade handles the heavy lifting of mapping your embedding logic directly to your database. It uses `search` to pull relevant records based on vector similarity without you writing a single line of boilerplate. Once the connection is active, Windsurf interprets your natural language intent to trigger `create_index` or `insert`. The agent manages the entire indexing lifecycle so you stay focused on the code.

Manage collections inside your MCP Server

Windsurf gives you full visibility into your data structure by using `list_collections`. You can audit your environment and verify schema alignment before executing any complex operations. This approach lets you verify your data footprint before running `delete` or `find` commands. Your AI agent maintains context on your database state to ensure every operation hits the correct target.

Autonomous MQL execution in Windsurf

You can offload routine data retrieval tasks to Cascade using `find`. It translates your requirements into standard query filters, pulling documents directly into your workspace for immediate review. This MCP Server allows Windsurf to bridge the gap between your local logic and your production data. You get immediate feedback on document contents without manually querying the database via the terminal.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "mongodb-atlas-vector-search-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 MongoDB Atlas Vector Search. 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 MongoDB Atlas Vector Search 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 MongoDB Atlas Vector Search MCP in Windsurf

Yes. Windsurf connects to your cluster and executes the query through the MCP protocol. It pulls the results directly into your chat context for immediate analysis.

You provide the connection string via your config file. The server handles the authentication handshake securely so Windsurf can focus on executing tools.

No. The MCP server runs as a separate process. Windsurf only receives the specific data returned by your tools, keeping your editor responsive.

Absolutely. You can instruct Cascade to run `create_index` whenever your schema changes. It handles the definition and triggers the update for you.

Your data never leaves the connection between your Windsurf instance and your MongoDB cluster. The server only transmits the query results and tool outputs you explicitly request.

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