Convert a Swagger 2.0 document (JSON or YAML) to OpenAPI 3.0.3 and return the result as pretty-printed JSON with path and schema counts. host, basePath, and schemes become servers; body and formData parameters become requestBody; response schemas move under content; definitions become components/schemas with $ref rewritten; securityDefinitions become components/securitySchemes (basic, apiKey, oauth2 flows).
This page documents the MCP tool findutils:swagger_to_openapi. See the REST reference →
Call it over MCP
Tool name findutils:swagger_to_openapi
· no API keys · 120 requests/min per IP
Claude Code
claude mcp add findutils --transport http https://mcp.findutils.com/ Claude Desktop — claude_desktop_config.json
{
"mcpServers": {
"findutils": {
"url": "https://mcp.findutils.com/"
}
}
} Raw JSON-RPC (any MCP client) — verified example
curl -X POST https://mcp.findutils.com/ \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "swagger_to_openapi",
"arguments": {
"swagger": "{\"swagger\":\"2.0\",\"info\":{\"title\":\"Sample API\",\"version\":\"1.0.0\"},\"host\":\"api.example.com\",\"basePath\":\"/v1\",\"paths\":{\"/users\":{\"get\":{\"responses\":{\"200\":{\"description\":\"ok\"}}}}}}"
}
}
}' Input schema
| Argument | Type | Required | Description |
|---|---|---|---|
| swagger | string | yes | The Swagger 2.0 document as JSON or YAML text. |
Example arguments (verified)
{
"swagger": {
"swagger": "2.0",
"info": {
"title": "Sample API",
"version": "1.0.0"
},
"host": "api.example.com",
"basePath": "/v1",
"paths": {
"/users": {
"get": {
"responses": {
"200": {
"description": "ok"
}
}
}
}
}
}
} Arguments that carry JSON as a string are shown decoded for readability. The Copy button copies the exact wire arguments.
Also a REST endpoint
The same tool answers plain HTTP at
POST /api/tools/swagger-to-openapi/execute — no key, 60 requests/min.
More Data tools
Api Docs Generator
Return API documentation generated from a list of endpoints, as Markdown (with table of contents, request/response examples) or as an OpenAP
Bookmarks Html To Csv
Convert a browser bookmarks.html export from Chrome, Firefox, Edge, Safari or any other browser that writes the Netscape bookmark format int
Csv To Bookmarks Html
Convert a CSV of links into a Netscape bookmarks.html file that Chrome, Firefox, Edge and Safari import.
Csv To Json
Parse CSV text into an array of objects keyed by the header row.
Csv To Sql
Convert CSV text into SQL INSERT statements, optionally preceded by a CREATE TABLE.
Graphql To Typescript
Convert a GraphQL SDL schema into TypeScript type definitions and return the generated code with counts of emitted types, enums, and inputs.
Html Table To Json
Convert an HTML <table> into JSON — an array of objects keyed by the header row, or an array of row arrays.
Jq Playground
Returns the result of running a jq-style filter over a JSON document.