API Reference

REST API and MCP server for querying models, providers, and capabilities

RESThttps://api.modelpedia.dev/v1

MCPhttps://api.modelpedia.dev/mcp

FormatJSON (append ?pretty for formatted output)

MCP Setup

claude mcp add modelpedia --transport http https://api.modelpedia.dev/mcp

Overview

GET/v1/statsRegistry statistics: provider, model, family, creator counts.

GET/v1/searchUnified search across providers and models.

qSearch query (min 2 chars, required)

limitMax model results (default 20, max 50)

Providers

GET/v1/providersAll providers with model counts.

GET/v1/providers/:idSingle provider with full details and models.

GET/v1/providers/compareCompare 2-10 providers side by side: model counts, price ranges, capabilities.

idsComma-separated provider IDs (2-10, required)

Models

GET/v1/modelsList models. Filterable, sortable, paginated.

providerFilter by provider id

familyFilter by model family

creatorFilter by original creator

statusactive | deprecated | preview

qSearch across id, name, description

sortname | context_window | price_input | price_output

orderasc (default) | desc

limitMax 500, default 100

offsetDefault 0

GET/v1/models/:provider/:idSingle model details. Supports / in IDs.

GET/v1/models/compareCompare up to 10 models side by side.

idsComma-separated provider/model IDs (2-10, required)

GET/v1/models/latestRecently updated models, sorted by last_updated descending.

limitMax 500, default 100

offsetDefault 0

GET/v1/models/recommendRecommend models matching requirements. Returns non-deprecated models sorted by price.

capabilityRequired capabilities, comma-separated

min_context_windowMinimum context window in tokens

max_price_inputMax input price (USD per 1M tokens)

input_modalityRequired input: text | image | audio | video

output_modalityRequired output: text | image | audio | video

limitMax 500, default 100

offsetDefault 0

GET/v1/models/typesModel types with counts and provider coverage.

Taxonomy

GET/v1/familiesModel families with counts and metadata.

GET/v1/capabilitiesAll capabilities with model and provider counts.

GET/v1/creatorsModel creators with counts, providers, and families.

GET/v1/modalitiesInput/output modality combinations with model counts.

GET/v1/toolsTools and integrations (function_calling, web_search, mcp, ...) with adoption counts.

Pricing

GET/v1/pricing/compareCompare pricing across models. Filter by price range, sort by cheapest.

idsComma-separated provider/model IDs (optional, compares all if omitted)

min_price_inputMin input price (USD per 1M tokens)

max_price_inputMax input price (USD per 1M tokens)

sortprice_input (default) | price_output

orderasc (default) | desc

limitMax 500, default 100

offsetDefault 0

Response format

Success{ "data": ..., "meta": { "total", "limit", "offset" } }

Error{ "error": { "message", "status" } }

Conventions

Field presentKnown value

Field omittedUnknown

Field is nullNot applicable

pricing.*USD per 1M tokens

context_windowToken count

capabilities.*Boolean flags (true = supported)

modalities.*Array of: "text", "image", "audio", "video"

performance / speed1-5 scale

status"active" | "deprecated" | "preview"

Notes

AuthNone required

CORSEnabled on all endpoints

Rate limit60 requests per minute per IP (REST API only)