# Model Cost Comparison — Developers

> Scoped agent index for the developer portal, REST API, CLI, and sandbox.

## Docs
- Developer portal (HTML): https://modelcostcomparison.com/developers
- OpenAPI: https://modelcostcomparison.com/openapi.json
- API catalog (RFC 9727): https://modelcostcomparison.com/.well-known/api-catalog
- Site llms.txt: https://modelcostcomparison.com/llms.txt

## API
- Index: GET https://modelcostcomparison.com/api/v1
- Models advisor: POST https://modelcostcomparison.com/api/v1/models/advisor
- Legacy advisor (deprecated): POST https://modelcostcomparison.com/api/mcc-model-advisor

## Versioning
Stable REST operations use major-version URL paths beginning with /api/v1. Breaking changes ship under a new major path (/api/v2). Additive, non-breaking changes may appear on the current major without a path bump.
Deprecated operations return Deprecation: true (RFC 9745) and a Link rel="successor-version" header pointing at the replacement. When a removal date is set, responses also include Sunset (RFC 8594).

## Errors
API errors use application/problem+json (RFC 9457) with code, detail, and resolution.

## CLI
npm package: modelcostcomparison
npx modelcostcomparison --help

## Sandbox datasets
- https://modelcostcomparison.com/ai-provider-pricing-validated.json
- https://modelcostcomparison.com/ai-benchmarks-snapshot.json

## Auth
Public datasets and the models advisor require no API key (advisor is rate-limited). Cron refresh uses Bearer CRON_SECRET.