mcpField
M
MoteurImmo MCP Server

MoteurImmo MCP Server

Local
github.com/MeilleursBiensBusiness & Marketing1Updated 77w ago
Repository

About MoteurImmo MCP Server

MoteurImmo MCP Server connects AI agents to French property listings through the MoteurImmo API. It supports filtered searches and retrieval of individual listing details.

Key features

  1. 01Search listings by price, area, and location
  2. 02Filter by property options
  3. 03Retrieve a listing by ID
  4. 04Optional negotiation analysis
  5. 05Optional listing history

Use cases

  1. 01Find apartments within a price range
  2. 02Locate properties with specific features
  3. 03Inspect a listing by its ID

MCP support

Exposes MoteurImmo property search and listing retrieval to MCP clients through the `search_ads` and `get_ad` tools.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "moteurimmo": {
      "command": "npx",
      "args": [
        "-y",
        "tsc"
      ]
    }
  }
}
Run commandnpx -y tsc

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmtsc

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.