OathReady pour les développeurs et les assistants IA
Tout sur OathReady est à votre disposition pour bâtir vos projets, gratuitement : un serveur MCP public qui permet aux assistants IA de mener de vraies séances de pratique, un quiz en terminal que vous lancez avec npx, une carte du site en llms.txt, un widget de questions intégrable et un paquet Anki partagé. Tout cela puise dans la même banque vérifiée de 574 questions, fondée sur le guide d’étude officiel Découvrir le Canada.
Serveur MCP
Un serveur Model Context Protocol distant, en HTTP streamable. Branchez-le à Claude, ChatGPT, Cursor ou à tout autre client MCP, puis demandez un examen blanc, une séance d’étude ou vos dates d’admissibilité.
Lecture seule, sans état et sans risque : chaque outil ne lit que du contenu d’étude public et des statistiques agrégées. Rien à installer, aucune clé à créer.
Configurez-le dans votre application IA
- 1Sur claude.ai ou dans l’application de bureau, ouvrez Paramètres, puis Connecteurs.
- 2Choisissez Ajouter un connecteur personnalisé.
- 3Nommez-le OathReady et collez l’URL de l’endpoint :
https://oathready.ca/api/mcpLes connecteurs personnalisés sont offerts avec les forfaits Claude payants. Une fois ajouté, activez-le depuis le menu des outils, dans n’importe quelle conversation.
Essayer
Une fois le serveur connecté, posez vos questions en langage courant. Quelques exemples qui font bien travailler les outils :
- « Faites-moi passer un examen blanc de citoyenneté de 10 questions, une question à la fois. »
- « Interrogez-moi sur l’histoire du Canada jusqu’à ce que j’aie cinq bonnes réponses de suite. »
- « Je suis devenu résident permanent le 3 mars 2024. Quand puis-je demander la citoyenneté? »
- « Mon examen pour la citoyenneté est la semaine prochaine. Que rapportent les candidats récents? »
- « Il y avait une question sur les Pères de la Confédération. Quelle était la réponse? »
Les outils
Une question au hasard tirée de la banque vérifiée, avec les choix, le corrigé et l’explication. Filtres : sujet, province.
Le Défi quotidien : les 5 mêmes questions pour tout le monde ce jour-là, avec les corrigés pour que l’assistant puisse animer le jeu.
Un examen blanc complet dans le format réel de l’examen (20 questions, note de passage 15), avec les corrigés pour que l’assistant puisse animer le jeu.
Recherche d’une question par son id ou à partir d’un souvenir approximatif (correspondance floue), avec correction facultative d’une réponse.
Le contenu du guide d’étude pour un sujet : le survol et les faits courts les plus souvent testés.
La durée du parcours vers la citoyenneté : le délai de traitement officiel d’IRCC et les médianes anonymes de la communauté pour chaque étape.
Le texte du serment, quoi apporter, le déroulement de la cérémonie et les premières démarches comme nouveau citoyen.
Des conseils pratiques pour le jour de l’examen, plus les témoignages anonymes et en direct de candidats récents et les sujets qu’ils ont vus le plus souvent.
Les statistiques officielles d’IRCC sur les nouveaux citoyens : totaux mensuels et annuels, principaux pays de naissance.
La présence effective pour l’admissibilité : la règle des 1 095 jours sur 5 ans, y compris le crédit d’une demi-journée avant la résidence permanente.
Les faits vérifiés sur l’examen et le serment : format, note de passage, qui doit le passer, comment se fait la convocation.
Les corrigés sont transmis au modèle volontairement : l’assistant joue l’animateur, et la description des outils lui demande de ne pas révéler les réponses avant que vous ayez fait votre choix. Les données de la communauté (délais du parcours, témoignages du jour de l’examen) sont anonymes et ne sont publiées qu’au-delà d’une taille de cohorte minimale.
CLI de terminal
Toute la pratique dans votre terminal : examens blancs, cartes-éclair, une question du jour commune et la banque complète à parcourir. Aucune dépendance, environ 44 ko, et les questions sont incluses dans le paquet, donc tout fonctionne hors ligne. Aucun réseau, aucune analytique, aucun compte; le seul fichier écrit est ~/.oathready.json, qui garde votre série et votre meilleur score sur votre propre disque.
OathReady 20-question mock · pass mark 15/20
Question 1/20 · History
Who was Canada's first Prime Minister?
❯ A. Sir John A. Macdonald
B. Sir Wilfrid Laurier
C. Sir George-Etienne Cartier
D. Sir Louis-Hippolyte La Fontaine
Correct!
Sir John A. Macdonald became the first Prime Minister of the
Dominion of Canada in 1867.Installation
Le seul prérequis est Node.js 18 ou plus récent. Vérifiez d’abord votre version :
node -vnpx vient avec Node.js et exécute la dernière version directement depuis npm, rien à gérer ni à mettre à jour :
npx oathreadySi vous l’utilisez tous les jours, l’installation globale vous donne la commande oathready toute simple et un démarrage plus rapide :
npm install -g oathreadyMettez à jour plus tard avec npm update -g oathready, désinstallez avec npm uninstall -g oathready.
Chacune de ces options installe une version LTS à jour. Si node -v affiche encore l’ancienne version ensuite, ouvrez une nouvelle fenêtre de terminal.
brew install nodewinget install OpenJS.NodeJS.LTScurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
nvm install --ltsVous utilisez déjà un gestionnaire de versions (nvm, fnm, volta, mise)? Il suffit alors de nvm install --lts (ou l’équivalent de votre outil) et c’est réglé. Poste d’entreprise sans droits d’installation? npx dans un devcontainer ou une image CI avec Node 18+ fonctionne exactement pareil.
Commandes
Par défaut : un examen blanc de 20 questions dans le format réel de l’examen, note de passage 15/20. Touches fléchées ou lettres, explication immédiate après chaque réponse, PASS ou NOT YET à la fin.
La question du jour. Tout le monde sur Terre reçoit la même (un index de jour dans la banque commune, sans serveur), ce qui en fait un petit rituel quotidien avec votre équipe ou votre groupe d’étude.
Étude par cartes-éclair : lisez la question, n’importe quelle touche révèle la réponse et l’explication, puis notez-vous. Les cartes ratées retournent dans le paquet jusqu’à ce que vous les réussissiez.
Une seule question au hasard. Parfait pour un alias de shell ou un message d’accueil dans le terminal.
Affiche toute la banque avec les réponses marquées et les explications, conçu pour être redirigé : less pour parcourir, grep pour retrouver la question sur la crête de Vimy.
Options et touches
- --topic <slug>
- Limite une commande à un seul sujet : history, government, geography, rights, symbols, economy, law.
- --count <n>
- Questions dans un examen blanc ou cartes dans un paquet (20 par défaut).
- --no-color
- Sortie sans couleur. La variable d’environnement NO_COLOR est aussi respectée, et la sortie redirigée est toujours sans couleur.
- -h, --help
- Mode d’emploi complet, avec les notes sur la confidentialité.
- -v, --version
- Version.
- ↑ ↓ ou j k
- Déplacer la sélection
- Entrée
- Répondre avec l’option choisie
- a b c d ou 1 2 3 4
- Répondre directement
- n’importe quelle touche
- Retourner la carte affichée
- y / n
- Cartes : je le savais / à revoir
- q ou Échap
- Quitter (votre série est déjà enregistrée)
Conçu pour être combiné : oathready --topic law --count 5 pour un exercice rapide, oathready list | grep -A5 Vimy pour retrouver quelque chose, oathready one dans votre profil de shell pour une question à chaque nouveau terminal. L’entrée par pipe fonctionne aussi, vous pouvez donc même le scripter.
Autres façons de l’intégrer
llms.txt
Une carte concise du site, pensée pour les LLM : faits clés vérifiés et liens vers chaque page importante, selon la convention llms.txt.
Widget intégrable
Une vraie question de pratique sur n’importe quel site, avec un seul extrait de code iframe : thèmes clair et sombre, mode aléatoire ou question du jour, filtres par sujet et par province. Aucun témoin, aucun suivi.
Paquet Anki
Des centaines de questions de la banque fédérale, en paquet partagé gratuit sur AnkiWeb : des cartes interactives qui corrigent votre choix quand vous les retournez, étiquetées par sujet, avec une explication sur chacune. Fonctionne dans Anki pour ordinateur et dans les applis mobiles.
Attribution et contact
Le contenu des questions est original et vérifié avec le guide Découvrir le Canada. Les statistiques proviennent des données ouvertes d’IRCC (Licence du gouvernement ouvert, Canada). Si vous citez, faites un lien vers la page précise d’OathReady. Des questions, des idées, quelque chose qui cloche? Écrivez à support@oathready.ca.