Connexion HTTP/SSE directe

Appeler Imoria en HTTP direct. Pour les intégrations custom, scripts, ou clients qui ne supportent pas encore MCP.

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

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.