ModelCostComparison
Find AI model pricing, estimate token costs and compare offers. No API key required.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~7,718Tokens (tool definitions)
~14.1 KBTypical response size
Significant attention impact (6.03% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"modelcostcomparison": {
"url": "https://modelcostcomparison.com/api/v1/mcp"
}
}
}Remote endpoints
https://modelcostcomparison.com/api/v1/mcpstreamable-httpWhat it can do
Tool inventory
Tools (6)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢list_models(query, provider_id, pricing_tier, status, limit, ...)
Find exact pricing offers and their IDs. Defaults to current reviewed prices; offers may still have unsupported billing modes. No model capability recommendation. Search accepts case, spacing and punctuation variants of recorded labels and API IDs. Multiple matching tariffs are returned as choices; costing still requires an exact ID.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 100
},
"provider_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"pricing_tier": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"type": "string",
"enum": [
"current",
"expired",
"unreviewed",
"all"
],
"default": "current"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20
},
"cursor": {
"type": "string",
"minLength": 1,
"maxLength": 2048
}
},
"required": [],
"additionalProperties": false
}Output Schema
{
"type": "object",
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"properties": {
"ok": {
"const": true
},
"meta": {
"$ref": "#/$defs/meta"
},
"data": {
"type": "object",
"additionalProperties": false,
"properties": {
"models": {
"type": "array",
"items": {
"$ref": "#/$defs/summary"
},
"maxItems": 50
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/$defs/warning"
}
}
},
"required": [
"models",
"next_cursor",
"warnings"
]
}
},
"required": [
"ok",
"meta",
"data"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"ok": {
"const": false
},
"meta": {
"anyOf": [
{
"$ref": "#/$defs/meta"
},
{
"type": "null"
}
]
},
"error": {
"$ref": "#/$defs/error"
},
"errors": {
"type": "array",
"items": {
"$ref": "#/$defs/error"
},
"maxItems": 20
}
},
"required": [
"ok",
"meta",
"error",
"errors"
]
}
],
"$defs": {
"meta": {
"type": "object",
"additionalProperties": false,
"properties": {
"contract_version": {
"const": "1.0"
},
"dataset_revision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"dataset_updated_at": {
"type": "string"
},
"evaluated_at": {
"type": "string",
"format": "date-time"
}
},
"required": [
"contract_version",
"dataset_revision",
"dataset_updated_at",
"evaluated_at"
]
},
"warning": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
]
},
"error": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"INVALID_ARGUMENT",
"MODEL_NOT_FOUND",
"PRICE_UNREVIEWED",
"PRICE_EXPIRED",
"SCOPE_REQUIRED",
"SCOPE_EXCEEDED",
"UNSUPPORTED_TARIFF",
"UNSUPPORTED_CACHE",
"CATALOGUE_INCONSISTENT",
"INVALID_CURSOR",
"CURSOR_EXPIRED",
"DATASET_CHANGED",
"NO_COMPARABLE_MODELS",
"DATASET_UNAVAILABLE",
"INTERNAL_ERROR"
]
},
"message": {
"type": "string"
},
"field": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"model_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 200
},
{
"type": "null"
}
]
},
"resolution": {
"type": "string"
}
},
"required": [
"code",
"message",
"field",
"model_id",
"resolution"
]
},
"identity": {
"type": "object",
"additionalProperties": false,
"properties": {
"model_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"label": {
"type": "string"
},
"api_model_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provider_id": {
"type": "string"
},
"provider_label": {
"type": "string"
},
"billing_channel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pricing_tier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"model_id",
"label",
"api_model_id",
"provider_id",
"provider_label",
"billing_channel",
"pricing_tier"
]
},
"summary": {
"type": "object",
"additionalProperties": false,
"properties": {
"identity": {
"$ref": "#/$defs/identity"
},
"price_status": {
"type": "string",
"enum": [
"current",
"expired",
"unreviewed"
]
},
"costing_supported": {
"type": "boolean"
},
"unsupported_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"max_input_tokens_per_request": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
{
"type": "null"
}
]
}
},
"required": [
"identity",
"price_status",
"costing_supported",
"unsupported_reason",
"max_input_tokens_per_request"
]
}
}
}🟢get_model_pricing(model_id)
Read recorded USD text-token prices, tariff identity, provenance and freshness for an exact offer ID. Expired or unreviewed prices are informational only.
Input Schema
{
"type": "object",
"properties": {
"model_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"model_id"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"properties": {
"ok": {
"const": true
},
"meta": {
"$ref": "#/$defs/meta"
},
"data": {
"type": "object",
"additionalProperties": false,
"properties": {
"pricing": {
"$ref": "#/$defs/pricing"
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/$defs/warning"
}
}
},
"required": [
"pricing",
"warnings"
]
}
},
"required": [
"ok",
"meta",
"data"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"ok": {
"const": false
},
"meta": {
"anyOf": [
{
"$ref": "#/$defs/meta"
},
{
"type": "null"
}
]
},
"error": {
"$ref": "#/$defs/error"
},
"errors": {
"type": "array",
"items": {
"$ref": "#/$defs/error"
},
"maxItems": 20
}
},
"required": [
"ok",
"meta",
"error",
"errors"
]
}
],
"$defs": {
"meta": {
"type": "object",
"additionalProperties": false,
"properties": {
"contract_version": {
"const": "1.0"
},
"dataset_revision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"dataset_updated_at": {
"type": "string"
},
"evaluated_at": {
"type": "string",
"format": "date-time"
}
},
"required": [
"contract_version",
"dataset_revision",
"dataset_updated_at",
"evaluated_at"
]
},
"warning": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
]
},
"error": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"INVALID_ARGUMENT",
"MODEL_NOT_FOUND",
"PRICE_UNREVIEWED",
"PRICE_EXPIRED",
"SCOPE_REQUIRED",
"SCOPE_EXCEEDED",
"UNSUPPORTED_TARIFF",
"UNSUPPORTED_CACHE",
"CATALOGUE_INCONSISTENT",
"INVALID_CURSOR",
"CURSOR_EXPIRED",
"DATASET_CHANGED",
"NO_COMPARABLE_MODELS",
"DATASET_UNAVAILABLE",
"INTERNAL_ERROR"
]
},
"message": {
"type": "string"
},
"field": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"model_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 200
},
{
"type": "null"
}
]
},
"resolution": {
"type": "string"
}
},
"required": [
"code",
"message",
"field",
"model_id",
"resolution"
]
},
"identity": {
"type": "object",
"additionalProperties": false,
"properties": {
"model_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"label": {
"type": "string"
},
"api_model_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provider_id": {
"type": "string"
},
"provider_label": {
"type": "string"
},
"billing_channel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pricing_tier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"model_id",
"label",
"api_model_id",
"provider_id",
"provider_label",
"billing_channel",
"pricing_tier"
]
},
"evidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"status": {
"type": "string",
"enum": [
"current",
"expired",
"unreviewed"
]
},
"checked_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"valid_until": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"source_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"scope": {
"type": "string"
}
},
"required": [
"status",
"checked_at",
"valid_until",
"source_urls",
"scope"
]
},
"rates": {
"type": "object",
"additionalProperties": false,
"properties": {
"input": {
"type": "number",
"minimum": 0
},
"cached_input": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"output": {
"type": "number",
"minimum": 0
}
},
"required": [
"input",
"cached_input",
"output"
]
},
"pricing": {
"type": "object",
"additionalProperties": false,
"properties": {
"identity": {
"$ref": "#/$defs/identity"
},
"currency": {
"const": "USD"
},
"rate_unit": {
"const": "per_1000000_tokens"
},
"rates": {
"$ref": "#/$defs/rates"
},
"cache_mode": {
"type": "string"
},
"evidence": {
"$ref": "#/$defs/evidence"
},
"costing_supported": {
"type": "boolean"
},
"unsupported_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"max_input_tokens_per_request": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
{
"type": "null"
}
]
}
},
"required": [
"identity",
"currency",
"rate_unit",
"rates",
"cache_mode",
"evidence",
"costing_supported",
"unsupported_reason",
"max_input_tokens_per_request"
]
}
}
}🟢calculate_cost(model_id, usage, expected_dataset_revision)
Estimate a USD text-token subtotal for one exact offer using current reviewed rates. Input includes cached input. Excludes cache writes, storage, tools and taxes. No model invocation.
Input Schema
{
"type": "object",
"properties": {
"model_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"usage": {
"type": "object",
"additionalProperties": false,
"properties": {
"input_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"output_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"cached_input_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000,
"default": 0
},
"max_input_tokens_per_request": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
}
},
"required": [
"input_tokens",
"output_tokens"
]
},
"expected_dataset_revision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"required": [
"model_id",
"usage"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"properties": {
"ok": {
"const": true
},
"meta": {
"$ref": "#/$defs/meta"
},
"data": {
"$ref": "#/$defs/calculation"
}
},
"required": [
"ok",
"meta",
"data"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"ok": {
"const": false
},
"meta": {
"anyOf": [
{
"$ref": "#/$defs/meta"
},
{
"type": "null"
}
]
},
"error": {
"$ref": "#/$defs/error"
},
"errors": {
"type": "array",
"items": {
"$ref": "#/$defs/error"
},
"maxItems": 20
}
},
"required": [
"ok",
"meta",
"error",
"errors"
]
}
],
"$defs": {
"meta": {
"type": "object",
"additionalProperties": false,
"properties": {
"contract_version": {
"const": "1.0"
},
"dataset_revision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"dataset_updated_at": {
"type": "string"
},
"evaluated_at": {
"type": "string",
"format": "date-time"
}
},
"required": [
"contract_version",
"dataset_revision",
"dataset_updated_at",
"evaluated_at"
]
},
"warning": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
]
},
"error": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"INVALID_ARGUMENT",
"MODEL_NOT_FOUND",
"PRICE_UNREVIEWED",
"PRICE_EXPIRED",
"SCOPE_REQUIRED",
"SCOPE_EXCEEDED",
"UNSUPPORTED_TARIFF",
"UNSUPPORTED_CACHE",
"CATALOGUE_INCONSISTENT",
"INVALID_CURSOR",
"CURSOR_EXPIRED",
"DATASET_CHANGED",
"NO_COMPARABLE_MODELS",
"DATASET_UNAVAILABLE",
"INTERNAL_ERROR"
]
},
"message": {
"type": "string"
},
"field": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"model_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 200
},
{
"type": "null"
}
]
},
"resolution": {
"type": "string"
}
},
"required": [
"code",
"message",
"field",
"model_id",
"resolution"
]
},
"identity": {
"type": "object",
"additionalProperties": false,
"properties": {
"model_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"label": {
"type": "string"
},
"api_model_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provider_id": {
"type": "string"
},
"provider_label": {
"type": "string"
},
"billing_channel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pricing_tier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"model_id",
"label",
"api_model_id",
"provider_id",
"provider_label",
"billing_channel",
"pricing_tier"
]
},
"evidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"status": {
"type": "string",
"enum": [
"current",
"expired",
"unreviewed"
]
},
"checked_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"valid_until": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"source_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"scope": {
"type": "string"
}
},
"required": [
"status",
"checked_at",
"valid_until",
"source_urls",
"scope"
]
},
"rates": {
"type": "object",
"additionalProperties": false,
"properties": {
"input": {
"type": "number",
"minimum": 0
},
"cached_input": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"output": {
"type": "number",
"minimum": 0
}
},
"required": [
"input",
"cached_input",
"output"
]
},
"pricing": {
"type": "object",
"additionalProperties": false,
"properties": {
"identity": {
"$ref": "#/$defs/identity"
},
"currency": {
"const": "USD"
},
"rate_unit": {
"const": "per_1000000_tokens"
},
"rates": {
"$ref": "#/$defs/rates"
},
"cache_mode": {
"type": "string"
},
"evidence": {
"$ref": "#/$defs/evidence"
},
"costing_supported": {
"type": "boolean"
},
"unsupported_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"max_input_tokens_per_request": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
{
"type": "null"
}
]
}
},
"required": [
"identity",
"currency",
"rate_unit",
"rates",
"cache_mode",
"evidence",
"costing_supported",
"unsupported_reason",
"max_input_tokens_per_request"
]
},
"usage": {
"type": "object",
"additionalProperties": false,
"properties": {
"input_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"output_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"cached_input_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"max_input_tokens_per_request": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
{
"type": "null"
}
]
}
},
"required": [
"input_tokens",
"output_tokens",
"cached_input_tokens",
"max_input_tokens_per_request"
]
},
"costs": {
"type": "object",
"additionalProperties": false,
"properties": {
"uncached_input_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
},
"cached_input_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
},
"input_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
},
"output_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
},
"total_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
}
},
"required": [
"uncached_input_usd",
"cached_input_usd",
"input_usd",
"output_usd",
"total_usd"
]
},
"calculation": {
"type": "object",
"additionalProperties": false,
"properties": {
"pricing": {
"$ref": "#/$defs/pricing"
},
"usage": {
"$ref": "#/$defs/usage"
},
"applied_rates": {
"$ref": "#/$defs/rates"
},
"costs": {
"$ref": "#/$defs/costs"
},
"estimate_type": {
"const": "text_token_subtotal"
},
"scope_check": {
"type": "string",
"enum": [
"within_reviewed_limit",
"no_structured_limit"
]
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/$defs/warning"
}
}
},
"required": [
"pricing",
"usage",
"applied_rates",
"costs",
"estimate_type",
"scope_check",
"warnings"
]
}
}
}🟢compare_model_costs(model_ids, usage, expected_dataset_revision)
Compare 2–20 exact offers for identical text-token counts using one pricing snapshot. Returns supported results plus per-offer exclusions. Equal token counts are an assumption, not tokenizer equivalence.
Input Schema
{
"type": "object",
"properties": {
"model_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"minItems": 2,
"maxItems": 20,
"uniqueItems": true
},
"usage": {
"type": "object",
"additionalProperties": false,
"properties": {
"input_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"output_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"cached_input_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000,
"default": 0
},
"max_input_tokens_per_request": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
}
},
"required": [
"input_tokens",
"output_tokens"
]
},
"expected_dataset_revision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"required": [
"model_ids",
"usage"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"properties": {
"ok": {
"const": true
},
"meta": {
"$ref": "#/$defs/meta"
},
"data": {
"type": "object",
"additionalProperties": false,
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/$defs/calculation"
},
"maxItems": 20
},
"errors": {
"type": "array",
"items": {
"$ref": "#/$defs/error"
},
"maxItems": 20
},
"partial": {
"type": "boolean"
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/$defs/warning"
}
}
},
"required": [
"results",
"errors",
"partial",
"warnings"
]
}
},
"required": [
"ok",
"meta",
"data"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"ok": {
"const": false
},
"meta": {
"anyOf": [
{
"$ref": "#/$defs/meta"
},
{
"type": "null"
}
]
},
"error": {
"$ref": "#/$defs/error"
},
"errors": {
"type": "array",
"items": {
"$ref": "#/$defs/error"
},
"maxItems": 20
}
},
"required": [
"ok",
"meta",
"error",
"errors"
]
}
],
"$defs": {
"meta": {
"type": "object",
"additionalProperties": false,
"properties": {
"contract_version": {
"const": "1.0"
},
"dataset_revision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"dataset_updated_at": {
"type": "string"
},
"evaluated_at": {
"type": "string",
"format": "date-time"
}
},
"required": [
"contract_version",
"dataset_revision",
"dataset_updated_at",
"evaluated_at"
]
},
"warning": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
]
},
"error": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"INVALID_ARGUMENT",
"MODEL_NOT_FOUND",
"PRICE_UNREVIEWED",
"PRICE_EXPIRED",
"SCOPE_REQUIRED",
"SCOPE_EXCEEDED",
"UNSUPPORTED_TARIFF",
"UNSUPPORTED_CACHE",
"CATALOGUE_INCONSISTENT",
"INVALID_CURSOR",
"CURSOR_EXPIRED",
"DATASET_CHANGED",
"NO_COMPARABLE_MODELS",
"DATASET_UNAVAILABLE",
"INTERNAL_ERROR"
]
},
"message": {
"type": "string"
},
"field": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"model_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 200
},
{
"type": "null"
}
]
},
"resolution": {
"type": "string"
}
},
"required": [
"code",
"message",
"field",
"model_id",
"resolution"
]
},
"identity": {
"type": "object",
"additionalProperties": false,
"properties": {
"model_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"label": {
"type": "string"
},
"api_model_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provider_id": {
"type": "string"
},
"provider_label": {
"type": "string"
},
"billing_channel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pricing_tier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"model_id",
"label",
"api_model_id",
"provider_id",
"provider_label",
"billing_channel",
"pricing_tier"
]
},
"evidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"status": {
"type": "string",
"enum": [
"current",
"expired",
"unreviewed"
]
},
"checked_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"valid_until": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"source_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"scope": {
"type": "string"
}
},
"required": [
"status",
"checked_at",
"valid_until",
"source_urls",
"scope"
]
},
"rates": {
"type": "object",
"additionalProperties": false,
"properties": {
"input": {
"type": "number",
"minimum": 0
},
"cached_input": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"output": {
"type": "number",
"minimum": 0
}
},
"required": [
"input",
"cached_input",
"output"
]
},
"pricing": {
"type": "object",
"additionalProperties": false,
"properties": {
"identity": {
"$ref": "#/$defs/identity"
},
"currency": {
"const": "USD"
},
"rate_unit": {
"const": "per_1000000_tokens"
},
"rates": {
"$ref": "#/$defs/rates"
},
"cache_mode": {
"type": "string"
},
"evidence": {
"$ref": "#/$defs/evidence"
},
"costing_supported": {
"type": "boolean"
},
"unsupported_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"max_input_tokens_per_request": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
{
"type": "null"
}
]
}
},
"required": [
"identity",
"currency",
"rate_unit",
"rates",
"cache_mode",
"evidence",
"costing_supported",
"unsupported_reason",
"max_input_tokens_per_request"
]
},
"usage": {
"type": "object",
"additionalProperties": false,
"properties": {
"input_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"output_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"cached_input_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"max_input_tokens_per_request": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
{
"type": "null"
}
]
}
},
"required": [
"input_tokens",
"output_tokens",
"cached_input_tokens",
"max_input_tokens_per_request"
]
},
"costs": {
"type": "object",
"additionalProperties": false,
"properties": {
"uncached_input_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
},
"cached_input_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
},
"input_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
},
"output_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
},
"total_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
}
},
"required": [
"uncached_input_usd",
"cached_input_usd",
"input_usd",
"output_usd",
"total_usd"
]
},
"calculation": {
"type": "object",
"additionalProperties": false,
"properties": {
"pricing": {
"$ref": "#/$defs/pricing"
},
"usage": {
"$ref": "#/$defs/usage"
},
"applied_rates": {
"$ref": "#/$defs/rates"
},
"costs": {
"$ref": "#/$defs/costs"
},
"estimate_type": {
"const": "text_token_subtotal"
},
"scope_check": {
"type": "string",
"enum": [
"within_reviewed_limit",
"no_structured_limit"
]
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/$defs/warning"
}
}
},
"required": [
"pricing",
"usage",
"applied_rates",
"costs",
"estimate_type",
"scope_check",
"warnings"
]
}
}
}🟢find_cheapest_models(usage, provider_id, pricing_tier, min_input_tokens_per_request, limit, ...)
Rank current reviewed offers by USD text-token subtotal for the supplied input/output/cache workload. Defaults to standard tariffs. Optional verified input-capacity filter is a pricing-scope limit, not full context size. No model-quality recommendation. Returns exclusion counts; discover exact IDs in results.
Input Schema
{
"type": "object",
"properties": {
"usage": {
"type": "object",
"additionalProperties": false,
"properties": {
"input_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"output_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"cached_input_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000,
"default": 0
},
"max_input_tokens_per_request": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
}
},
"required": [
"input_tokens",
"output_tokens"
]
},
"provider_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"pricing_tier": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"default": "standard"
},
"min_input_tokens_per_request": {
"type": "integer",
"minimum": 1,
"maximum": 1000000000000
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10
},
"expected_dataset_revision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"required": [
"usage"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"properties": {
"ok": {
"const": true
},
"meta": {
"$ref": "#/$defs/meta"
},
"data": {
"type": "object",
"additionalProperties": false,
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/$defs/calculation"
},
"maxItems": 20
},
"candidate_count": {
"type": "integer",
"minimum": 0
},
"eligible_count": {
"type": "integer",
"minimum": 0
},
"excluded": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"count": {
"type": "integer",
"minimum": 0
}
},
"required": [
"code",
"count"
]
}
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/$defs/warning"
}
}
},
"required": [
"results",
"candidate_count",
"eligible_count",
"excluded",
"warnings"
]
}
},
"required": [
"ok",
"meta",
"data"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"ok": {
"const": false
},
"meta": {
"anyOf": [
{
"$ref": "#/$defs/meta"
},
{
"type": "null"
}
]
},
"error": {
"$ref": "#/$defs/error"
},
"errors": {
"type": "array",
"items": {
"$ref": "#/$defs/error"
},
"maxItems": 20
}
},
"required": [
"ok",
"meta",
"error",
"errors"
]
}
],
"$defs": {
"meta": {
"type": "object",
"additionalProperties": false,
"properties": {
"contract_version": {
"const": "1.0"
},
"dataset_revision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"dataset_updated_at": {
"type": "string"
},
"evaluated_at": {
"type": "string",
"format": "date-time"
}
},
"required": [
"contract_version",
"dataset_revision",
"dataset_updated_at",
"evaluated_at"
]
},
"warning": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
]
},
"error": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"INVALID_ARGUMENT",
"MODEL_NOT_FOUND",
"PRICE_UNREVIEWED",
"PRICE_EXPIRED",
"SCOPE_REQUIRED",
"SCOPE_EXCEEDED",
"UNSUPPORTED_TARIFF",
"UNSUPPORTED_CACHE",
"CATALOGUE_INCONSISTENT",
"INVALID_CURSOR",
"CURSOR_EXPIRED",
"DATASET_CHANGED",
"NO_COMPARABLE_MODELS",
"DATASET_UNAVAILABLE",
"INTERNAL_ERROR"
]
},
"message": {
"type": "string"
},
"field": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"model_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 200
},
{
"type": "null"
}
]
},
"resolution": {
"type": "string"
}
},
"required": [
"code",
"message",
"field",
"model_id",
"resolution"
]
},
"identity": {
"type": "object",
"additionalProperties": false,
"properties": {
"model_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"label": {
"type": "string"
},
"api_model_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provider_id": {
"type": "string"
},
"provider_label": {
"type": "string"
},
"billing_channel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pricing_tier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"model_id",
"label",
"api_model_id",
"provider_id",
"provider_label",
"billing_channel",
"pricing_tier"
]
},
"evidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"status": {
"type": "string",
"enum": [
"current",
"expired",
"unreviewed"
]
},
"checked_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"valid_until": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"source_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"scope": {
"type": "string"
}
},
"required": [
"status",
"checked_at",
"valid_until",
"source_urls",
"scope"
]
},
"rates": {
"type": "object",
"additionalProperties": false,
"properties": {
"input": {
"type": "number",
"minimum": 0
},
"cached_input": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"output": {
"type": "number",
"minimum": 0
}
},
"required": [
"input",
"cached_input",
"output"
]
},
"pricing": {
"type": "object",
"additionalProperties": false,
"properties": {
"identity": {
"$ref": "#/$defs/identity"
},
"currency": {
"const": "USD"
},
"rate_unit": {
"const": "per_1000000_tokens"
},
"rates": {
"$ref": "#/$defs/rates"
},
"cache_mode": {
"type": "string"
},
"evidence": {
"$ref": "#/$defs/evidence"
},
"costing_supported": {
"type": "boolean"
},
"unsupported_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"max_input_tokens_per_request": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
{
"type": "null"
}
]
}
},
"required": [
"identity",
"currency",
"rate_unit",
"rates",
"cache_mode",
"evidence",
"costing_supported",
"unsupported_reason",
"max_input_tokens_per_request"
]
},
"usage": {
"type": "object",
"additionalProperties": false,
"properties": {
"input_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"output_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"cached_input_tokens": {
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
"max_input_tokens_per_request": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000000000000
},
{
"type": "null"
}
]
}
},
"required": [
"input_tokens",
"output_tokens",
"cached_input_tokens",
"max_input_tokens_per_request"
]
},
"costs": {
"type": "object",
"additionalProperties": false,
"properties": {
"uncached_input_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
},
"cached_input_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
},
"input_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
},
"output_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
},
"total_usd": {
"type": "string",
"pattern": "^\\d+\\.\\d{8}$"
}
},
"required": [
"uncached_input_usd",
"cached_input_usd",
"input_usd",
"output_usd",
"total_usd"
]
},
"calculation": {
"type": "object",
"additionalProperties": false,
"properties": {
"pricing": {
"$ref": "#/$defs/pricing"
},
"usage": {
"$ref": "#/$defs/usage"
},
"applied_rates": {
"$ref": "#/$defs/rates"
},
"costs": {
"$ref": "#/$defs/costs"
},
"estimate_type": {
"const": "text_token_subtotal"
},
"scope_check": {
"type": "string",
"enum": [
"within_reviewed_limit",
"no_structured_limit"
]
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/$defs/warning"
}
}
},
"required": [
"pricing",
"usage",
"applied_rates",
"costs",
"estimate_type",
"scope_check",
"warnings"
]
}
}
}🟢list_providers(provider_id, pricing_tier)
Summarize catalogue providers, distinct API model identities, tariff counts and current supported input/output rate ranges in USD per million tokens. Ranges are informational, not workload estimates or capability rankings.
Input Schema
{
"type": "object",
"properties": {
"provider_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"pricing_tier": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"default": "standard"
}
},
"required": [],
"additionalProperties": false
}Output Schema
{
"type": "object",
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"properties": {
"ok": {
"const": true
},
"meta": {
"$ref": "#/$defs/meta"
},
"data": {
"type": "object",
"additionalProperties": false,
"properties": {
"providers": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"provider_id": {
"type": "string"
},
"provider_label": {
"type": "string"
},
"model_count": {
"type": "integer",
"minimum": 0
},
"offer_count": {
"type": "integer",
"minimum": 0
},
"current_offers": {
"type": "integer",
"minimum": 0
},
"expired_offers": {
"type": "integer",
"minimum": 0
},
"unreviewed_offers": {
"type": "integer",
"minimum": 0
},
"costing_supported_offers": {
"type": "integer",
"minimum": 0
},
"input_rate_range": {
"anyOf": [
{
"type": "object",
"additionalProperties": false,
"properties": {
"min": {
"type": "number",
"minimum": 0
},
"max": {
"type": "number",
"minimum": 0
}
},
"required": [
"min",
"max"
]
},
{
"type": "null"
}
]
},
"output_rate_range": {
"anyOf": [
{
"type": "object",
"additionalProperties": false,
"properties": {
"min": {
"type": "number",
"minimum": 0
},
"max": {
"type": "number",
"minimum": 0
}
},
"required": [
"min",
"max"
]
},
{
"type": "null"
}
]
}
},
"required": [
"provider_id",
"provider_label",
"model_count",
"offer_count",
"current_offers",
"expired_offers",
"unreviewed_offers",
"costing_supported_offers",
"input_rate_range",
"output_rate_range"
]
}
},
"currency": {
"const": "USD"
},
"rate_unit": {
"const": "per_1000000_tokens"
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/$defs/warning"
}
}
},
"required": [
"providers",
"currency",
"rate_unit",
"warnings"
]
}
},
"required": [
"ok",
"meta",
"data"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"ok": {
"const": false
},
"meta": {
"anyOf": [
{
"$ref": "#/$defs/meta"
},
{
"type": "null"
}
]
},
"error": {
"$ref": "#/$defs/error"
},
"errors": {
"type": "array",
"items": {
"$ref": "#/$defs/error"
},
"maxItems": 20
}
},
"required": [
"ok",
"meta",
"error",
"errors"
]
}
],
"$defs": {
"meta": {
"type": "object",
"additionalProperties": false,
"properties": {
"contract_version": {
"const": "1.0"
},
"dataset_revision": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"dataset_updated_at": {
"type": "string"
},
"evaluated_at": {
"type": "string",
"format": "date-time"
}
},
"required": [
"contract_version",
"dataset_revision",
"dataset_updated_at",
"evaluated_at"
]
},
"warning": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
]
},
"error": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"INVALID_ARGUMENT",
"MODEL_NOT_FOUND",
"PRICE_UNREVIEWED",
"PRICE_EXPIRED",
"SCOPE_REQUIRED",
"SCOPE_EXCEEDED",
"UNSUPPORTED_TARIFF",
"UNSUPPORTED_CACHE",
"CATALOGUE_INCONSISTENT",
"INVALID_CURSOR",
"CURSOR_EXPIRED",
"DATASET_CHANGED",
"NO_COMPARABLE_MODELS",
"DATASET_UNAVAILABLE",
"INTERNAL_ERROR"
]
},
"message": {
"type": "string"
},
"field": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"model_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 200
},
{
"type": "null"
}
]
},
"resolution": {
"type": "string"
}
},
"required": [
"code",
"message",
"field",
"model_id",
"resolution"
]
}
}
}Community
Evidence
Recent observations
verifiedversion not recorded6 tools