Servidor MCP

OathReady: Canadian Citizenship Test

ca.oathready/citizenship-test
Educación Público y accesible MCP 2025-11-25

Qué hace este MCP

Provides Canadian citizenship test practice, mock exams, study guides, eligibility calculations, ceremony information, and related IRCC statistics.

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.
Solo lectura Idempotente
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Esquema de salida
{'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).
Solo lectura Idempotente
Esquema de entrada
{'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)'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Esquema de salida
{'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.
Solo lectura
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Esquema de salida
{'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.
Solo lectura
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Esquema de salida
{'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}
Modificado
get_test_info
25 de September de 2026 a las 03:01
Modificado
calculate_presence
25 de September de 2026 a las 03:01
Modificado
get_citizenship_stats
25 de September de 2026 a las 03:01
Modificado
get_oath_guide
25 de September de 2026 a las 03:01
Modificado
get_journey_stats
25 de September de 2026 a las 03:01
Modificado
check_answer
25 de September de 2026 a las 03:01
Modificado
get_mock_test
25 de September de 2026 a las 03:01
Modificado
get_daily_challenge
25 de September de 2026 a las 03:01
Modificado
get_journey_stats
19 de September de 2026 a las 02:49
Añadido
get_test_info
17 de September de 2026 a las 07:58
Añadido
calculate_presence
17 de September de 2026 a las 07:58
Añadido
get_citizenship_stats
17 de September de 2026 a las 07:58
Añadido
get_test_day_guide
17 de September de 2026 a las 07:58
Añadido
get_oath_guide
17 de September de 2026 a las 07:58
Añadido
get_journey_stats
17 de September de 2026 a las 07:58
Añadido
get_study_guide
17 de September de 2026 a las 07:58
Añadido
check_answer
17 de September de 2026 a las 07:58
Añadido
get_mock_test
17 de September de 2026 a las 07:58
Añadido
get_daily_challenge
17 de September de 2026 a las 07:58
Añadido
get_practice_question
17 de September de 2026 a las 07:58