Connexion HTTP/SSE directe

Pour un script, une application interne, ou un client IA qui ne supporte pas MCP nativement, le serveur Imoria s’appelle directement en HTTP. Cette page suppose une familiarité avec HTTP et JSON. C’est la voie technique. Pour la voie grand public, retourner au hub d’installation.

Endpoint

Champ	Valeur
Base URL	`https://mcp.imoria.net/mcp`
Méthode	POST (JSON-RPC, supporte SSE via header `Accept`)
Content-Type	`application/json`
Auth	Header `Authorization` selon les modalités convenues

Le serveur implémente le profil Streamable HTTP du Model Context Protocol. Toutes les opérations passent par la même URL POST /mcp ; pas d’endpoint SSE séparé.

Vérifier que le serveur répond

Appel JSON-RPC minimal qui retourne la liste des outils accessibles au caller :

Liveness via tools/list

curl -X POST -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
     https://mcp.imoria.net/mcp

Réponse type :

Réponse JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      { "name": "search_ads",           "description": "...", "inputSchema": { ... } },
      { "name": "estimate_ad_value",    "description": "...", "inputSchema": { ... } },
      { "name": "analyze_location",     "description": "...", "inputSchema": { ... } }
    ]
  }
}

Le serveur peut aussi renvoyer 401 Unauthorized si l’authentification est manquante : c’est attendu et signale simplement que le serveur est en ligne.

Diagnostic rapide (GET)

Une route REST légère liste les outils visibles au caller, utile pour valider l’authentification :

GET /mcp/tools

curl https://mcp.imoria.net/mcp/tools

Réponse

{ "email": "...", "tools": ["search_ads", "estimate_ad_value", "..."] }

Appeler un outil

Exemple : chercher les T2 sous-cotés à Nancy sous 180 k€ via find_undervalued_ads.

Appel d'outil

curl -X POST -H "Content-Type: application/json" \
     -d '{
       "jsonrpc": "2.0",
       "id": 2,
       "method": "tools/call",
       "params": {
         "name": "find_undervalued_ads",
         "arguments": {
           "archetype": "appartement",
           "city": "Nancy",
           "minBedrooms": 1,
           "maxBedrooms": 2,
           "maxPrice": 180000
         }
       }
     }' \
     https://mcp.imoria.net/mcp

Le serveur répond avec un payload JSON-RPC contenant les annonces classées par décote, leur dealScorePct et leur confidence.

Flux SSE (Server-Sent Events)

Pour les outils qui streament leur réponse (analyses longues), ajouter le header Accept: text/event-stream au même endpoint POST. Le serveur upgrade la connexion en stream SSE.

POST /mcp en mode SSE

curl -N -X POST \
     -H "Content-Type: application/json" \
     -H "Accept: text/event-stream" \
     -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{...}}' \
     https://mcp.imoria.net/mcp

Chaque événement arrive sous la forme data: {...}\n\n jusqu’à la fin de la session.

Exemple Python

import requests

BASE = "https://mcp.imoria.net/mcp"

payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "estimate_ad_value",
        "arguments": {"adId": "11111111-1111-1111-1111-111111111111"},
    },
}

response = requests.post(BASE, json=payload, timeout=30)
response.raise_for_status()
print(response.json())

Pour aller plus loin

La Référence outils liste tous les outils MCP publics et leurs paramètres principaux.

Démarrer

Chercher des biens

Évaluer & analyser

Outils géo

Ressources

Connexion HTTP/SSE directe

Endpoint

Vérifier que le serveur répond

Diagnostic rapide (GET)

Appeler un outil

Flux SSE (Server-Sent Events)

Exemple Python

Pour aller plus loin

​Endpoint

​Vérifier que le serveur répond

​Diagnostic rapide (GET)

​Appeler un outil

​Flux SSE (Server-Sent Events)

​Exemple Python

​Pour aller plus loin

Endpoint

Vérifier que le serveur répond

Diagnostic rapide (GET)

Appeler un outil

Flux SSE (Server-Sent Events)

Exemple Python

Pour aller plus loin