CarHunt

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

French used-car search across LeBonCoin, LaCentrale, L'Argus and more, with price estimates.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "CarHunt": {
      "url": "https://api.carhunt.fr/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• search_used_cars read-only

  Search used cars for sale in France across all major marketplaces. Recherche multi-critères dans les annonces françaises agrégées par CarHunt (LeBonCoin, LaCentrale, L'Argus, Autosphere, ParuVendu…). Sans compte : 10 résultats max, sans deal-score. Avec une clé personnelle Premium/Pro/Expert (Bearer chu_live_…) : 25 résultats, deal-score visible et tri deal_score. Chaque annonce inclut source_url (lien direct vers l'annonce d'origine) — à toujours citer.

  Parameters:

  • make — string — Marque, ex. VOLKSWAGEN, PEUGEOT, BMW
  • sort — string — date = découverte la plus récente (défaut) ; updated_at = fraîcheur scraper ; deal_score = sous-cote (clé Premium/Pro/Expert ou Business requise)
  • limit — integer — Nombre de résultats (max 10 sans clé, 25 avec clé Premium/Pro/Expert)
  • model — string — Modèle commercial, ex. GOLF, 308, SERIE 1 — les familles sont expansées (« GOLF » matche GOLF, GOLF SW…)
  • energy — string — Énergies séparées par des virgules : Essence,Diesel,Électrique,Hybride
  • region — string — Région française : ile-de-france (ou idf), paca, bretagne, occitanie, normandie… Exclusif avec departments.
  • gearbox — string — Boîtes séparées par des virgules : Manuelle,Automatique
  • year_max — integer
  • year_min — integer — Année-modèle minimum
  • price_max — integer — Prix maximum en euros
  • price_min — integer — Prix minimum en euros
  • departments — array — Codes départements, ex. ["33", "24", "40"]
  • mileage_max — integer — Kilométrage maximum
  • seller_type — string — Vendeur professionnel ou particulier (couverture partielle)

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• estimate_car_price read-only

  Estimate the market price of a used car in France. Estimation de prix basée sur les annonces comparables réelles du marché français : bon prix (Q1), valeur juste (médiane), prix haut (Q3), indice de confiance et annonces similaires. Le kilométrage est facultatif : sans lui, l'estimation part du kilométrage médian des annonces comparables et le signale dans `note`. Sans compte : 3 estimations/jour par IP. Avec clé personnelle Premium/Pro/Expert : quota du plan (15/jour, 30/jour ou illimité).

  Parameters:

  • make (required) — string — Marque, ex. RENAULT
  • model (required) — string — Modèle, ex. CLIO
  • year (required) — integer — Année-modèle
  • energy — string — Essence, Diesel, Électrique, Hybride (optionnel)
  • gearbox — string — Manuelle ou Automatique (optionnel)
  • mileage — integer — Kilométrage en km. Second facteur de prix après l'âge : le donner quand on le connaît. Si l'utilisateur ne l'a pas précisé, OMETTEZ ce paramètre plutôt que d'inventer une valeur — l'estimation utilisera alors le kilométrage médian des annonces comparables et le signalera dans `note` (à répercuter à l'utilisateur).

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• car_market_stats read-only

  Market statistics for a used car model in France (median price, volume). Médiane de prix du segment (année ±1, tranche de km) et volume d'annonces actives pour un modèle sur le marché français.

  Parameters:

  • make (required) — string
  • model (required) — string
  • year — integer — Année du segment (optionnel, ±1 an)
  • mileage — integer — Kilométrage du segment (optionnel, tranche ±20k)

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• pro_search read-only

  Full professional search with deal-score, 50 results/page, incremental polling. Recherche complète pour les professionnels : deal-score de sous-cote sur chaque annonce, tri deal_score, filtres finition/motorisation/fraîcheur, pagination, polling incrémental (since). Requiert une clé API CarHunt Pro (plan Business). Consomme le quota mensuel de véhicules de l'organisation.

  Parameters:

  • make — string — Marque, ex. VOLKSWAGEN, PEUGEOT, BMW
  • page — integer — Page de résultats (défaut 1)
  • sort — string
  • limit — integer — Résultats par page, max 50 (défaut 25)
  • model — string — Modèle commercial, ex. GOLF, 308, SERIE 1 — les familles sont expansées (« GOLF » matche GOLF, GOLF SW…)
  • since — string — Timestamp ISO — ne renvoyer que les annonces découvertes après (polling incrémental)
  • energy — string — Énergies séparées par des virgules : Essence,Diesel,Électrique,Hybride
  • region — string — Région française : ile-de-france (ou idf), paca, bretagne, occitanie, normandie… Exclusif avec departments.
  • gearbox — string — Boîtes séparées par des virgules : Manuelle,Automatique
  • finition — string — Finition normalisée, ex. R-Line, GT Line
  • year_max — integer
  • year_min — integer — Année-modèle minimum
  • price_max — integer — Prix maximum en euros
  • price_min — integer — Prix minimum en euros
  • departments — array — Codes départements, ex. ["33", "24", "40"]
  • mileage_max — integer — Kilométrage maximum
  • mileage_min — integer
  • seller_type — string — Vendeur professionnel ou particulier (couverture partielle)
  • motorization — string — Code moteur, ex. « 2.0 TDI » — match souple
  • min_deal_score — number — Plancher de score de sous-cote (50 = prix médian marché)
  • seen_within_days — integer — Ne renvoyer que les annonces re-vues par les scrapers dans les N derniers jours (anti-annonces retirées ; recommandé 7)

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• pro_deals read-only

  Underpriced car deals feed, sorted by deal-score. Les meilleures affaires du marché : annonces dont le prix est nettement sous la médiane de leur segment, triées des plus sous-cotées aux moins sous-cotées (min_deal_score 60 par défaut). L'outil de pige des négociants. Clé API Business requise.

  Parameters:

  • make — string — Marque, ex. VOLKSWAGEN, PEUGEOT, BMW
  • page — integer — Page de résultats (défaut 1)
  • limit — integer — Résultats par page, max 50 (défaut 25)
  • model — string — Modèle commercial, ex. GOLF, 308, SERIE 1 — les familles sont expansées (« GOLF » matche GOLF, GOLF SW…)
  • since — string — Timestamp ISO — ne renvoyer que les annonces découvertes après (polling incrémental)
  • energy — string — Énergies séparées par des virgules : Essence,Diesel,Électrique,Hybride
  • region — string — Région française : ile-de-france (ou idf), paca, bretagne, occitanie, normandie… Exclusif avec departments.
  • gearbox — string — Boîtes séparées par des virgules : Manuelle,Automatique
  • finition — string — Finition normalisée, ex. R-Line, GT Line
  • year_max — integer
  • year_min — integer — Année-modèle minimum
  • price_max — integer — Prix maximum en euros
  • price_min — integer — Prix minimum en euros
  • departments — array — Codes départements, ex. ["33", "24", "40"]
  • mileage_max — integer — Kilométrage maximum
  • mileage_min — integer
  • seller_type — string — Vendeur professionnel ou particulier (couverture partielle)
  • motorization — string — Code moteur, ex. « 2.0 TDI » — match souple
  • min_deal_score — number — Plancher de score (défaut 60 = nettement sous la cote)
  • seen_within_days — integer — Ne renvoyer que les annonces re-vues par les scrapers dans les N derniers jours (anti-annonces retirées ; recommandé 7)

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• pro_market_position read-only

  Market position of a specific listing: segment median, savings vs market. Médiane de prix du segment comparable d'une annonce + écart € / % vs marché (argument de négociation). listing_id = champ `id` d'un résultat pro_search/pro_deals.

  Parameters:

  • listing_id (required) — string

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• pro_watchlist_list read-only

  List the organization's watchlists (automatic alerts). Critères évalués toutes les 10 minutes sur le catalogue déjà collecté, puis notification par email, Discord ou webhook JSON.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• pro_watchlist_create

  Create a watchlist: criteria are evaluated every 10 minutes against the already collected catalog, then matching listings are pushed to a webhook. Crée une alerte : chaque nouvelle annonce détectée qui matche les critères est poussée en POST JSON sur webhook_url (véhicules livrés décomptés du quota mensuel). Clé API avec scope write requise.

  Parameters:

  • name (required) — string
  • make — string — Marque, ex. VOLKSWAGEN, PEUGEOT, BMW
  • model — string — Modèle commercial, ex. GOLF, 308, SERIE 1 — les familles sont expansées (« GOLF » matche GOLF, GOLF SW…)
  • energy — string — Énergies séparées par des virgules : Essence,Diesel,Électrique,Hybride
  • region — string — Région française : ile-de-france (ou idf), paca, bretagne, occitanie, normandie… Exclusif avec departments.
  • gearbox — string — Boîtes séparées par des virgules : Manuelle,Automatique
  • finition — string
  • year_max — integer
  • year_min — integer — Année-modèle minimum
  • price_max — integer — Prix maximum en euros
  • price_min — integer — Prix minimum en euros
  • departments — array — Codes départements, ex. ["33", "24", "40"]
  • mileage_max — integer — Kilométrage maximum
  • seller_type — string
  • webhook_url — string — URL http(s) POST JSON appelée à chaque nouvelle annonce matchante
  • motorization — string
  • min_deal_score — number

  Hints: read-only no · destructive not declared · idempotent not declared · open-world no

• pro_watchlist_delete

  Delete a watchlist by id. Supprime une watchlist (cf. pro_watchlist_list).

  Parameters:

  • watchlist_id (required) — string

  Hints: read-only no · destructive not declared · idempotent not declared · open-world no

• pro_usage read-only

  Current month API usage: quota, vehicles consumed, remaining, extra credits. Quota mensuel de véhicules du plan, consommé, restant et crédits achetés.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.