Generic MCP gateway that converts any OpenAPI spec into MCP tools for AI agents.
266
A zero-code MCP (Model Context Protocol) gateway that reads any OpenAPI 3.x spec and automatically exposes each operation as an MCP tool — making existing REST APIs instantly accessible to AI agents.
linux/amd64, linux/arm64)docker run -p 8000:8000 \
-e API_BASE_URL=https://your-api.example.com \
pivotalservicesoss/openapi-to-mcp:latest
MCP endpoint: http://localhost:8000/mcp
For advanced configuration and usage, please refer to source repository(link provided below) readme or docs.
| Variable | Description | Default |
|---|---|---|
| API_BASE_URL | Upstream API base URL | required |
| API_SPEC_URL | OpenAPI spec URL | {API_BASE_URL}/openapi.json |
| PORT | Listening port | 8000 |
| LOG_LEVEL | Log level | info |
| APP_ENV | production or development | production |
| SKIP_SSL_VERIFY | Skip SSL verification | false |
| API_TIMEOUT | Request timeout (seconds) | 30 |
| Variable | Description | Default |
|---|---|---|
| TOOL_TAGS | Include operations matching these tags | mcp |
| TOOL_WHITELIST | Include only these operation IDs | — |
| TOOL_EXCLUDE | Exclude these operation IDs | — |
| Variable | Description | Default |
|---|---|---|
| API_TOKEN_URL | Token endpoint URL | — |
| API_CLIENT_ID | Client ID | — |
| API_CLIENT_SECRET | Client secret | — |
| API_SCOPE | Requested scope | — |
| Variable | Description | Default |
|---|---|---|
| AUTH_PROXY_ISSUER | OIDC issuer for JWT validation | — |
| AUTH_PROXY_AUDIENCE | Expected JWT audience | — |
| TRUST_INBOUND | Skip inbound auth validation | false |
Content type
Image
Digest
sha256:7275fb430…
Size
272.8 kB
Last updated
7 months ago
docker pull pivotalservicesoss/openapi-to-mcp:sha256-34b7e0ae99053fca9b6f0d0f7fd1dd5825d1b6407e99ed9ca8118471e70a24ed.sbom