What is Moteurimmo Mcp Server

The moteurimmo-mcp-server is a Model Context Protocol (MCP) server designed to integrate the MoteurImmo API into AI agents, facilitating the search and retrieval of real estate listings from various French property portals.

Use cases

Use cases include searching for apartments within specific price ranges and criteria, retrieving detailed information about specific property listings, and integrating real estate data into AI-driven applications.

How to use

To use the moteurimmo-mcp-server, set up your environment by creating a .env file with your MoteurImmo API credentials. Start the server using npm start for normal operation or npm run dev for development mode. The server exposes two main tools: search_ads for searching listings and get_ad for retrieving specific listings by ID.

Key features

Key features include searching listings based on various criteria (price, area, location), detailed retrieval of listings by ID, filtering options (garage, terrace, garden), optional negotiation analysis, and optional listing history.

Where to use

The moteurimmo-mcp-server is primarily used in real estate applications, AI agents, and any platform requiring integration with the MoteurImmo API for property searches and data retrieval.

MoteurImmo MCP Server

Ce serveur MCP (Model Context Protocol) permet d’intégrer le service MoteurImmo dans des agents IA. Il facilite la recherche et la récupération d’annonces immobilières depuis différents portails immobiliers français.

Fonctionnalités

• Recherche d’annonces selon divers critères (prix, surface, localisation, etc.)
• Récupération détaillée d’une annonce par son identifiant
• Filtrage par options (garage, terrasse, jardin, etc.)
• Analyse de négociation (optionnel)
• Historique des annonces (optionnel)

Configuration

Utilisation direct de l’API MoteurImmo avec un serveur MCP.

{
    "mcpServers": {
        "moteurimmo": {
            "command": "npx",
            "args": ["-y", "moteurimmo-mcp-server"],
            "env": {
              "MOTEUR_IMMO_API_TOKEN": "YOUR-API-KEY"
            }
        }
    }
}

Installation (pour le développement)

# Installation des dépendances
npm install

# Compilation du projet TypeScript
npm run build

Configuration

Créez un fichier .env à la racine du projet avec les informations suivantes :

MOTEURIMMO_API_URL=https://api.moteurimmo.fr
MOTEURIMMO_API_KEY=votre_clé_api_ici

Utilisation

Démarrage du serveur

# Démarrage normal
npm start

# Démarrage en mode développement avec l'inspecteur MCP
npm run dev

Outils disponibles

Le serveur expose deux outils principaux :

1. search_ads - Recherche d’annonces avec filtres
2. get_ad - Récupération d’une annonce spécifique par ID

Exemple d’utilisation

Le serveur s’intègre avec des agents IA compatibles MCP et permet des recherches comme :

"Trouver un appartement à Paris entre 300 000€ et 400 000€ avec au moins 2 chambres"

ou

"Montre-moi les détails de l'annonce avec l'identifiant XYZ123"

Développement

# Compilation en temps réel
npx tsc --watch

# Tests avec l'inspecteur MCP
npm run dev

Licence

Ce projet est sous licence ISC. Voir le fichier LICENSE pour plus de détails.

Liens

• Documentation de l’API MoteurImmo
• SDK Model Context Protocol