Validate an OpenAPI 3.x (or Swagger 2.0) document given as JSON or YAML and return a report with errors, warnings, and summary info (title, version, path count, operation count). Errors cover a missing version field, missing info.title or info.version, a missing paths object, paths that do not start with "/", and operations without responses. Warnings cover missing operationId, Swagger 2.0 input, non-3.x versions, and component schemas with no type, $ref, or composition keyword.
This page documents the HTTP endpoint POST /api/tools/openapi-validator/execute. See the MCP reference →
Call it over REST
POST https://api.findutils.com/api/tools/openapi-validator/execute · no API keys · 60 requests/min per IP
Execute — verified arguments
curl -X POST https://api.findutils.com/api/tools/openapi-validator/execute \
-H "Content-Type: application/json" \
-d '{
"spec": "{\"openapi\":\"3.0.3\",\"info\":{\"title\":\"Sample API\",\"version\":\"1.0.0\"},\"paths\":{\"/users\":{\"get\":{\"operationId\":\"listUsers\",\"responses\":{\"200\":{\"description\":\"ok\"}}}}}}"
}'Parameter schema for this endpoint
curl https://api.findutils.com/api/tools/openapi-validatorInput schema
| Argument | Type | Required | Description |
|---|---|---|---|
| spec | string | yes | The OpenAPI or Swagger document as JSON or YAML text. |
Example arguments (verified)
{
"spec": {
"openapi": "3.0.3",
"info": {
"title": "Sample API",
"version": "1.0.0"
},
"paths": {
"/users": {
"get": {
"operationId": "listUsers",
"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:openapi_validator after one connect command.
Connect once
claude mcp add findutils --transport http https://mcp.findutils.com/More Validation tools
Email Validate
Validate an email address and break it into local / domain / TLD parts.
Html Formatter
Format (beautify) or minify HTML and return the result with a tag-balance validation report.
Json Validate
Validate a JSON string.
Phone Format
Format a phone number to E.164 (+CCNNNNNNN…) given an optional country calling code.
State Machine Designer
Validate a finite state machine given as nodes and edges and return a normalized machine config plus issues.
Url Validate
Validate that a string is a well-formed URL and (optionally) require HTTPS.
Wvw Apps Json Generator
Build and validate an apps.json manifest for wvw.dev (World Vibe Web) from a store object and a list of apps.
Xml Formatter
Beautify or minify an XML document and return the formatted text.