WindsurfWorks today

Windsurf's Cascade agent takes a remote MCP server with a bearer header.

You need a key first. API keys come with the Professional plan. Generate one on your account page, under API access. It starts with jbp_ and is shown once, so copy it when it appears. Everywhere below, replace jbp_your_key with it.

Set it up

Open the MCP config. Settings, then Cascade, then the MCP servers section, then edit the raw config. The file is ~/.codeium/windsurf/mcp_config.json.

Add the server.

{
  "mcpServers": {
    "jbparcel": {
      "serverUrl": "https://jbparcel.com/mcp",
      "headers": {
        "Authorization": "Bearer jbp_your_key"
      }
    }
  }
}

Refresh the server list in the MCP panel, or restart Windsurf.

What you get

Once connected, three tools appear in your assistant:

Tool	What it does
`search_parcels`	Runs the same advanced search the site runs. Filter by county, owner, acreage, year built, zoning, sale date, value, vacancy, absentee owners, LLC and trust owners.
`get_parcel`	Pulls one parcel's full record. Always free, never counted.
`get_account`	Reports your plan and what is left of your budget.

Budgets are shared with the site and the REST API. Every row a search returns counts, at any page size: 20,000 rows per day. Parcel lookups have their own separate count, 1,600 per day, so pulling one property's full record never eats into search. CSV exports are kept apart from both and keep their own rolling 7-day and 30-day budgets.

If it does not connect

What you see	What it means
401 Unauthorized	The key is missing, mistyped or revoked. Check the header reads exactly `Authorization: Bearer jbp_...` with one space after Bearer.
402, or a message about your plan	The key is valid but the account is not on Professional. API and connector access come with Professional.
405 Method Not Allowed	Something sent a GET. Our server speaks POST only. This almost always means the client is configured for SSE instead of streamable HTTP.
Connects, but no tools appear	Restart the client. Most read MCP config once at startup.

Still stuck? Tell us what you are using and paste the error. We answer.

Other clients

Setup guides for Claude Code, Cursor, VS Code, Gemini CLI and the plain REST API.