fipeX MCP
Brazilian FIPE vehicle reference prices: search, current price, history and comparison. Keyless.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mcp": {
"url": "https://api.fipex.com.br/mcp"
}
}
}Remote endpoints
https://api.fipex.com.br/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
⚪compare_prices(vehicle_specs)
Compare the latest FIPE price and history of up to 10 vehicles side by side. Each spec is "model-slug,fuel-slug,year"; separate specs with semicolons.
Input Schema
{
"type": "object",
"properties": {
"vehicle_specs": {
"type": "string",
"description": "up to 10 vehicles, each \"model-slug,fuel-slug,year\", separated by semicolons (e.g. \"argo,flex,2022;onix,flex,2022\")"
}
},
"required": [
"vehicle_specs"
],
"additionalProperties": false
}🟢get_price(model_slug, fuel_acronym, model_id, fuel_id, year)
Get the latest FIPE price for one vehicle, identified by model_slug + fuel_acronym + year, or by model_id + fuel_id + year. Year is "2022" (a model year) or "zero" (0 km / brand new).
Input Schema
{
"type": "object",
"properties": {
"model_slug": {
"type": "string",
"description": "model slug, e.g. \"argo\" (pair with fuel_acronym)"
},
"fuel_acronym": {
"type": "string",
"description": "single-letter fuel acronym, e.g. \"g\" gasoline, \"e\" ethanol, \"f\" flex, \"d\" diesel"
},
"model_id": {
"type": "string",
"description": "model UUID (alternative to model_slug)"
},
"fuel_id": {
"type": "string",
"description": "fuel UUID (alternative to fuel_acronym)"
},
"year": {
"type": "string",
"description": "model year like \"2022\", or \"zero\" for 0 km / brand new"
}
},
"required": [
"year"
],
"additionalProperties": false
}🟢get_price_history(model_id, fuel_id, year)
Get the monthly FIPE price history for one vehicle, identified by model_id + fuel_id + year. Year is "2022" (a model year) or "zero" (0 km / brand new).
Input Schema
{
"type": "object",
"properties": {
"model_id": {
"type": "string",
"description": "model UUID (from search_vehicles)"
},
"fuel_id": {
"type": "string",
"description": "fuel UUID (from search_vehicles)"
},
"year": {
"type": "string",
"description": "model year like \"2022\", or \"zero\" for 0 km / brand new"
}
},
"required": [
"model_id",
"fuel_id",
"year"
],
"additionalProperties": false
}🟢search_vehicles(query, page, limit, year_min, year_max, ...)
Search Brazilian FIPE vehicles by free-text query (make, model, year, fuel). Returns matching vehicles with their slugs and IDs — the entry point that resolves names into the identifiers get_price, get_price_history and compare_prices need.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "free-text search over make, model, year and fuel (e.g. \"fiat argo 2022 flex\"). Make names in the query are hard-filtered automatically"
},
"page": {
"type": "integer",
"description": "1-based page number, defaults to 1"
},
"limit": {
"type": "integer",
"description": "results per page, 1-50, defaults to 10"
},
"year_min": {
"type": "integer",
"description": "minimum model year, inclusive (e.g. 2006). 0 km vehicles have no year and are excluded by year filters; search them with 'zero km' in the query"
},
"year_max": {
"type": "integer",
"description": "maximum model year, inclusive"
},
"price_min": {
"type": "number",
"description": "minimum current price in BRL (reais), inclusive (e.g. 50000)"
},
"price_max": {
"type": "number",
"description": "maximum current price in BRL (reais), inclusive (e.g. 78000)"
},
"vehicle_type": {
"type": "string",
"description": "filter by vehicle type: carro, moto or caminhao"
}
},
"required": [
"query"
],
"additionalProperties": false
}Community
Evidence