How to add OpenAPI MCP Server to Windsurf

Search and explore any OpenAPI spec in simple language, via oapis.org. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 895★ · http · no auth

Windsurf config for OpenAPI MCP Server

{
  "mcpServers": {
    "openapi-mcp-server": {
      "serverUrl": "https://openapi-mcp.openapisearch.com/mcp"
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

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

Before you start

An MCP-compatible client (e.g. Claude Desktop or Cursor)
Network access to the hosted endpoint https://openapi-mcp.openapisearch.com/mcp

What OpenAPI MCP Server can do in Windsurf

OpenAPI overview

Get a plain-language overview/summary of a given OpenAPI specification (resolved from an OpenAPI identifier).

Operation details

Retrieve details about specific API operations/endpoints from a spec, explained in simple language, for both JSON and YAML formats.

Security

Hosted, remote MCP server: requests for OpenAPI specs are processed via the oapis.org / openapisearch.com service rather than locally. No authentication is documented for the public MCP endpoint.

OpenAPI MCP Server + Windsurf FAQ

Where is the Windsurf config file?

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

Is OpenAPI MCP Server safe to use with Windsurf?

Hosted, remote MCP server: requests for OpenAPI specs are processed via the oapis.org / openapisearch.com service rather than locally. No authentication is documented for the public MCP endpoint.

Do I need to install anything locally?

No. It is a hosted remote MCP server. Point your client at the MCP URL https://openapi-mcp.openapisearch.com/mcp, or use the install link in the README.

Which clients are supported?

The README states it has been tested with Claude Desktop and Cursor, and notes that other clients can use the same MCP URL.

Can I run it myself?

Yes. The repo supports local testing with `wrangler dev` (it is a Cloudflare Worker) and the MCP inspector via `npx @modelcontextprotocol/inspector`.

View repo Full OpenAPI MCP Server page