How to add Agentset MCP to Windsurf

Retrieve from your Agentset RAG knowledge base directly inside Claude, Cursor, and other MCP clients. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 30★ · stdio · apikey

Windsurf config for Agentset MCP

npx @agentset/mcp

{
  "mcpServers": {
    "agentset-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agentset/mcp@latest"
      ],
      "env": {
        "AGENTSET_API_KEY": "agentset_xxx",
        "AGENTSET_NAMESPACE_ID": "ns_xxx"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Agentset MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Agentset MCP's tools become available to Cascade.

Before you start

Node.js >= 18.17.0
An Agentset account and API key (AGENTSET_API_KEY)
An Agentset namespace id (AGENTSET_NAMESPACE_ID or the --ns flag) with ingested documents

What Agentset MCP can do in Windsurf

knowledge-base-retrieve

Search the Agentset knowledge base (namespace) for data matching a query. Accepts a `query` string, an optional `topK` (1-100, default 10) for the maximum number of results, and an optional `rerank` boolean (default true) to reorder results by relevance. Returns the matching document text chunks. The tool description can be customized via the -d flag.

Security

Requires an Agentset API key (AGENTSET_API_KEY), which grants access to your Agentset account data. Provide it via the env block of your MCP client config and keep it out of source control. The server queries the namespace specified by AGENTSET_NAMESPACE_ID (or --ns); scope the API key and namespace appropriately, and use the tenant id (-t) to isolate data in multi-tenant deployments.

Agentset MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Agentset MCP config there under the "mcpServers" key and restart the client.

Is Agentset MCP safe to use with Windsurf?

How do I tell the server which knowledge base to query?

Pass the namespace id with the --ns flag (e.g. `--ns your-namespace-id`) or set the AGENTSET_NAMESPACE_ID environment variable. The API key is provided via AGENTSET_API_KEY.

Can I use it in a multi-tenant setup?

Yes. Pass a tenant id with the -t/--tenant flag (e.g. `-t your-tenant-id`) so searches are scoped to that tenant's data.

Can I customize how the tool appears to the assistant?

Yes. Use the -d/--description flag to override the default tool description, e.g. `-d "Your custom tool description"`, which helps the model understand what knowledge it is querying.

View repo Full Agentset MCP page