Windsurf

Windsurf is Codeium’s AI-powered IDE. Its Cascade feature supports MCP servers, letting you use Toolcog for API operations while coding.

Prerequisites

• Windsurf installed (download)
• A Toolcog account (sign up)

Configuration

Windsurf uses a JSON configuration file for MCP servers.

Config File Location

Add Toolcog

Create or edit mcp_config.json:

{
  "mcpServers": {
    "toolcog": {
      "url": "https://mcp.toolcog.com"
    }
  }
}

Enable MCP in Settings

1. Open Windsurf Settings (Cmd+Shift+P → “Open Windsurf Settings”)
2. Navigate to Cascade → Advanced Settings
3. Enable the Model Context Protocol option

Refresh Servers

After adding a new MCP server, press the refresh button in the Cascade panel to load it.

Using Toolcog

With Toolcog connected, ask Cascade:

“Find the Shopify API operation for creating products”

Cascade will use Toolcog to discover operations and help integrate them into your code.

Authentication

When Cascade needs to access your Toolcog account:

1. Cascade displays an authorization link
2. Click to sign in to Toolcog in your browser
3. Return to Windsurf

For downstream services (GitHub, Stripe, etc.), the same pattern applies.

Catalogs

Connect to specific catalogs:

{
  "mcpServers": {
    "toolcog-internal": {
      "url": "https://mcp.toolcog.com/mycompany/internal-apis"
    }
  }
}

Limitations

• Cascade has a limit of 100 total tools across all MCP servers
• Toolcog uses 3 tools, leaving room for 97 tools from other servers

Verify It’s Working

In Cascade, ask:

“What operations does Toolcog have for Stripe?”

If you see a list of Stripe operations, Toolcog is connected.

Troubleshooting

Server not appearing

• Verify your config file is valid JSON
• Check the file is in the correct location
• Press the refresh button in the Cascade panel
• Restart Windsurf

Tools not working

• Ensure MCP is enabled in Windsurf Settings
• Check you’re not exceeding the 100-tool limit

Authentication errors

• Click the authorization link to sign in to Toolcog
• Verify you’re signed in at toolcog.com

Next Steps

• Quick Start — Your first API operation
• API Meta-Tools — How discovery, learning, and execution work