Score an OpenAPI 3.x or Swagger 2.x spec on agent-readiness
Score an OpenAPI 3.x or Swagger 2.x spec on agent-readiness - i.e. does an LLM-driven caller have what it needs to call the API correctly without guessing. Returns a 0..100 score, severity counts, and a structured list of violations with stable rule codes. Checks: documented title/servers/paths, per-operation summary/description/operationId/tags, documented 2xx + error responses, param descriptions/schemas/examples, response descriptions, JSON response schemas.
Answeringour last check, 2026-09-24
1 of 1checks answered this week
1058 msmedian answer time
$0.002listed price per call
$0.002price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://agent402.tools/api/openapi-lint
| Category | Code and developer |
|---|---|
| Provider host | agent402.tools |
| Networks | algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=, eip155:10, eip155:1329, eip155:137, eip155:143, eip155:42161, eip155:42220, eip155:43114, eip155:4663, eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, stellar:pubnet |
| Payment schemes | exact, upto |
| Self-reported calls, 30 days | 5 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-24 | valid payment request | 402 | $0.002 | 1058 ms |
Example input (from the provider)
{
"body": {
"spec": {
"info": {
"description": "An example API",
"title": "Demo",
"version": "1.0.0"
},
"openapi": "3.0.0",
"paths": {
"/users": {
"get": {
"parameters": [
{
"description": "Max results",
"in": "query",
"name": "limit",
"schema": {
"example": 10,
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "array"
}
}
},
"description": "ok"
},
"400": {
"description": "bad input"
}
},
"summary": "List users",
"tags": [
"users"
]
}
}
},
"servers": [
{
"url": "https://api.example.com"
}
]
}
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"properties": {
"spec": {
"description": "OpenAPI/Swagger document (object or JSON string)"
}
},
"required": [
"spec"
]
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"counts": {
"properties": {
"error": {
"type": "integer"
},
"info": {
"type": "integer"
},
"warning": {
"type": "integer"
}
},
"type": "object"
},
"ok": {
"type": "boolean"
},
"score": {
"type": "integer"
},
"violations": {
"items": {
"properties": {
"location": {
"type": "string"
},
"message": {
"type": "string"
},
"rule": {
"type": "string"
},
"severity": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"required": [
"ok",
"score",
"counts",
"violations"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}