# info.description
Public machine-readable surfaces for Model Cost Comparison (77 models, 11 providers).
Developer portal: https://modelcostcomparison.com/developers

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

## Deprecation
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).
Policy details: https://modelcostcomparison.com/developers#versioning-and-deprecation

## Errors
All API errors use RFC 9457 application/problem+json with stable `code`, human `detail`/`title`, and optional `resolution` hint. A nested `error` object mirrors `{ code, message, hint? }` for older clients.

# info.x-mcc-versioning.description
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.

# info.x-mcc-versioning.deprecation
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).

# paths./api/v1/models/advisor.post.description
Models-only advisor grounded in calculator prices and Artificial Analysis benchmarks. Refuses unrelated topics. Public — no API key.

# paths./api/v1/models/advisor.post.requestBody.content.application/json.schema.properties.message.example
I need a support chatbot for 50k tickets/month

# paths./api/v1/cron/trigger-ai-pricing-refresh.get.description
Authenticated cron endpoint. Requires Bearer CRON_SECRET.

# paths./api/mcc-model-advisor.post.description
Deprecated alias of /api/v1/models/advisor. Responses include Deprecation and Link rel=successor-version headers.

# paths./api/mcc-model-advisor.post.requestBody.content.application/json.schema.properties.message.example
I need a support chatbot for 50k tickets/month

# components.schemas.AgentError.description
RFC 9457 problem details with MCC code/resolution and nested error object