OpenAPI MCP Server

MCP Server (Model Context Protocol) for turning OpenAPI specifications into a MCP Resource

Catalog onlyCatalog onlySTDIO

Overview

The OpenAPI MCP Server is a Model Context Protocol (MCP) server that facilitates the interaction between Large Language Models and REST APIs defined by OpenAPI specifications, turning these specifications into MCP resources.

To use the OpenAPI MCP Server, you need to configure it within the Claude Desktop application by editing a JSON configuration file to specify your API details.

Exposes OpenAPI endpoints as MCP resources for easy discovery and interaction. - Supports configuration through environment variables for flexible integration. - Provides development tools for building, linting, and debugging the codebase.

Integrating Large Language Models with various REST APIs seamlessly.
Simplifying API consumption in applications that require dynamic resource access.
Enabling automated interaction with APIs using human-like contexts.

Add to your AI client

Use these steps to connect OpenAPI MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-openapi-server-ivo-toby": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-openapi-server-ivo-toby"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-openapi-server-ivo-toby": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-openapi-server-ivo-toby"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-openapi-server-ivo-toby": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-openapi-server-ivo-toby"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-openapi-server-ivo-toby": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-openapi-server-ivo-toby"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-openapi-server-ivo-toby": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-openapi-server-ivo-toby"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-openapi-server-ivo-toby": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-openapi-server-ivo-toby"
      ]
    }
  }
}

FAQ

What is the Model Context Protocol (MCP)?

MCP is a protocol that standardized the way Large Language Models access and use various contextual resources, including APIs.

Is the server free to use?

Yes, the OpenAPI MCP Server is free and open source.

What are the prerequisites for using this server?

Users need to have Node.js and npm installed to run the server and its commands.

Developer tools