Can my agent perform K-Nearest Neighbor (KNN) vector searches in Couchbase?

Yes. Provide the search index name, the vector embedding array, and the number of results (k). The agent uses Couchbase's native vector capabilities to locate the most semantically similar documents in your cluster.

How do I execute a N1QL query through the agent?

Use the 'execute_n1ql_query' tool and provide your SQL-like statement. The agent will fetch the structural JSON blocks directly from Couchbase, allowing you to perform complex data retrieval using familiar SQL syntax.

Can I search documents using full-text query logic?

Absolutely. The 'fts_search' tool leverages Couchbase's Full-Text Search (FTS) engine. Provide an index name and a boolean query string to perform structural text-based extraction across your document trees.

Couchbase (Vector & NoSQL) MCP Server for Windsurf 7 tools — connect in under 2 minutes

Name: Couchbase (Vector & NoSQL)
Availability: InStock
Author: Vinkius

docs.windsurf.com/windsurf/mcp

Built by Vinkius GDPR 7 Tools IDE

Windsurf brings agentic AI coding to a purpose-built IDE. Connect Couchbase (Vector & NoSQL) through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

RecommendedModern Approach — Zero Configuration

Vinkius Desktop App

The modern way to manage MCP Servers — no config files, no terminal commands. Install Couchbase (Vector & NoSQL) and 2,500+ MCP Servers from a single visual interface.

Download Free Open SourceNo signup required

Classic Setup·json

{
  "mcpServers": {
    "couchbase-vector-nosql": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Couchbase (Vector & NoSQL) MCP Server

Connect your Couchbase (Capella or self-hosted) cluster to any AI agent and take full control of your NoSQL and vector data through natural conversation.

Windsurf's Cascade agent chains multiple Couchbase (Vector & NoSQL) tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 7 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.

What you can do

Vector Search (KNN) — Execute direct searches mapping AI embeddings to locate textual similarities using native vector indices
N1QL SQL-for-JSON — Push absolute explicit querying using N1QL (SQL for Couchbase) to retrieve complex JSON structures across your buckets
Document CRUD — Fetch elaborate internal properties and retrieve exact Data maps from specific collections using unique document keys
Full-Text Search (FTS) — Perform structural text-based extraction matching query strings across advanced FTS search indexes
Schema Navigation — Identify bounded routing spaces including Buckets, Scopes, and Collections to understand your data organization
Index Auditing — Enumerate explicitly registered Search Indexes and verify vector definitions and cluster configurations

The Couchbase (Vector & NoSQL) MCP Server exposes 7 tools through the Vinkius. Connect it to Windsurf in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Couchbase (Vector & NoSQL) to Windsurf via MCP

Follow these steps to integrate the Couchbase (Vector & NoSQL) MCP Server with Windsurf.

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"

Add the server

Paste the JSON configuration above into mcp_config.json

Save and reload

Windsurf will detect the new server automatically

Start using Couchbase (Vector & NoSQL)

Open Cascade and ask: "Using Couchbase (Vector & NoSQL), help me...". 7 tools available

Why Use Windsurf with the Couchbase (Vector & NoSQL) MCP Server

Windsurf provides unique advantages when paired with Couchbase (Vector & NoSQL) through the Model Context Protocol.

Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention

Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively

JSON-based configuration means zero code changes: paste a URL, reload, and all 7 tools are immediately available

Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts

Couchbase (Vector & NoSQL) + Windsurf Use Cases

Practical scenarios where Windsurf combined with the Couchbase (Vector & NoSQL) MCP Server delivers measurable value.

Automated code generation: ask Cascade to fetch data from Couchbase (Vector & NoSQL) and generate models, types, or handlers based on real API responses

Live debugging: query Couchbase (Vector & NoSQL) tools mid-session to inspect production data while debugging without leaving the editor

Documentation generation: pull schema information from Couchbase (Vector & NoSQL) and have Cascade generate comprehensive API docs automatically

Rapid prototyping: combine Couchbase (Vector & NoSQL) data with Cascade's code generation to scaffold entire features in minutes

Couchbase (Vector & NoSQL) MCP Tools for Windsurf (7)

These 7 tools become available when you connect Couchbase (Vector & NoSQL) to Windsurf via MCP:

execute_n1ql_query

Provision a highly-available JSON Payload generating generic N1QL constraints

fts_search

Perform structural text-based extraction matching asynchronous Content Trees

get_document

Fetch elaborate internal mapped properties limiting Couchbase KV documents

list_buckets

Identify bounded routing spaces inside the Headless Couchbase DB

list_indexes

Enumerate explicitly attached structured rules exporting active Search Indexes

list_scopes

Retrieve explicit UX logging tracing explicit Scope and Collection Object limits

vector_search

Execute static listing mapping structural KNN Vector similarities via Index

Example Prompts for Couchbase (Vector & NoSQL) in Windsurf

Ready-to-use prompts you can give your Windsurf agent to start working with Couchbase (Vector & NoSQL) immediately.

"List all search indexes in my cluster"

"Find the top 3 similar products using this vector: [0.12, -0.5, 0.88]"

"Run N1QL query: 'SELECT name, price FROM `travel-sample` WHERE price < 100 LIMIT 5'"

Troubleshooting Couchbase (Vector & NoSQL) MCP Server with Windsurf

Common issues when connecting Couchbase (Vector & NoSQL) to Windsurf through the Vinkius, and how to resolve them.

Server not connecting

Check Settings → MCP for the server status. Try toggling it off and on.

Couchbase (Vector & NoSQL) + Windsurf FAQ

Common questions about integrating Couchbase (Vector & NoSQL) MCP Server with Windsurf.

How does Windsurf discover MCP tools?

Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.

Can Cascade chain multiple MCP tool calls?

Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.

Does Windsurf support multiple MCP servers?

Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.