MCP-Server

CarHunt

fr.carhunt/carhunt
Commerce & Retail Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

Searches French used-car listings, estimates vehicle prices, provides market statistics, and supports professional deal monitoring and watchlists.

car_market_stats
Statistiques marché d'un modèle (gratuit)
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.
Nur Lesen
Eingabeschema
{'type': 'object', 'required': ['make', 'model'], 'properties': {'make': {'type': 'string'}, 'year': {'type': 'integer', 'description': 'Année du segment (optionnel, ±1 an)'}, 'model': {'type': 'string'}, 'mileage': {'type': 'integer', 'description': 'Kilométrage du segment (optionnel, tranche ±20k)'}}}
estimate_car_price
Estimer le prix d'une voiture (gratuit)
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é).
Nur Lesen
Eingabeschema
{'type': 'object', 'required': ['make', 'model', 'year'], 'properties': {'make': {'type': 'string', 'description': 'Marque, ex. RENAULT'}, 'year': {'type': 'integer', 'description': 'Année-modèle'}, 'model': {'type': 'string', 'description': 'Modèle, ex. CLIO'}, 'energy': {'type': 'string', 'description': 'Essence, Diesel, Électrique, Hybride (optionnel)'}, 'gearbox': {'type': 'string', 'description': 'Manuelle ou Automatique (optionnel)'}, 'mileage': {'type': 'integer', 'description': "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)."}}}
pro_deals
Flux d'annonces sous-cotées (clé API)
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.
Nur Lesen
Eingabeschema
{'type': 'object', 'properties': {'make': {'type': 'string', 'description': 'Marque, ex. VOLKSWAGEN, PEUGEOT, BMW'}, 'page': {'type': 'integer', 'description': 'Page de résultats (défaut 1)'}, 'limit': {'type': 'integer', 'description': 'Résultats par page, max 50 (défaut 25)'}, 'model': {'type': 'string', 'description': 'Modèle commercial, ex. GOLF, 308, SERIE 1 — les familles sont expansées (« GOLF » matche GOLF, GOLF SW…)'}, 'since': {'type': 'string', 'description': 'Timestamp ISO — ne renvoyer que les annonces découvertes après (polling incrémental)'}, 'energy': {'type': 'string', 'description': 'Énergies séparées par des virgules : Essence,Diesel,Électrique,Hybride'}, 'region': {'type': 'string', 'description': 'Région française : ile-de-france (ou idf), paca, bretagne, occitanie, normandie… Exclusif avec departments.'}, 'gearbox': {'type': 'string', 'description': 'Boîtes séparées par des virgules : Manuelle,Automatique'}, 'finition': {'type': 'string', 'description': 'Finition normalisée, ex. R-Line, GT Line'}, 'year_max': {'type': 'integer'}, 'year_min': {'type': 'integer', 'description': 'Année-modèle minimum'}, 'price_max': {'type': 'integer', 'description': 'Prix maximum en euros'}, 'price_min': {'type': 'integer', 'description': 'Prix minimum en euros'}, 'departments': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Codes départements, ex. ["33", "24", "40"]'}, 'mileage_max': {'type': 'integer', 'description': 'Kilométrage maximum'}, 'mileage_min': {'type': 'integer'}, 'seller_type': {'enum': ['pro', 'private'], 'type': 'string', 'description': 'Vendeur professionnel ou particulier (couverture partielle)'}, 'motorization': {'type': 'string', 'description': 'Code moteur, ex. « 2.0 TDI » — match souple'}, 'min_deal_score': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Plancher de score (défaut 60 = nettement sous la cote)'}, 'seen_within_days': {'type': 'integer', 'description': 'Ne renvoyer que les annonces re-vues par les scrapers dans les N derniers jours (anti-annonces retirées ; recommandé 7)'}}}
pro_market_position
Position marché d'une annonce (clé API)
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.
Nur Lesen
Eingabeschema
{'type': 'object', 'required': ['listing_id'], 'properties': {'listing_id': {'type': 'string'}}}
pro_search
Recherche pro complète (clé API)
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.
Nur Lesen
Eingabeschema
{'type': 'object', 'properties': {'make': {'type': 'string', 'description': 'Marque, ex. VOLKSWAGEN, PEUGEOT, BMW'}, 'page': {'type': 'integer', 'description': 'Page de résultats (défaut 1)'}, 'sort': {'enum': ['date', 'created_at', 'updated_at', 'price_asc', 'price_desc', 'deal_score'], 'type': 'string'}, 'limit': {'type': 'integer', 'description': 'Résultats par page, max 50 (défaut 25)'}, 'model': {'type': 'string', 'description': 'Modèle commercial, ex. GOLF, 308, SERIE 1 — les familles sont expansées (« GOLF » matche GOLF, GOLF SW…)'}, 'since': {'type': 'string', 'description': 'Timestamp ISO — ne renvoyer que les annonces découvertes après (polling incrémental)'}, 'energy': {'type': 'string', 'description': 'Énergies séparées par des virgules : Essence,Diesel,Électrique,Hybride'}, 'region': {'type': 'string', 'description': 'Région française : ile-de-france (ou idf), paca, bretagne, occitanie, normandie… Exclusif avec departments.'}, 'gearbox': {'type': 'string', 'description': 'Boîtes séparées par des virgules : Manuelle,Automatique'}, 'finition': {'type': 'string', 'description': 'Finition normalisée, ex. R-Line, GT Line'}, 'year_max': {'type': 'integer'}, 'year_min': {'type': 'integer', 'description': 'Année-modèle minimum'}, 'price_max': {'type': 'integer', 'description': 'Prix maximum en euros'}, 'price_min': {'type': 'integer', 'description': 'Prix minimum en euros'}, 'departments': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Codes départements, ex. ["33", "24", "40"]'}, 'mileage_max': {'type': 'integer', 'description': 'Kilométrage maximum'}, 'mileage_min': {'type': 'integer'}, 'seller_type': {'enum': ['pro', 'private'], 'type': 'string', 'description': 'Vendeur professionnel ou particulier (couverture partielle)'}, 'motorization': {'type': 'string', 'description': 'Code moteur, ex. « 2.0 TDI » — match souple'}, 'min_deal_score': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Plancher de score de sous-cote (50 = prix médian marché)'}, 'seen_within_days': {'type': 'integer', 'description': 'Ne renvoyer que les annonces re-vues par les scrapers dans les N derniers jours (anti-annonces retirées ; recommandé 7)'}}}
pro_usage
Consommation API du mois (clé API)
Current month API usage: quota, vehicles consumed, remaining, extra credits. Quota mensuel de véhicules du plan, consommé, restant et crédits achetés.
Nur Lesen
Eingabeschema
{'type': 'object', 'properties': {}}
pro_watchlist_create
Créer une watchlist (clé API, scope write)
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.
Eingabeschema
{'type': 'object', 'required': ['name'], 'properties': {'make': {'type': 'string', 'description': 'Marque, ex. VOLKSWAGEN, PEUGEOT, BMW'}, 'name': {'type': 'string'}, 'model': {'type': 'string', 'description': 'Modèle commercial, ex. GOLF, 308, SERIE 1 — les familles sont expansées (« GOLF » matche GOLF, GOLF SW…)'}, 'energy': {'type': 'string', 'description': 'Énergies séparées par des virgules : Essence,Diesel,Électrique,Hybride'}, 'region': {'type': 'string', 'description': 'Région française : ile-de-france (ou idf), paca, bretagne, occitanie, normandie… Exclusif avec departments.'}, 'gearbox': {'type': 'string', 'description': 'Boîtes séparées par des virgules : Manuelle,Automatique'}, 'finition': {'type': 'string'}, 'year_max': {'type': 'integer'}, 'year_min': {'type': 'integer', 'description': 'Année-modèle minimum'}, 'price_max': {'type': 'integer', 'description': 'Prix maximum en euros'}, 'price_min': {'type': 'integer', 'description': 'Prix minimum en euros'}, 'departments': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Codes départements, ex. ["33", "24", "40"]'}, 'mileage_max': {'type': 'integer', 'description': 'Kilométrage maximum'}, 'seller_type': {'enum': ['pro', 'private'], 'type': 'string'}, 'webhook_url': {'type': 'string', 'description': 'URL http(s) POST JSON appelée à chaque nouvelle annonce matchante'}, 'motorization': {'type': 'string'}, 'min_deal_score': {'type': 'number', 'maximum': 100, 'minimum': 0}}}
pro_watchlist_delete
Supprimer une watchlist (clé API, scope write)
Delete a watchlist by id. Supprime une watchlist (cf. pro_watchlist_list).
Eingabeschema
{'type': 'object', 'required': ['watchlist_id'], 'properties': {'watchlist_id': {'type': 'string'}}}
pro_watchlist_list
Lister les watchlists (clé API)
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.
Nur Lesen
Eingabeschema
{'type': 'object', 'properties': {}}
search_used_cars
Rechercher des voitures d'occasion (gratuit)
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.
Nur Lesen
Eingabeschema
{'type': 'object', 'properties': {'make': {'type': 'string', 'description': 'Marque, ex. VOLKSWAGEN, PEUGEOT, BMW'}, 'sort': {'enum': ['date', 'price_asc', 'price_desc', 'updated_at', 'deal_score'], 'type': 'string', 'description': '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': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Nombre de résultats (max 10 sans clé, 25 avec clé Premium/Pro/Expert)'}, 'model': {'type': 'string', 'description': 'Modèle commercial, ex. GOLF, 308, SERIE 1 — les familles sont expansées (« GOLF » matche GOLF, GOLF SW…)'}, 'energy': {'type': 'string', 'description': 'Énergies séparées par des virgules : Essence,Diesel,Électrique,Hybride'}, 'region': {'type': 'string', 'description': 'Région française : ile-de-france (ou idf), paca, bretagne, occitanie, normandie… Exclusif avec departments.'}, 'gearbox': {'type': 'string', 'description': 'Boîtes séparées par des virgules : Manuelle,Automatique'}, 'year_max': {'type': 'integer'}, 'year_min': {'type': 'integer', 'description': 'Année-modèle minimum'}, 'price_max': {'type': 'integer', 'description': 'Prix maximum en euros'}, 'price_min': {'type': 'integer', 'description': 'Prix minimum en euros'}, 'departments': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Codes départements, ex. ["33", "24", "40"]'}, 'mileage_max': {'type': 'integer', 'description': 'Kilométrage maximum'}, 'seller_type': {'enum': ['pro', 'private'], 'type': 'string', 'description': 'Vendeur professionnel ou particulier (couverture partielle)'}}}
Geändert
estimate_car_price
29. September 2026 02:51
Geändert
search_used_cars
29. September 2026 02:51
Hinzugefügt
pro_usage
17. September 2026 12:39
Hinzugefügt
pro_watchlist_delete
17. September 2026 12:39
Hinzugefügt
pro_watchlist_create
17. September 2026 12:39
Hinzugefügt
pro_watchlist_list
17. September 2026 12:39
Hinzugefügt
pro_market_position
17. September 2026 12:39
Hinzugefügt
pro_deals
17. September 2026 12:39
Hinzugefügt
pro_search
17. September 2026 12:39
Hinzugefügt
car_market_stats
17. September 2026 12:39
Hinzugefügt
estimate_car_price
17. September 2026 12:39
Hinzugefügt
search_used_cars
17. September 2026 12:39