FIPE MCP
Get Brazilian vehicle prices from the FIPE table. Search cars, motorcycles and trucks by brand, model, year, FIPE code or license plate, and see the price history.
Hosted MCP Server
npx add-mcp 'https://mcp.fipe.api.br/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
Com o servidor MCP da FIPE API, você consulta a tabela FIPE em linguagem natural, no assistente de IA que já usa para programar. Você escreve a pergunta, o assistente consulta a API e mostra a resposta na conversa. Você não escreve requisições HTTP nem procura códigos de marca e modelo.
O Model Context Protocol (MCP) é o padrão que liga assistentes de IA a serviços externos. Claude Code, Cursor e VS Code têm suporte ao protocolo.

Consulta por placa no Claude Code. O assistente consultou a FIPE API e montou a tabela com a resposta.
O que você pode perguntar
- "Qual é o preço FIPE de um Honda Civic EXL 2020?"
- "Consulte a placa ABC1D23."
- "Mostre o histórico de preços desse modelo."
- "Quanto esse carro valia em junho de 2026?"
- "Compare o preço do Onix e do HB20, os dois de 2023."
- "Liste os modelos de motos da Yamaha."
O servidor responde a consultas sobre carros, motos e caminhões:
- Preço FIPE de um veículo, por marca, modelo e ano.
- Preço por código FIPE, quando você já tem o código.
- Consulta por placa, com os dados do veículo e o preço FIPE.
- Histórico de preços de um veículo, mês a mês.
- Meses anteriores, para saber o valor de um veículo em outra data.
- Listas de marcas, modelos e anos disponíveis.
Antes de começar
Você precisa de uma conta em fipe.api.br. O cadastro é gratuito.
O endereço do servidor é o mesmo em todos os clientes:
Codehttps://mcp.fipe.api.br/mcp
Conectar o servidor
Claude Code
- Execute o comando abaixo no terminal:
Codeclaude mcp add --transport http fipe https://mcp.fipe.api.br/mcp - Abra o Claude Code e execute o comando
/mcp. - Selecione o servidor
fipee inicie a autenticação. O navegador abre a página da FIPE API. - Entre com a sua conta e selecione Autorizar.
Cursor
- Abra o arquivo
~/.cursor/mcp.json. Para configurar um só projeto, use.cursor/mcp.jsonna raiz do projeto. - Adicione o servidor:
Code{ "mcpServers": { "fipe": { "url": "https://mcp.fipe.api.br/mcp" } } } - Quando o Cursor abrir o navegador, entre com a sua conta e selecione Autorizar.
VS Code
- Crie o arquivo
.vscode/mcp.jsonna raiz do projeto:Code{ "servers": { "fipe": { "type": "http", "url": "https://mcp.fipe.api.br/mcp" } } } - Inicie o servidor
fipeno VS Code. - Quando o VS Code abrir o navegador, entre com a sua conta e selecione Autorizar.
Outros clientes
Use o mesmo endereço em qualquer cliente com suporte a servidores MCP remotos. Na primeira conexão, o cliente abre o login no navegador.
Primeira consulta
- Escreva a pergunta na conversa. Exemplo: "Qual é o preço FIPE de um Honda Civic EXL 2020?"
- Se o cliente pedir a sua confirmação para usar o servidor
fipe, confirme. - Leia a resposta. Os preços são do mês de referência mais recente da tabela FIPE.
A conversa mantém o contexto. Depois da primeira resposta, você pode pedir o histórico de preços ou uma comparação com outro modelo, sem repetir os dados do veículo.
Para respostas mais precisas, informe a versão, o ano e o combustível do veículo. Se você sabe o código FIPE, informe o código: a consulta é mais rápida e usa menos requisições do seu plano.
Consulta por placa
Informe a placa na pergunta, no formato antigo (ABC1234) ou no formato Mercosul (ABC1D23). A resposta traz marca, modelo, ano, cor, combustível, cidade, UF, código FIPE e preço FIPE, como na imagem no início desta página.
A consulta por placa está em fase Alpha e pode mudar.
Limites e planos
As consultas pelo assistente usam os limites do plano da sua conta. Uma pergunta pode usar mais de uma requisição. Por exemplo, a consulta por marca, modelo e ano usa quatro.
| Recurso | Token gratuito | Premium |
|---|---|---|
| Requisições | 1.000 por dia (24h) | Ilimitado |
| Histórico de preços | Últimos 3 meses | 1 ano |
| Consulta por placa (Alpha) | 10 consultas com sucesso por mês | 500 consultas com sucesso por mês |
Os planos estão em fipe.api.br.
Conectar sem login no navegador
Se o seu cliente não abre o login no navegador, conecte com o token da sua conta. É o mesmo token das requisições da API.
Codeclaude mcp add --transport http fipe https://mcp.fipe.api.br/mcp \
--header "X-Subscription-Token: SEU_TOKEN"
Em outros clientes, adicione o header X-Subscription-Token na configuração do servidor.
Não versione arquivos de configuração que contêm o seu token. Se o arquivo fica no repositório do projeto, use o login.
Problemas comuns
O assistente não consulta a FIPE
Confira se o servidor está conectado. No Claude Code, o comando /mcp mostra o estado do servidor fipe. Na pergunta, cite a tabela FIPE ou o preço FIPE.
O cliente pede o login de novo
A autorização expirou. Faça a autenticação outra vez. No Claude Code, execute /mcp e selecione fipe.
Limite de requisições atingido
Você atingiu o limite do plano. O limite diário reinicia a cada 24 horas. A cota de consulta por placa reinicia a cada mês.
Veículo ou placa não encontrados
Confira a placa. Para consultas por modelo, informe mais detalhes: versão, ano e combustível.
Próximos passos
- Casos de uso práticos: aplicações da API em avaliação, comparação e financiamento de veículos.
- Consultando a API: as mesmas consultas por requisição HTTP.
- Referência da API: especificação completa de endpoints, parâmetros e schemas.
Last modified on