# Tabela FIPE — how to use (mcp.ai)

Preço de referência de veículos no Brasil (Tabela FIPE), carros, motos e caminhões. Navegue por marca/modelo/ano, consulte o preço do mês corrente ou de qualquer mês desde ~2001, veja a curva de depreciação (histórico) e busque por nome de modelo. Índice próprio (atualizado mensalmente), API rápida; sem credencial, hospedado pela plataforma.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_fipe?ms=1781044320000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `fipe_anos`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/fipe`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/fipe/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/fipe/anos` — Lista os anos-modelo (com combustível) disponíveis para um modelo. Retorna [{ ano_modelo, combustivel }] (ex.: '2020-1' = 2020 gasolina). Use a tupla resultante em fipe_preco.
  - body: { tipo_veiculo: integer, codigo_marca: string, codigo_modelo: string }
- `POST https://api.mcp.ai/api/fipe/buscar` — Busca fuzzy por nome de modelo na Tabela FIPE (ex.: 'gol 1.6', 'civic touring'). Retorna candidatos [{ tipo_veiculo, codigo_marca, marca, codigo_modelo, modelo, codigo_fipe? }] para então consultar fi
  - body: { q: string, tipo_veiculo?: integer }
- `POST https://api.mcp.ai/api/fipe/historico` — Série temporal de preços de um veículo ao longo dos meses de referência (a CURVA DE DEPRECIAÇÃO — o diferencial vs. consultar o site). Retorna [{ referencia, mes, valor }] do mais antigo ao mais recen
  - body: { codigo_fipe: string, ano_modelo: string, combustivel?: string }
- `POST https://api.mcp.ai/api/fipe/marcas` — Lista as marcas de um tipo de veículo (1=carro, 2=moto, 3=caminhão). Retorna [{ codigo_marca, marca }]. Primeiro passo do drill-down até o preço.
  - body: { tipo_veiculo: integer }
- `POST https://api.mcp.ai/api/fipe/modelos` — Lista os modelos de uma marca. Retorna [{ codigo_modelo, modelo }]. Use o codigo_marca obtido em fipe_marcas.
  - body: { tipo_veiculo: integer, codigo_marca: string }
- `POST https://api.mcp.ai/api/fipe/preco` — Preço de referência FIPE de um veículo. Identifique de DUAS formas: por `codigo_fipe` (o código FIPE do veículo, ex.: '004278-1') OU pela tupla (tipo_veiculo, codigo_marca, codigo_modelo, ano_modelo, 
  - body: { codigo_fipe?: string, tipo_veiculo?: integer, codigo_marca?: string, codigo_modelo?: string, ano_modelo?: string, combustivel?: string, referencia?: string }
- `POST https://api.mcp.ai/api/fipe/tabelas/referencia` — Lista os meses de referência da Tabela FIPE disponíveis no índice (~2001→hoje). Retorna [{ codigo, mes, is_current }]. Use o `codigo` como `referencia` em fipe_preco/fipe_historico para consultar um m

## Example prompts
- "Qual o preço FIPE de um Gol 1.6 2020?"
- "Mostre a curva de depreciação do Civic 2018 nos últimos meses"
- "Quanto vale hoje a moto com código FIPE 811049-2?"

## More
- Page: https://mcp.ai/fipe
- Agent spec (llms.txt): https://mcp.ai/fipe/llms.txt
- Postman collection: https://mcp.ai/fipe/postman.json