io.github.lazymac2x/api-contract-validator
Official5 toolsby lazymac2x · JavaScript
Cloudflare Workers MCP server: api-contract-validator
Validates API contracts and schema compliance for request/response validation.
Captured live from the server via tools/list.
validate_openapi_spec
Validate an OpenAPI 3.x or AsyncAPI spec JSON. Returns structural errors, missing required fields, and warnings.
Parameters (2)
- specobjectrequired
OpenAPI or AsyncAPI spec as a JSON object
- strictboolean
Treat warnings as errors (default: false)
diff_request_response
Compare a real HTTP request/response against an OpenAPI spec contract. Returns per-field violations.
Parameters (3)
- specobjectrequired
OpenAPI spec JSON object
- requestobjectrequired
HTTP request to validate
- responseobject
HTTP response to validate (optional)
lint_api_schema
Lint an API spec for quality and best practice compliance. Rules: operation-id-kebab-case, response-success-required, tags-defined, no-empty-description, security-defined.
Parameters (2)
- specobjectrequired
OpenAPI spec JSON object
- rulesarray
Rules to apply (defaults to all)
generate_mock_from_spec
Generate mock response data from an OpenAPI spec. Uses examples, defaults, formats, and type heuristics.
Parameters (4)
- specobjectrequired
OpenAPI spec JSON object
- pathstring
Target path (optional; generates all if omitted)
- methodstring
HTTP method (used with path)
- statusCodestring
Response status code (default: 200)
check_breaking_changes
Compare two OpenAPI spec versions to detect breaking changes: removed paths/operations, new required parameters, removed response codes, operationId renames.
Parameters (2)
- spec_oldobjectrequired
Previous spec version
- spec_newobjectrequired
New spec version
README not available yet.
Install
claude_desktop_config.json
{
"mcpServers": {
"api-contract-validator": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.lazy-mac.com/api-contract-validator/mcp"
]
}
}
}Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.