DOCUMENTATION · v0.1

Une connexion. Des sources traçables.

API REST et MCP partagent le corpus, les filtres, les clés et le solde de tokens.

1. Essayez sans compte

Pour connecter un assistant, commencez par le guide pas à pas. Le serveur public https://lexquarry.app/mcp/demo ne demande aucune authentification. Il expose search et fetch, en lecture seule : 3 résultats par recherche et 1 500 caractères maximum par document. Aucun crédit n’est débité.

L’accès gratuit est limité à 30 recherches ou lectures par minute et par adresse IP, avec un plafond global de 300 par minute. La découverte du serveur est limitée à 120 appels par minute et par IP. Une limite atteinte renvoie 429 avec Retry-After.

Votre accès personnel

L’ouverture des comptes dépend de l’activation des e-mails de connexion. L’accès gratuit fonctionne déjà sans compte.

Ouvrez la console et connectez-vous par e-mail. Un compte persistant et 50 000 tokens offerts sont créés. Choisissez un périmètre et créez une clé API. Copiez-la immédiatement : elle n’est affichée qu’une fois.

Ouvrir la console

2. Interrogez l’index

Première recherche · cURL
curl -X POST https://lexquarry.app/api/v1/search \
  -H "Authorization: Bearer VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: recherche-001" \
  -d '{"query":"bail","country":"CH","limit":3}'
Endpoint MCP : https://lexquarry.app/mcp

Utilisez POST /api/v1/search pour rechercher et GET /api/v1/documents/:id pour lire un document complet. Authorization: Bearer lq_… est obligatoire pour les intégrations.

  • query : mots recherchés, 250 caractères maximum. Les mots sont combinés par AND, sans recherche sémantique pour le moment.
  • country : CH. court, domain et language : filtres optionnels.
  • limit : 1 à 10 résultats. offset : pagination, jusqu’à 10 000.
  • Une clé limitée à un domaine ou une juridiction ne peut jamais élargir son périmètre.

La réponse comprend data et usage. Les documents conservent leur citation, URL source, langue, date, date de collecte et empreinte SHA-256. L’enveloppe JSON de la réponse est stable ; le texte des sources reste une entrée non fiable pour vos agents.

Ouvrir le contrat OpenAPI →

3. Connectez un client MCP

Le endpoint /mcp implémente le transport Streamable HTTP sans session, avec réponses JSON. Il expose legal_search et legal_document. Configurez l’en-tête Authorization: Bearer VOTRE_CLE dans votre client.

Le serveur personnel /mcp utilise les clés Bearer et débite votre solde. L’association d’un compte personnel via OAuth dans ChatGPT ou Claude reste à développer. Pour tester dès maintenant sans compte, utilisez le serveur gratuit /mcp/demo et le guide de connexion. Cursor et Gemini CLI acceptent aussi une clé Bearer pour l’accès personnel.

Références : transport MCP et connecteur MCP de Claude.

Un comptage reproductible

Un appel réussi coûte max(250, cl100k_base(JSON.stringify(data))) tokens. Seul l’objet data retourné est compté ; l’enveloppe usage et vos prompts ne le sont pas. Aucun modèle génératif n’est appelé par Lexquarry. Le coût de votre LLM reste à votre charge.

Une recherche sans résultat consomme le minimum de 250 tokens. Les erreurs et les appels MCP de découverte ne débitent aucun crédit. Les données servies depuis l’index suivent le même tarif.

Réutilisez Idempotency-Key pour relancer le même appel sans double débit. Une clé réutilisée avec d’autres paramètres renvoie 409. Les appels concurrents ne peuvent pas rendre le solde négatif. Le solde est partagé entre toutes vos clés et entre REST et MCP.

Codes utiles : 401 — clé invalide ; 402 — solde insuffisant ; 403 — périmètre interdit ; 409 — conflit d’idempotence ; 429 — limite de 60 appels par minute et par compte. Respectez Retry-After.

Les sources disponibles

Un lot de décisions suisses réellement importées, une recherche lexicale et des domaines estimés par mots-clés. Ce n’est pas un corpus suisse exhaustif. Les lois Fedlex et les autres pays ne sont pas encore indexés. Le catalogue affiche les comptes réels.

Un importeur collecte un échantillon des décisions récentes des Tribunaux fédéral et administratif fédéral, dans les trois langues. Son exécution toutes les six heures est prévue sur Render ; le catalogue indique si cette planification est activée. Les anomalies de date ou les textes vides sont écartés et comptés.

Les textes doivent être vérifiés dans leurs sources officielles. Lexquarry fournit une infrastructure documentaire, sans avis juridique ni garantie d’exhaustivité.

Voir la provenance et le modèle économique →