PegaRex
Search 1.8M+ live Brazilian used-car and motorcycle listings, with FIPE reference prices.
Should I use this
Quality & Safety
Findings (10)
- HIGH
- MEDIUMin get_avg_days_to_sell
- LOWin get_listing_details
- LOWin get_avg_days_to_sell
- LOWin get_cheapest_states
- LOWin get_market_position
- LOWin get_price_distribution
- LOWin get_fipe_valuation
- LOWin get_mileage_context
- INFOin get_avg_days_to_sell
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://pegarex.com.br/api/mcp"
}
}
}Remote endpoints
https://pegarex.com.br/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (17)
🟢search_vehicles(query, brand, model, version, brand_id, ...)
Search 1.8M+ Brazilian vehicle listings aggregated from 96 platforms (OLX, Webmotors, Napista, etc.). Returns listings with price, year, mileage, location, source platform, the original ad URL, FIPE reference price and a deal_score (% vs FIPE; negative means priced below FIPE). Tips for best results: - Free-text `query` matches the listing TITLE only (e.g. "Onix LTZ turbo"). - For exact brand/model/version filtering, resolve names to ids first with list_brands / list_models / list_versions and pass brand_id/model_id/ version_id — it is faster and more accurate than the text fields. - `location` is a 2-letter UF (e.g. "SP") or a city name. - `sort_by="newest"` (default) lists the most recently LISTED cars first — the date a listing first appeared on its source, not when we last saw it. - `sort_by="best_deal"` ranks by lowest price-to-FIPE ratio. - `per_page` is capped at 50. Use `page` (1-20) to paginate; past the first 20 pages, narrow the search with filters. `total_count` and `total_pages` are returned.
Input Schema
{
"type": "object",
"properties": {
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Query"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Brand"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Model"
},
"version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Version"
},
"brand_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Brand Id"
},
"model_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Model Id"
},
"version_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Version Id"
},
"body_style": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Body Style"
},
"price_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Min"
},
"price_max": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Max"
},
"year_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year Min"
},
"year_max": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year Max"
},
"mileage_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Mileage Min"
},
"mileage_max": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Mileage Max"
},
"fuel_type": {
"anyOf": [
{
"enum": [
"Flex",
"Gasolina",
"Diesel",
"Álcool",
"GNV",
"Elétrico",
"Híbrido"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Fuel Type"
},
"transmission": {
"anyOf": [
{
"enum": [
"Automático",
"Manual",
"CVT",
"Automatizada",
"Semi-Automático"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Transmission"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source"
},
"category": {
"default": "Cars",
"enum": [
"Cars",
"Motorcycles"
],
"title": "Category",
"type": "string"
},
"sort_by": {
"default": "newest",
"enum": [
"newest",
"price_asc",
"price_desc",
"year_desc",
"mileage_asc",
"best_deal"
],
"title": "Sort By",
"type": "string"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
},
"per_page": {
"default": 24,
"title": "Per Page",
"type": "integer"
}
},
"title": "search_vehiclesArguments"
}🟢get_vehicle_by_id(car_id)
Fetch the full details of a single listing by its PegaRex id: brand, model, version, year, price, mileage, fuel, transmission, city/state, FIPE price, deal_score, source platform and the original ad URL.
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"title": "Car Id",
"type": "integer"
}
},
"required": [
"car_id"
],
"title": "get_vehicle_by_idArguments"
}🟢get_market_stats
Live size of the PegaRex database: total active listings, number of source platforms, and when the data was last refreshed. Use this for the current count instead of quoting a fixed number.
Input Schema
{
"type": "object",
"properties": {},
"title": "get_market_statsArguments"
}🟢list_brands(category, body_style)
List available vehicle brands (makes) with their catalog id and active listing count. Pass a brand's id as `brand_id` to search_vehicles/list_models for fast, exact filtering.
Input Schema
{
"type": "object",
"properties": {
"category": {
"default": "Cars",
"enum": [
"Cars",
"Motorcycles"
],
"title": "Category",
"type": "string"
},
"body_style": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Body Style"
}
},
"title": "list_brandsArguments"
}🟢list_models(brand_id, brand, category)
List models for a brand (pass brand_id from list_brands, or a brand name) with each model's catalog id and active listing count.
Input Schema
{
"type": "object",
"properties": {
"brand_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Brand Id"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Brand"
},
"category": {
"default": "Cars",
"enum": [
"Cars",
"Motorcycles"
],
"title": "Category",
"type": "string"
}
},
"title": "list_modelsArguments"
}🟢list_versions(model_id, brand, model, category, year_min, ...)
List versions/trims for a model (pass model_id from list_models, or brand+model names) with each version's catalog id and active listing count.
Input Schema
{
"type": "object",
"properties": {
"model_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Model Id"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Brand"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Model"
},
"category": {
"default": "Cars",
"enum": [
"Cars",
"Motorcycles"
],
"title": "Category",
"type": "string"
},
"year_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year Min"
},
"year_max": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year Max"
}
},
"title": "list_versionsArguments"
}🟢list_filter_options
Return the valid values for the constrained search filters — fuel_type, transmission, sort_by — and the list of source platforms. Use this to build a valid call to search_vehicles in a single round-trip.
Input Schema
{
"type": "object",
"properties": {},
"title": "list_filter_optionsArguments"
}🟢get_listing_details(car_id)
Fatos do próprio anúncio (cor, portas, opcionais, vendedor, fonte, km, link). Use para perguntas diretas sobre este carro específico.
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"title": "Car Id",
"type": "integer"
}
},
"required": [
"car_id"
],
"title": "get_listing_detailsArguments"
}🟢get_technical_specs(car_id, section)
Ficha técnica completa (motor, potência, torque, câmbio, consumo, desempenho, dimensões, freios, pneus). `section` opcional restringe a uma seção: 'Motor', 'Transmissão', 'Consumo', 'Desempenho', 'Dimensões', 'Freios', 'Pneus', 'Suspensão'.
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"title": "Car Id",
"type": "integer"
},
"section": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Section"
}
},
"required": [
"car_id"
],
"title": "get_technical_specsArguments"
}🟢get_avg_days_to_sell(car_id, granularity)
Tempo médio (mediana) que anúncios semelhantes ficam ativos antes de sair do ar — estimativa de liquidez/tempo de venda. 'model_year' (padrão) = mesmo modelo e ano; 'model' = todos os anos; 'model_state' = neste estado.
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"title": "Car Id",
"type": "integer"
},
"granularity": {
"default": "model_year",
"enum": [
"model",
"model_year",
"model_state"
],
"title": "Granularity",
"type": "string"
}
},
"required": [
"car_id"
],
"title": "get_avg_days_to_sellArguments"
}🟢get_cheapest_states(car_id, top_n)
Estados (UF) onde este modelo está mais barato agora, por preço mediano crescente. Use para 'onde é mais barato comprar'. (top_n padrão 5, máx 10.)
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"title": "Car Id",
"type": "integer"
},
"top_n": {
"default": 5,
"title": "Top N",
"type": "integer"
}
},
"required": [
"car_id"
],
"title": "get_cheapest_statesArguments"
}🟢get_market_position(car_id)
Posição de preço DESTE anúncio: vs. tabela FIPE e vs. o mercado de anúncios ativos do mesmo modelo. Use para 'esse preço é bom?' / 'está caro ou barato?'.
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"title": "Car Id",
"type": "integer"
}
},
"required": [
"car_id"
],
"title": "get_market_positionArguments"
}🟢get_price_distribution(car_id, year_tolerance)
Faixa de preços (mínimo, p25, mediana, p75, máximo) de anúncios ativos semelhantes. Use para dar contexto de preço. (year_tolerance ±anos, padrão 1, máx 5.)
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"title": "Car Id",
"type": "integer"
},
"year_tolerance": {
"default": 1,
"title": "Year Tolerance",
"type": "integer"
}
},
"required": [
"car_id"
],
"title": "get_price_distributionArguments"
}🟢get_similar_active_listings(car_id, max_results, cheaper_only)
Outras unidades à venda do MESMO modelo (mesmo carro, outros anúncios) — ex.: mais baratas, outras cores/anos. Use para 'tem opções mais baratas DESTE carro?'. NÃO use para sugerir modelos diferentes. (max_results padrão 5, máx 8; cheaper_only=true só mais baratos que este.)
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"title": "Car Id",
"type": "integer"
},
"max_results": {
"default": 5,
"title": "Max Results",
"type": "integer"
},
"cheaper_only": {
"default": false,
"title": "Cheaper Only",
"type": "boolean"
}
},
"required": [
"car_id"
],
"title": "get_similar_active_listingsArguments"
}🟢get_alternative_models(car_id, max_results)
Sugere OUTROS MODELOS diferentes (outras marcas/modelos) na mesma categoria, faixa de preço e tipo de carroceria — alternativas de compra. Use para 'recomende outros modelos' / 'alternativas a este carro'. (max_results padrão 4, máx 6.)
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"title": "Car Id",
"type": "integer"
},
"max_results": {
"default": 4,
"title": "Max Results",
"type": "integer"
}
},
"required": [
"car_id"
],
"title": "get_alternative_modelsArguments"
}🟢get_fipe_valuation(car_id)
Valor oficial da tabela FIPE deste carro e tendência recente. Use para perguntas sobre a FIPE.
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"title": "Car Id",
"type": "integer"
}
},
"required": [
"car_id"
],
"title": "get_fipe_valuationArguments"
}🟢get_mileage_context(car_id)
Avalia se a quilometragem deste carro é alta ou baixa para o modelo/ano (mediana do mercado + km/ano).
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"title": "Car Id",
"type": "integer"
}
},
"required": [
"car_id"
],
"title": "get_mileage_contextArguments"
}Community
Evidence