How to add OpenAPI MCP Server to Cursor

Search and explore any OpenAPI spec in simple language, via oapis.org. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor config for OpenAPI MCP Server

{
  "mcpServers": {
    "openapi-mcp-server": {
      "url": "https://openapi-mcp.openapisearch.com/mcp",
      "type": "streamable-http"
    }
  }
}

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

Setup steps

1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the OpenAPI MCP Server config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of OpenAPI MCP Server's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the OpenAPI MCP Server config there under the "mcpServers" key and restart the client.

Is OpenAPI MCP Server safe to use with Cursor?

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