Diff two versions of an OpenAPI spec for breaking changes
diff_api_specsCompare two OpenAPI/Swagger specs (URL or file path) to identify breaking changes—removed endpoints, newly required fields, type changes, removed enum values—and safe additions.
Instructions
Compare two OpenAPI/Swagger specs (each a URL or local file path — e.g. an old tag vs. the current main) and report added/removed endpoints plus request/response schema changes, flagging which ones are likely to break existing clients (removed fields, newly-required fields, type changes, removed enum values) versus safe additive changes. Does not affect the spec currently loaded for the other tools.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"sourceA": "<sourceA>",
"sourceB": "<sourceB>"
},
"name": "diff_api_specs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sourceA | Yes | The 'before' spec — URL or local file path. | |
| sourceB | Yes | The 'after' spec — URL or local file path. |