api-contract-validator

Tools

Token cost is the o200k count of the tools list JSON, including schemas, before any tool is called.

• validate_openapi_spec

  Validate an OpenAPI 3.x or AsyncAPI spec JSON. Returns structural errors, missing required fields, and warnings.

• diff_request_response

  Compare a real HTTP request/response against an OpenAPI spec contract. Returns per-field violations.

• 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.

• generate_mock_from_spec

  Generate mock response data from an OpenAPI spec. Uses examples, defaults, formats, and type heuristics.

• check_breaking_changes

  Compare two OpenAPI spec versions to detect breaking changes: removed paths/operations, new required parameters, removed response codes, operationId renames.