Mankomail

Serveur MCP ​

Les routes sont relatives à <PUBLIC_BASE_URL> ; les corps de requête et de réponse sont en JSON sauf mention contraire. L’authentification, les portées, la pagination et le format des erreurs sont décrits dans les guides de l’API REST.

POST /api/v1/mcp ​

Serveur MCP (Streamable HTTP)

Le point de terminaison Model Context Protocol de l’instance, transport Streamable HTTP, sans état. Authentification par clé d’API : chaque tool exige la portée de son domaine, les tools d’écriture le verbe write. Corps JSON-RPC selon la spécification MCP.

Accès — Session de membre ou clé d’API ; les portées sont vérifiées par tool.

Corps de la requête (application/json)

Type : object

json
{
  "type": "object",
  "propertyNames": { "type": "string" },
  "additionalProperties": {}
}

Réponses

200 — Une réponse JSON-RPC (ou un flux SSE).

Type : object

json
{
  "type": "object",
  "propertyNames": { "type": "string" },
  "additionalProperties": {}
}

400 — La requête ne respecte pas son schéma.

401 — Aucune session ni clé d’API valide (auth.unauthenticated).

403 — Refusé : rôle insuffisant (auth.forbidden), portée manquante (api_key.scope_missing, details.required la nomme) ou route fermée aux clés (api_key.session_required).

429 — La clé d’API dépasse son débit (api_key.rate_limited) ; Retry-After dit quand réessayer.