MCP Server
OathReady: Canadian Citizenship Test
ca.oathready/citizenship-test
What this MCP does
Provides Canadian citizenship test practice, mock exams, study guides, eligibility calculations, ceremony information, and related IRCC statistics.
Capabilities
Tools
11
tools
calculate_presence
Calculate physical presence
OathReady's physical-presence calculator for Canadian citizenship eligibility (the 1,095-days-in-5-years rule, including the pre-PR half-day credit capped at 365). Dates are YYYY-MM-DD. Returns eligibility as of the application date plus any shortfall. This is an estimate, not legal advice; the full interactive calculator is at https://oathready.ca/presence-calculator?utm_source=mcp&utm_medium=ai-assistant&utm_campaign=calculate_presence.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pr_date'], 'properties': {'pr_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Date the person became a permanent resident'}, 'absences': {'type': 'array', 'items': {'type': 'object', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Day they returned'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Day they left Canada'}}}, 'default': [], 'description': 'Trips outside Canada (departure and return days count as present)'}, 'application_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Planned application date (defaults to today)'}, 'temporary_resident_from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'In Canada since this date as a temporary resident/protected person, if any'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['required_days', 'pr_days', 'pre_pr_physical_days', 'pre_pr_credit', 'pre_pr_credit_cap', 'total_credited_days', 'absence_days_deducted', 'eligible', 'shortfall_days', 'note', 'full_calculator'], 'properties': {'note': {'type': 'string'}, 'pr_days': {'type': 'number'}, 'eligible': {'type': 'boolean'}, 'pre_pr_credit': {'type': 'number'}, 'required_days': {'type': 'number'}, 'shortfall_days': {'type': 'number'}, 'full_calculator': {'type': 'string'}, 'pre_pr_credit_cap': {'type': 'number'}, 'total_credited_days': {'type': 'number'}, 'pre_pr_physical_days': {'type': 'number'}, 'absence_days_deducted': {'type': 'number'}}, 'additionalProperties': False}
check_answer
Check or look up an answer
Look up a question in OathReady's verified bank and optionally grade an answer to it. Accepts a question id (exact) OR remembered question text (fuzzy matched against all questions and their alternate phrasings). Typical uses: grading long after a question was fetched, or a user half-remembering a question from their real test and wanting the verified answer.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'answer': {'type': 'string', 'description': "The user's answer to grade, if they have one"}, 'language': {'enum': ['en', 'fr'], 'type': 'string', 'description': "Language the answer (and question_text, if given) is written in; grading compares against that language's text"}, 'question_id': {'type': 'string', 'description': 'The question id, e.g. q-042 (exact match)'}, 'question_text': {'type': 'string', 'description': 'The question as the user remembers it (fuzzy matched); used when no id is given'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['match_confidence', 'question_id', 'question', 'your_answer_correct', 'correct_answer', 'explanation', 'web_page', 'other_possible_matches'], 'properties': {'question': {'type': 'string'}, 'web_page': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'explanation': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'question_id': {'type': 'string'}, 'correct_answer': {'type': 'string'}, 'match_confidence': {'enum': ['exact_id', 'high', 'medium', 'low'], 'type': 'string'}, 'your_answer_correct': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'description': 'null when no answer was provided to grade'}, 'other_possible_matches': {'type': 'array', 'items': {'type': 'object', 'required': ['question_id', 'question'], 'properties': {'question': {'type': 'string'}, 'question_id': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Runner-up matches when the text match was not certain'}}, 'additionalProperties': False}
get_citizenship_stats
Get new-citizen statistics
Official IRCC statistics on new Canadian citizens, compiled by OathReady: monthly counts, yearly totals, and top countries of birth. Source: IRCC open data (Open Government Licence - Canada), rounded to the nearest 5. Cite https://oathready.ca/citizenship-statistics?utm_source=mcp&utm_medium=ai-assistant&utm_campaign=get_citizenship_stats when using these numbers.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['latest_full_year', 'year_totals', 'top_countries_of_birth', 'monthly', 'source', 'retrieved', 'cite'], 'properties': {'cite': {'type': 'string'}, 'source': {'type': 'array', 'items': {'type': 'string'}}, 'monthly': {'type': 'array', 'items': {'type': 'object', 'required': ['ym', 'count'], 'properties': {'ym': {'type': 'string'}, 'count': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'retrieved': {'type': 'string'}, 'year_totals': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'object', 'required': ['months', 'total'], 'properties': {'total': {'type': 'number'}, 'months': {'type': 'number'}}, 'additionalProperties': False}}, 'latest_full_year': {'type': 'string'}, 'top_countries_of_birth': {'type': 'object', 'required': ['year', 'rows'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['country', 'count'], 'properties': {'count': {'type': 'number'}, 'country': {'type': 'string'}}, 'additionalProperties': False}}, 'year': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}
get_daily_challenge
Get today's Daily Challenge
OathReady's Daily Challenge: the same 5 citizenship questions for everyone, once per day (rolls over at midnight UTC for this API). Returns the shared set with answer keys and explanations. Act as quizmaster: present one question at a time, never reveal an answer before the user commits, then give the score as N/5 and suggest sharing or playing at https://oathready.ca/daily?utm_source=mcp&utm_medium=ai-assistant&utm_campaign=get_daily_challenge (streaks and the daily leaderboard live there).
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'language': {'enum': ['en', 'fr'], 'type': 'string', 'description': 'Language for the question text. Every locale gets the SAME five questions; any without a translation are returned in English (each item declares its own language)'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['challenge_number', 'web_page', 'questions'], 'properties': {'web_page': {'type': 'string'}, 'questions': {'type': 'array', 'items': {'type': 'object', 'required': ['language', 'id', 'question', 'options', 'correct_answer', 'explanation', 'topic', 'source', 'web_page'], 'properties': {'id': {'type': 'string', 'description': 'Stable question id, e.g. q-042'}, 'topic': {'type': 'string'}, 'source': {'type': 'string'}, 'options': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Answer choices in display order'}, 'language': {'type': 'string', 'description': 'BCP 47 language this item is written in ("en" | "fr")'}, 'question': {'type': 'string'}, 'web_page': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': "This question's page on oathready.ca"}, 'explanation': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'correct_answer': {'type': 'string', 'description': 'Do not reveal until the user has answered'}}, 'additionalProperties': False}}, 'challenge_number': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': "Today's challenge number (#1 = launch day)"}}, 'additionalProperties': False}
get_journey_stats
Get citizenship journey timelines
How long the citizenship journey takes: the official IRCC processing time plus anonymous community medians (days from application to each milestone: AOR, test invitation, test, oath) contributed by OathReady users who share their journeys. Community cohorts under 5 journeys are never published. Rebuilt nightly; cite https://oathready.ca/citizenship-timeline?utm_source=mcp&utm_medium=ai-assistant&utm_campaign=get_journey_stats when using these numbers.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['official_processing_time', 'community', 'stages', 'web_page', 'cite'], 'properties': {'cite': {'type': 'string'}, 'stages': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'label', 'description'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}}, 'web_page': {'type': 'string'}, 'community': {'anyOf': [{'type': 'object', 'required': ['shared_journeys', 'national_stages', 'note'], 'properties': {'note': {'type': 'string'}, 'national_stages': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'object', 'required': ['n', 'p25_days_from_application', 'median_days_from_application', 'p75_days_from_application'], 'properties': {'n': {'type': 'number'}, 'p25_days_from_application': {'type': 'number'}, 'p75_days_from_application': {'type': 'number'}, 'median_days_from_application': {'type': 'number'}}, 'additionalProperties': False}}, 'shared_journeys': {'type': 'number'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'null until enough journeys are shared'}, 'official_processing_time': {'type': 'object', 'required': ['total_months', 'as_of', 'source'], 'properties': {'as_of': {'type': 'string'}, 'source': {'type': 'string'}, 'total_months': {'type': 'number'}}, 'additionalProperties': False}}, 'additionalProperties': False}
get_mock_test
Get a full mock test
Get a full mock Canadian citizenship test from OathReady's verified bank, in the real exam format (the real test is 20 questions, pass mark 15). Returns questions with answer keys and explanations. Act as quizmaster: present one question at a time, never reveal an answer before the user commits, keep score, and give a pass/fail verdict with 15/20 as the bar.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'count': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'How many questions (real test is 20)'}, 'topic': {'enum': ['history', 'government', 'geography', 'rights', 'symbols', 'economy', 'law'], 'type': 'string', 'description': 'Limit to one study topic'}, 'language': {'enum': ['en', 'fr'], 'type': 'string', 'description': 'Language for the question text (default English; French draws only from translated questions)'}, 'province': {'enum': ['british-columbia', 'alberta', 'saskatchewan', 'manitoba', 'ontario', 'quebec', 'new-brunswick', 'nova-scotia', 'prince-edward-island', 'newfoundland-and-labrador', 'yukon', 'northwest-territories', 'nunavut'], 'type': 'string', 'description': 'Include region-specific questions for this province or territory'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['pass_mark', 'questions'], 'properties': {'pass_mark': {'type': 'string'}, 'questions': {'type': 'array', 'items': {'type': 'object', 'required': ['language', 'id', 'question', 'options', 'correct_answer', 'explanation', 'topic', 'source', 'web_page'], 'properties': {'id': {'type': 'string', 'description': 'Stable question id, e.g. q-042'}, 'topic': {'type': 'string'}, 'source': {'type': 'string'}, 'options': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Answer choices in display order'}, 'language': {'type': 'string', 'description': 'BCP 47 language this item is written in ("en" | "fr")'}, 'question': {'type': 'string'}, 'web_page': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': "This question's page on oathready.ca"}, 'explanation': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'correct_answer': {'type': 'string', 'description': 'Do not reveal until the user has answered'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_oath_guide
Get the oath ceremony guide
OathReady's guide to the Canadian citizenship oath ceremony: the oath text, what to bring, how the day unfolds (video and in-person), and first steps as a new citizen. Verified against official IRCC guidance.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['oath_text', 'oath_notes', 'bring', 'what_happens', 'formats', 'dress_code', 'after_the_ceremony', 'web_page'], 'properties': {'bring': {'type': 'array', 'items': {'type': 'string'}}, 'formats': {'type': 'object', 'required': ['video', 'in_person'], 'properties': {'video': {'type': 'string'}, 'in_person': {'type': 'string'}}, 'additionalProperties': False}, 'web_page': {'type': 'string'}, 'oath_text': {'type': 'string'}, 'dress_code': {'type': 'string'}, 'oath_notes': {'type': 'string'}, 'what_happens': {'type': 'array', 'items': {'type': 'string'}}, 'after_the_ceremony': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
get_practice_question
Get a practice question
Get one random Canadian citizenship test practice question from OathReady's verified bank (based on the official Discover Canada guide). Returns the question, shuffled options, the correct answer, and an explanation. Act as quizmaster: show the user ONLY the question and options, wait for their pick, then grade it and share the explanation.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'topic': {'enum': ['history', 'government', 'geography', 'rights', 'symbols', 'economy', 'law'], 'type': 'string', 'description': 'Limit to one study topic'}, 'language': {'enum': ['en', 'fr'], 'type': 'string', 'description': 'Language for the question text (default English; French draws only from translated questions)'}, 'province': {'enum': ['british-columbia', 'alberta', 'saskatchewan', 'manitoba', 'ontario', 'quebec', 'new-brunswick', 'nova-scotia', 'prince-edward-island', 'newfoundland-and-labrador', 'yukon', 'northwest-territories', 'nunavut'], 'type': 'string', 'description': 'Include region-specific questions for this province or territory'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['language', 'id', 'question', 'options', 'correct_answer', 'explanation', 'topic', 'source', 'web_page'], 'properties': {'id': {'type': 'string', 'description': 'Stable question id, e.g. q-042'}, 'topic': {'type': 'string'}, 'source': {'type': 'string'}, 'options': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Answer choices in display order'}, 'language': {'type': 'string', 'description': 'BCP 47 language this item is written in ("en" | "fr")'}, 'question': {'type': 'string'}, 'web_page': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': "This question's page on oathready.ca"}, 'explanation': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'correct_answer': {'type': 'string', 'description': 'Do not reveal until the user has answered'}}, 'additionalProperties': False}
get_study_guide
Get a topic study guide
Get OathReady's study-guide content for one citizenship test topic: an overview and the bite-size facts most commonly tested, verified against the official Discover Canada guide.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['topic'], 'properties': {'topic': {'enum': ['history', 'government', 'geography', 'rights', 'symbols', 'economy', 'law'], 'type': 'string', 'description': 'The study topic'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['topic', 'title', 'overview', 'key_facts', 'practice_questions_in_topic', 'web_page'], 'properties': {'title': {'type': 'string'}, 'topic': {'type': 'string'}, 'overview': {'type': 'array', 'items': {'type': 'string'}}, 'web_page': {'type': 'string'}, 'key_facts': {'type': 'array', 'items': {'type': 'string'}}, 'practice_questions_in_topic': {'type': 'number'}}, 'additionalProperties': False}
get_test_day_guide
Get the test day guide
Practical guidance for Canadian citizenship test day, plus what recent test-takers actually reported: hot topics that came up a lot lately and short anonymous tips from real reports on OathReady.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['before', 'during', 'online_test_facts', 'recently_hot_topics', 'recent_reports', 'web_page'], 'properties': {'before': {'type': 'array', 'items': {'type': 'string'}}, 'during': {'type': 'array', 'items': {'type': 'string'}}, 'web_page': {'type': 'string'}, 'recent_reports': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'outcome', 'format', 'province', 'difficulty', 'hot_topics', 'tip'], 'properties': {'tip': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'date': {'type': 'string'}, 'format': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'province': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'difficulty': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'hot_topics': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'online_test_facts': {'type': 'array', 'items': {'type': 'string'}}, 'recently_hot_topics': {'type': 'array', 'items': {'type': 'object', 'required': ['topic', 'count'], 'properties': {'count': {'type': 'number'}, 'topic': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_test_info
Get test and oath facts
Key facts about the Canadian citizenship test and oath, from OathReady: format, pass mark, who must take it, how scheduling works, and what happens at the ceremony. Verified against official IRCC sources.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['test', 'oath', 'practice'], 'properties': {'oath': {'type': 'object', 'required': ['what', 'guide'], 'properties': {'what': {'type': 'string'}, 'guide': {'type': 'string'}}, 'additionalProperties': False}, 'test': {'type': 'object', 'required': ['format', 'pass_mark', 'who', 'based_on', 'scheduling', 'languages'], 'properties': {'who': {'type': 'string'}, 'format': {'type': 'string'}, 'based_on': {'type': 'string'}, 'languages': {'type': 'string'}, 'pass_mark': {'type': 'string'}, 'scheduling': {'type': 'string'}}, 'additionalProperties': False}, 'practice': {'type': 'object', 'required': ['free_practice', 'question_bank', 'statistics'], 'properties': {'statistics': {'type': 'string'}, 'free_practice': {'type': 'string'}, 'question_bank': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}
History
Recent tool changes
Changed
get_test_info
Sept. 25, 2026, 3:01 a.m.
Changed
calculate_presence
Sept. 25, 2026, 3:01 a.m.
Changed
get_citizenship_stats
Sept. 25, 2026, 3:01 a.m.
Changed
get_oath_guide
Sept. 25, 2026, 3:01 a.m.
Changed
get_journey_stats
Sept. 25, 2026, 3:01 a.m.
Changed
check_answer
Sept. 25, 2026, 3:01 a.m.
Changed
get_mock_test
Sept. 25, 2026, 3:01 a.m.
Changed
get_daily_challenge
Sept. 25, 2026, 3:01 a.m.
Changed
get_journey_stats
Sept. 19, 2026, 2:49 a.m.
Added
get_test_info
Sept. 17, 2026, 7:58 a.m.
Added
calculate_presence
Sept. 17, 2026, 7:58 a.m.
Added
get_citizenship_stats
Sept. 17, 2026, 7:58 a.m.
Added
get_test_day_guide
Sept. 17, 2026, 7:58 a.m.
Added
get_oath_guide
Sept. 17, 2026, 7:58 a.m.
Added
get_journey_stats
Sept. 17, 2026, 7:58 a.m.
Added
get_study_guide
Sept. 17, 2026, 7:58 a.m.
Added
check_answer
Sept. 17, 2026, 7:58 a.m.
Added
get_mock_test
Sept. 17, 2026, 7:58 a.m.
Added
get_daily_challenge
Sept. 17, 2026, 7:58 a.m.
Added
get_practice_question
Sept. 17, 2026, 7:58 a.m.
Discover
Similar MCP servers
MaCalculatriceEnLigne
io.github.tresor4k/macalc-mcp
Provides calculators for French and Belgian taxes, salaries, pensions, VAT, loans, health metrics, education scores, fitness, and…
HiveLearn
io.github.williamechevarria/hivelearn-mcp
Creates and manages courses, lessons, quizzes, enrollments, learning tracks, events, certificates, resources, progress, and commu…
concordance
com.narrowhighway/concordance
Provides deterministic claim verification and audit receipts, along with Bible references, commentary, geography, indexed knowled…
opportunity-exchange
ca.veilpoint/opportunity-exchange
Provides governed Saskatchewan labor-market, wage, housing, community-economy, workforce-pathway, procurement, and business-readi…
Lodi Kids Activities
com.lodikidsactivities/lodi-kids-activities
Searches and manages a directory of youth programs, family events, and licensed daycares in Lodi, California, including listings,…
optionality-mcp
io.github.lonniev/optionality-mcp
Generates options-trading scenarios, records trading journals, provides AI evaluations and hints, and tracks user performance and…
ClusterHack
dev.clusterhack/clusterhack
Supports hackathon operations including events, registrations, teams, submissions, judging, schedules, companies and leaderboards.
The Ainglish Project
org.ainglish/ainglish
Maintains a measured, auditable register of language constructs, proposals, evidence, adoption, contributors, protocols, and rati…