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.

Claude Code mostra o resultado de uma consulta por placa feita pelo servidor MCP da FIPE API, com marca, modelo, ano, cor, cidade, código FIPE e preço FIPE

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

  1. Execute o comando abaixo no terminal:
    Codeclaude mcp add --transport http fipe https://mcp.fipe.api.br/mcp
    
  2. Abra o Claude Code e execute o comando /mcp.
  3. Selecione o servidor fipe e inicie a autenticação. O navegador abre a página da FIPE API.
  4. Entre com a sua conta e selecione Autorizar.

Cursor

  1. Abra o arquivo ~/.cursor/mcp.json. Para configurar um só projeto, use .cursor/mcp.json na raiz do projeto.
  2. Adicione o servidor:
    Code{
      "mcpServers": {
        "fipe": {
          "url": "https://mcp.fipe.api.br/mcp"
        }
      }
    }
    
  3. Quando o Cursor abrir o navegador, entre com a sua conta e selecione Autorizar.

VS Code

  1. Crie o arquivo .vscode/mcp.json na raiz do projeto:
    Code{
      "servers": {
        "fipe": {
          "type": "http",
          "url": "https://mcp.fipe.api.br/mcp"
        }
      }
    }
    
  2. Inicie o servidor fipe no VS Code.
  3. 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

  1. Escreva a pergunta na conversa. Exemplo: "Qual é o preço FIPE de um Honda Civic EXL 2020?"
  2. Se o cliente pedir a sua confirmação para usar o servidor fipe, confirme.
  3. 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.

RecursoToken gratuitoPremium
Requisições1.000 por dia (24h)Ilimitado
Histórico de preçosÚltimos 3 meses1 ano
Consulta por placa (Alpha)10 consultas com sucesso por mês500 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

Last modified on