@altis-tech/fipe-mcp
v0.1.0
Published
Servidor MCP da Altis FIPE API — dá a agentes de IA (Cursor, Claude) acesso à Tabela FIPE como ferramentas.
Maintainers
Readme
@altis-tech/fipe-mcp
Servidor MCP (Model Context Protocol) da Altis FIPE API. Dá a qualquer agente de IA (Cursor, Claude Desktop, etc.) acesso à Tabela FIPE como ferramentas nativas — o modelo consulta marcas, modelos, anos e preços sozinho.
Pré-requisito
Uma chave fpk_live_.... Crie a conta em https://fipe.altis.online/cadastro (1.000 créditos grátis).
Instalação rápida (sem instalar nada)
O servidor roda via npx. Basta apontar seu cliente MCP para ele.
Cursor
~/.cursor/mcp.json (ou Settings → MCP):
{
"mcpServers": {
"altis-fipe": {
"command": "npx",
"args": ["-y", "@altis-tech/fipe-mcp"],
"env": { "ALTIS_FIPE_KEY": "fpk_live_xxxxxxxxxxxx" }
}
}
}Claude Desktop
claude_desktop_config.json:
{
"mcpServers": {
"altis-fipe": {
"command": "npx",
"args": ["-y", "@altis-tech/fipe-mcp"],
"env": { "ALTIS_FIPE_KEY": "fpk_live_xxxxxxxxxxxx" }
}
}
}Reinicie o cliente. Pronto — agora você pode pedir em linguagem natural:
"Qual o preço FIPE de um Corolla Híbrido 2025?"
O agente chamará as ferramentas fipe_list_brands → fipe_list_models → fipe_list_years → fipe_get_quote automaticamente.
Ferramentas expostas
| Ferramenta | Descrição | Créditos |
| --- | --- | --- |
| fipe_references | Meses de referência | 0 |
| fipe_list_brands | Marcas de um tipo de veículo | 0 |
| fipe_list_models | Modelos de uma marca | 1 |
| fipe_list_years | Anos/combustíveis de um modelo | 1 |
| fipe_get_quote | Preço FIPE (consulta-mãe) | 2 |
Variáveis de ambiente
| Variável | Obrigatória | Descrição |
| --- | --- | --- |
| ALTIS_FIPE_KEY | sim | Chave fpk_live_... |
| ALTIS_FIPE_BASE_URL | não | Sobrescreve a base da API |
Licença
Proprietária — Altis 2026.
