MCP-Server
OathReady: Canadian Citizenship Test
ca.oathready/citizenship-test
Was dieses MCP kann
Provides Canadian citizenship test practice, mock exams, study guides, eligibility calculations, ceremony information, and related IRCC statistics.
Funktionen
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.
Nur Lesen
Idempotent
Eingabeschema
{'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'}}}
Ausgabeschema
{'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.
Nur Lesen
Idempotent
Eingabeschema
{'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'}}}
Ausgabeschema
{'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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Ausgabeschema
{'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).
Nur Lesen
Idempotent
Eingabeschema
{'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)'}}}
Ausgabeschema
{'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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Ausgabeschema
{'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.
Nur Lesen
Eingabeschema
{'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'}}}
Ausgabeschema
{'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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Ausgabeschema
{'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.
Nur Lesen
Eingabeschema
{'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'}}}
Ausgabeschema
{'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.
Nur Lesen
Idempotent
Eingabeschema
{'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'}}}
Ausgabeschema
{'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.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Ausgabeschema
{'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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Ausgabeschema
{'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}
Verlauf
Letzte Tool-Änderungen
Geändert
get_test_info
25. September 2026 03:01
Geändert
calculate_presence
25. September 2026 03:01
Geändert
get_citizenship_stats
25. September 2026 03:01
Geändert
get_oath_guide
25. September 2026 03:01
Geändert
get_journey_stats
25. September 2026 03:01
Geändert
check_answer
25. September 2026 03:01
Geändert
get_mock_test
25. September 2026 03:01
Geändert
get_daily_challenge
25. September 2026 03:01
Geändert
get_journey_stats
19. September 2026 02:49
Hinzugefügt
get_test_info
17. September 2026 07:58
Hinzugefügt
calculate_presence
17. September 2026 07:58
Hinzugefügt
get_citizenship_stats
17. September 2026 07:58
Hinzugefügt
get_test_day_guide
17. September 2026 07:58
Hinzugefügt
get_oath_guide
17. September 2026 07:58
Hinzugefügt
get_journey_stats
17. September 2026 07:58
Hinzugefügt
get_study_guide
17. September 2026 07:58
Hinzugefügt
check_answer
17. September 2026 07:58
Hinzugefügt
get_mock_test
17. September 2026 07:58
Hinzugefügt
get_daily_challenge
17. September 2026 07:58
Hinzugefügt
get_practice_question
17. September 2026 07:58
Entdecken
Ähnliche MCP-Server
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…