Optic

Optic CLI

The Optic CLI provides OpenAPI diffing, linting, and breaking change detection from the command line, comparing two versions of an OpenAPI specification using behavior-aware diffing and applying style guide rules with forwards-only governance.

GitHub OpenAPI

Documentation

📖
Documentation
https://www.useoptic.com/docs
📖
GettingStarted
https://www.useoptic.com/docs

Other Resources

🔗
OpenAPI Diff
https://www.useoptic.com/docs/diff-openapi
🔗
Breaking Changes
https://www.useoptic.com/docs/detect-breaking-changes
🔗
Linting
https://www.useoptic.com/docs/lint-openapi
🔗
ChangeLog
https://www.useoptic.com/docs/openapi-changelog
🔗
API Verification
https://www.useoptic.com/docs/verify-openapi
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/optic/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/optic-cli"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

API entry from apis.yml

apis.yml Raw ↑ 
aid: optic:optic-cli
name: Optic CLI
description: The Optic CLI provides OpenAPI diffing, linting, and breaking change detection from the command
  line, comparing two versions of an OpenAPI specification using behavior-aware diffing and applying style
  guide rules with forwards-only governance.
humanURL: https://www.useoptic.com/docs
tags:
- Breaking Changes
- CLI
- Diff
- Linting
- OpenAPI
properties:
- type: Documentation
  url: https://www.useoptic.com/docs
- type: GettingStarted
  url: https://www.useoptic.com/docs
- type: OpenAPI Diff
  url: https://www.useoptic.com/docs/diff-openapi
- type: Breaking Changes
  url: https://www.useoptic.com/docs/detect-breaking-changes
- type: Linting
  url: https://www.useoptic.com/docs/lint-openapi
- type: ChangeLog
  url: https://www.useoptic.com/docs/openapi-changelog
- type: API Verification
  url: https://www.useoptic.com/docs/verify-openapi