br.com.pegarex/mcp

PegaRex

Search 1.8M+ live Brazilian used-car and motorcycle listings, with FIPE reference prices.

1.0.0
Version
remote
Transport
17
Tools

Security review

Review passed

Reviewed 1d ago.

  • tools: 17 tools scanned
  • metadata: scanned

No findings.

Tools (17)

  • search_vehicles

    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"). It needs at least one word of 3+ characters: "Ford Ka", not "Ka" alone. - 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

  • get_vehicle_by_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.

  • 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.

  • list_brands

    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.

  • list_models

    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.

  • list_versions

    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.

  • 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.

  • get_listing_details

    Fatos do próprio anúncio (cor, portas, opcionais, vendedor, fonte, km, link). Use para perguntas diretas sobre este carro específico.

  • get_technical_specs

    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'.

  • get_avg_days_to_sell

    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.

  • get_cheapest_states

    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.)

  • get_market_position

    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?'.

  • get_price_distribution

    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.)

  • get_similar_active_listings

    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.)

  • get_alternative_models

    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.)

  • get_fipe_valuation

    Valor oficial da tabela FIPE deste carro e tendência recente. Use para perguntas sobre a FIPE. `fipe_year` é o ano FIPE usado; 32000 é como a FIPE escreve "0 km" (carro novo) — mostre `fipe_year_label` ("0 km"), nunca "32000".

  • get_mileage_context

    Avalia se a quilometragem deste carro é alta ou baixa para o modelo/ano (mediana do mercado + km/ano).