Bem-vindo à Fipe API! Crie uma conta para obter um token de acesso ilimitado à API.
FipeAPI Logo
Documentação

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.

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:

Code
https://mcp.fipe.api.br/mcp

Conectar o servidor

Claude Code

  1. Execute o comando abaixo no terminal:

    TerminalCode
    claude 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:

    JSONCode
    { "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:

    JSONCode
    { "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.

TerminalCode
claude 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