Swagger To Openapi

Data REST API MCP

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 HTTP endpoint POST /api/tools/swagger-to-openapi/execute. See the MCP reference →

Use in the browser View as Markdown

Call it over REST

POST https://api.findutils.com/api/tools/swagger-to-openapi/execute · no API keys · 60 requests/min per IP

Execute — verified arguments

curl -X POST https://api.findutils.com/api/tools/swagger-to-openapi/execute \
  -H "Content-Type: application/json" \
  -d '{
    "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\"}}}}}}"
  }'

Parameter schema for this endpoint

curl https://api.findutils.com/api/tools/swagger-to-openapi

Interactive docs · OpenAPI 3.1 spec · All REST tools

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 an MCP tool

Claude, Cursor, and any MCP client can call this tool as findutils:swagger_to_openapi after one connect command.

Connect once

claude mcp add findutils --transport http https://mcp.findutils.com/

Open the MCP reference for Swagger To Openapi →

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

Csv To Json

Parse CSV text into an array of objects keyed by the header row.

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.

Json Comparer

Returns a git-style line diff of two JSON documents after both are pretty-printed with 2-space indentation.

Json Diff

Returns the semantic differences between two JSON documents as a list of added, removed and modified paths with their old and new values, pl

Json Faker

Returns an array of fake JSON records built from a field list, for testing and prototyping.