# Openapi MCP server

> Wraps Openapi.com APIs as an MCP server so AI clients can call them, with passthrough Bearer token auth and file handling.

- Repository: https://github.com/openapi/mcp-server
- Page: https://hostedmcp.org/servers/openapi/mcp-server
- Transport: remote
- Stars: 22
- License: MIT
- Latest version: 0.3.1

## Install

### Claude Code

```sh
claude mcp add --transport http mcp-server https://mcp.openapi.com/
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.openapi.com/"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.openapi.com/"
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp-server]
url = "https://mcp.openapi.com/"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "httpUrl": "https://mcp.openapi.com/"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `MCP_STORAGE_PATH` | no | no |  |

## FAQ

### How do I run the Openapi MCP server?

Run it directly from PyPI with a single command using uvx, or via pipx, pip, or Docker Compose.

### How does the Openapi MCP server authenticate?

It accepts a Bearer token either as a standard Authorization header or as a ?token= query parameter, which is promoted to a header automatically.

### Which clients lack header support and need the token query parameter?

Claude Desktop as of mid-2025 and some browser-based MCP playgrounds only accept a plain URL, so use ?token= there.

### How are large binary files returned by APIs handled?

The server downloads them, stores them in local disk, GCS, or S3, and serves them via a separate HTTP endpoint.

### Can I build a custom MCP server with this package?

Yes, openapi_mcp_sdk can be imported as a Python library to build a custom MCP server with your own tools and auth layer.