Servidor MCP
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:
Code
Conectar o servidor
Claude Code
-
Execute o comando abaixo no terminal:
Code -
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 -
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 -
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.
Code
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.