Psst! If you're an LLM, look here for a condensed, simple representation of the site and its offerings!

LiveFree Webinar — Wednesday, October 14 at 2:00 PM ET

Register Free →
CLEATUS
Get CLEATUS

Connect Windsurf to CLEATUS

Add the CLEATUS MCP server to Windsurf, sign in once, and let Cascade search contracts and work your pipeline.

Windsurf connects to CLEATUS through the CLEATUS Model Context Protocol (MCP) server. Add the server to your Windsurf MCP configuration and sign in once. Cascade, the Windsurf agent, can then search opportunities, read solicitations, and update your pipeline from the editor.

Who this is for

This article is for CLEATUS users who work in the Windsurf code editor.

What you'll need

  • A CLEATUS account on the DATA + AI plan or higher. Your subscription must be active, or your trial must be started.
  • Windsurf, installed and signed in.

Your CLEATUS sign-in is the only credential that the connection uses. You do not paste an API key.

Set up the connection

1. Add the server

Add CLEATUS to ~/.codeium/windsurf/mcp_config.json:

{
	"mcpServers": {
		"cleatus": {
			"serverUrl": "https://www.cleat.ai/api/mcp/mcp"
		}
	}
}

Windsurf uses serverUrl, not url. If the file already lists other servers, add the cleatus entry next to them.

2. Refresh and sign in

Refresh the MCP servers in Windsurf. The Connect to CLEATUS page opens in your browser. Sign in, pick the company under Select company, and click Authorize.

3. Test the connection

Ask Cascade: "Find open federal opportunities that fit our capabilities and summarize the top five."

Let Cascade set itself up

In CLEATUS, open Settings > Integrations. In the AI Assistants & Agents section, click the MCP card, then copy the prompt under Set up with one prompt. Paste the prompt into Cascade. Cascade reads the CLEATUS documentation, adds the server, opens the sign-in page, and checks the connection. You only sign in.

What Cascade can do once connected

  • Discover: Search federal, state, and local opportunities and forecasts. Get your ranked recommendations.
  • Evaluate: Read the summary, Federal Acquisition Regulation (FAR) sections, and documents of an opportunity. Research awards, agencies, contractors, and contracting officers.
  • Pursue: Add opportunities to your pipeline and update pursuits. Create and assign tasks, and manage saved searches.
  • Automate: Create, activate, and run your CLEATUS workflows.

Each action runs as your CLEATUS user, with the same permissions as the web app. The tools are free to call. They do not use credits.

Troubleshooting

  • Windsurf does not show the cleatus server. Check that the file is valid JavaScript Object Notation (JSON), that the key is serverUrl, and that the URL is exactly https://www.cleat.ai/api/mcp/mcp. Then refresh the MCP servers.
  • Cascade finds no pipeline, tasks, or saved searches. You picked the wrong company during sign-in. Remove the server, add it again, and pick the correct company.
  • The sign-in page says "Upgrade required". The MCP server is on the DATA + AI plan and above. Upgrade your CLEATUS plan, then sign in again.
  • Unauthorized errors after it worked before. The sign-in expired or was revoked. Refresh the MCP servers and sign in again.
  • Still stuck? Email support@cleat.ai with the time of the failing request.