Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.imoria.net/llms.txt

Use this file to discover all available pages before exploring further.

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

ChampValeur
Base URLhttps://mcp.imoria.net/mcp
MéthodePOST (JSON-RPC, supporte SSE via header Accept)
Content-Typeapplication/json
AuthHeader 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.