---
name: placaefipe
description: Integra e usa a API Placa & FIPE (consulta de veículo brasileiro pela placa com valor da Tabela FIPE). Use quando o usuário pedir consulta de placa, puxar dados do veículo pela placa, valor FIPE pela placa, autopreencher cadastro de veículo, ou integrar API de placa/FIPE em sistema de oficina, loja, seguro, frota ou SaaS.
---

# Placa & FIPE

API REST brasileira: placa → dados do veículo + valor FIPE do mês.

- Endpoint: `GET https://api.placaefipe.com.br/v1/placas/{placa}` (placa ABC1234 ou ABC1D23)
- Saldo (grátis): `GET https://api.placaefipe.com.br/v1/saldo`
- Auth: `Authorization: Bearer $PLACAEFIPE_API_KEY` (chave `pf_live_...`)
- MCP remoto: `https://api.placaefipe.com.br/mcp` (ferramentas `consultar_placa`, `consultar_saldo`)

## Regras

1. Chave só no servidor, lida de `PLACAEFIPE_API_KEY`. Nunca no front, no git ou em logs.
2. 1 crédito por placa encontrada. Para desenvolver e testar, use uma chave de teste `pf_test_...` (dados de exemplo, grátis; `AAA0000` simula 404). Confira a chave com `/v1/saldo`.
3. Todo campo pode ser `null`, exceto `placa` e `consulta`.
4. FIPE: `fipe.valor` + `fipe.referencia`; se `valor` for null e `fipe.versoes` tiver itens, o usuário escolhe a versão.
5. Erros por `erro.codigo`: `placa_invalida` (400), `nao_autenticado`/`chave_invalida` (401), `sem_creditos` (402), `placa_nao_encontrada` (404, não cobra), `limite_excedido` (429), `indisponivel` (503, repetir com espera).
6. Não há dados do proprietário (LGPD).

## Campos da resposta

`placa, placa_antiga, marca, modelo, versao, ano_fabricacao, ano_modelo, cor, combustivel, chassi_final, municipio, uf, situacao, origem, tecnico{motor, tipo, especie, segmento, cilindradas, passageiros, eixos}, fipe{codigo, marca, modelo, ano_modelo, combustivel, valor, valor_texto, referencia, versoes[]}, consulta{id, creditos_restantes, cobrada, cache}`

## Como integrar

Siga o guia completo: https://placaefipe.com.br/guia-ia.md
Exemplos por linguagem: https://placaefipe.com.br/docs/exemplos.md