Skip to main content
Connect UseAgents to Windsurf so your AI assistant can discover verified developer tools from the registry.
UseAgents is currently free during our public beta. No API key is required. Requests are subject to rate limits.

​
Option 1: MCP Marketplace

  1. Open the Cascade panel in Windsurf.
  2. Click the MCPs icon (or go to Windsurf Settings → Cascade → MCP Servers).
  3. Search for UseAgents and click Install.

​
Option 2: Manual config

If UseAgents is not listed in the Marketplace, add it manually by editing the config file.

​
Locate the config file

You can also open it by pressing Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) and selecting “Windsurf: Configure MCP Servers”.

​
Add UseAgents

Add the following to the mcpServers object:
Windsurf uses "serverUrl" (not "url") for remote HTTP/SSE servers. This is different from the standard MCP config format used by Cursor and Claude.
If you already have other servers configured, add the "UseAgents" entry inside the existing "mcpServers" object.

​
Verify the connection

  1. Quit and reopen Windsurf completely — changes to mcp_config.json require a full restart.
  2. Open the Cascade panel and check that UseAgents appears in the MCP Servers list.
  3. Ask Cascade to search for a tool — for example: “Use UseAgents to find a TypeScript SDK for Stripe.”
  4. Confirm you receive structured tool results.

​
Troubleshooting

  • Server not appearing: Windsurf requires a full quit and reopen, not just a window close.
  • Connection failed: Verify that the serverUrl value is exactly https://mcp.useagents.site/mcp.
  • Too many tools warning: Windsurf has a 100-tool limit across all connected servers. UseAgents exposes only 2 tools, so this should not be an issue.

​
Next steps