OathReady

OathReady for developers and AI assistants

Everything on OathReady is available to build with, for free: a public MCP server so AI assistants can run real practice sessions, an llms.txt map of the site, and an embeddable question widget. All of it draws on the same verified bank of 470 questions based on the official Discover Canada study guide.

10 toolsNo auth, no API keyFree foreverRead-only and stateless

MCP server

A remote Model Context Protocol server over streamable HTTP. Connect it to Claude, ChatGPT, Cursor, or any MCP client and ask for a mock test, a study session, or your eligibility dates.

Endpoint
https://oathready.ca/api/mcp
Official registry name
ca.oathready/citizenship-test

Read-only, stateless, and safe: every tool only reads public study content and aggregate statistics. Nothing to install, no key to create.

Set it up in your AI app

  1. 1On claude.ai or the desktop app, open Settings, then Connectors.
  2. 2Choose Add custom connector.
  3. 3Name it OathReady and paste the endpoint URL:
https://oathready.ca/api/mcp

Custom connectors are available on paid Claude plans. Once added, enable it from the tools menu in any chat.

Try it

Once connected, ask in plain language. A few prompts that exercise the tools well:

  • “Run me through a 10-question mock citizenship test, one question at a time.”
  • “Quiz me on Canadian history until I get five right in a row.”
  • “I became a PR on March 3, 2024. When can I apply for citizenship?”
  • “My citizenship test is next week. What are recent test-takers reporting?”
  • “There was a question about who the Fathers of Confederation were. What was the answer?”

The tools

get_practice_question

One random question from the verified bank, with options, answer key, and explanation. Filters: topic, province.

get_mock_test

A full mock test in the real exam format (20 questions, pass mark 15), with answer keys so the assistant can run it as quizmaster.

check_answer

Look up a question by id or by half-remembered text (fuzzy matched) and optionally grade an answer against it.

get_study_guide

The study-guide content for one topic: overview plus the bite-size facts most commonly tested.

get_journey_stats

How long the citizenship journey takes: official IRCC processing time plus anonymous community medians per milestone.

get_oath_guide

The oath text, what to bring, how the ceremony unfolds, and first steps as a new citizen.

get_test_day_guide

Practical test-day guidance plus live, anonymous reports from recent test-takers and the topics they saw most.

get_citizenship_stats

Official IRCC statistics on new citizens: monthly counts, yearly totals, top countries of birth.

calculate_presence

Physical presence for eligibility: the 1,095-days-in-5-years rule, including the pre-PR half-day credit.

get_test_info

Key verified facts about the test and oath: format, pass mark, who must take it, how scheduling works.

Answer keys are returned to the model on purpose: the assistant is the quizmaster, and the tool descriptions instruct it not to reveal answers before the user commits. Community data (journey timelines, test-day reports) is anonymous and only published above a minimum cohort size.

llms.txt

A concise, LLM-friendly map of the site with verified key facts and links to every major page, following the llms.txt convention.

oathready.ca/llms.txt

Embed widget

A live practice question for any website in one iframe snippet: light and dark themes, random or question-of-the-day modes, topic and province filters. No cookies, no tracking.

Get the widget

Attribution and contact

Question content is original work verified against Discover Canada. Statistics are IRCC open data (Open Government Licence, Canada). When citing, link the specific OathReady page. Questions, ideas, or something broken? Write to support@oathready.ca.