OpenAPI MCP Server

Name: OpenAPI MCP Server
Author: ivo-toby

ivo-toby

Get started Repository

Turns OpenAPI specifications into MCP resources so LLMs can discover and call the REST APIs they describe.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add openapi-server-ivo-toby --env API_BASE_URL='<API_BASE_URL>' --env OPENAPI_SPEC_PATH='<OPENAPI_SPEC_PATH>' --env API_HEADERS='<API_HEADERS>' -- npx -y @ivotoby/openapi-mcp-server

~/.codex/config.toml

[mcp_servers.openapi-server-ivo-toby]
command = "npx"
args = ["-y", "@ivotoby/openapi-mcp-server"]
env = { API_BASE_URL = "<API_BASE_URL>", OPENAPI_SPEC_PATH = "<OPENAPI_SPEC_PATH>", API_HEADERS = "<API_HEADERS>" }

# codex mcp add openapi-server-ivo-toby --env API_BASE_URL='<API_BASE_URL>' --env OPENAPI_SPEC_PATH='<OPENAPI_SPEC_PATH>' --env API_HEADERS='<API_HEADERS>' -- npx -y @ivotoby/openapi-mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "openapi-server-ivo-toby": {
      "command": "npx",
      "args": [
        "-y",
        "@ivotoby/openapi-mcp-server"
      ],
      "env": {
        "API_BASE_URL": "<API_BASE_URL>",
        "OPENAPI_SPEC_PATH": "<OPENAPI_SPEC_PATH>",
        "API_HEADERS": "<API_HEADERS>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "openapi-server-ivo-toby": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ivotoby/openapi-mcp-server"
      ],
      "env": {
        "API_BASE_URL": "<API_BASE_URL>",
        "OPENAPI_SPEC_PATH": "<OPENAPI_SPEC_PATH>",
        "API_HEADERS": "<API_HEADERS>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "openapi-server-ivo-toby": {
      "command": "npx",
      "args": [
        "-y",
        "@ivotoby/openapi-mcp-server"
      ],
      "env": {
        "API_BASE_URL": "<API_BASE_URL>",
        "OPENAPI_SPEC_PATH": "<OPENAPI_SPEC_PATH>",
        "API_HEADERS": "<API_HEADERS>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "openapi-server-ivo-toby": {
      "command": "npx",
      "args": [
        "-y",
        "@ivotoby/openapi-mcp-server"
      ],
      "env": {
        "API_BASE_URL": "<API_BASE_URL>",
        "OPENAPI_SPEC_PATH": "<OPENAPI_SPEC_PATH>",
        "API_HEADERS": "<API_HEADERS>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "openapi-server-ivo-toby": {
      "command": "npx",
      "args": [
        "-y",
        "@ivotoby/openapi-mcp-server"
      ],
      "env": {
        "API_BASE_URL": "<API_BASE_URL>",
        "OPENAPI_SPEC_PATH": "<OPENAPI_SPEC_PATH>",
        "API_HEADERS": "<API_HEADERS>"
      }
    }
  }
}

Environment variables

API_BASE_URL
OPENAPI_SPEC_PATH
API_HEADERS

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related