MCP 服务器

OathReady: Canadian Citizenship Test

ca.oathready/citizenship-test
教育 公开且可连接 MCP 2025-11-25

此 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.
只读 幂等
输入模式
{'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'}}}
输出模式
{'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.
只读 幂等
输入模式
{'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'}}}
输出模式
{'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.
只读 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'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).
只读 幂等
输入模式
{'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)'}}}
输出模式
{'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.
只读 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'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.
只读
输入模式
{'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'}}}
输出模式
{'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.
只读 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'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.
只读
输入模式
{'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'}}}
输出模式
{'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.
只读 幂等
输入模式
{'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'}}}
输出模式
{'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.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'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.
只读 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'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}
已更改
get_test_info
2026年9月25日 03:01
已更改
calculate_presence
2026年9月25日 03:01
已更改
get_citizenship_stats
2026年9月25日 03:01
已更改
get_oath_guide
2026年9月25日 03:01
已更改
get_journey_stats
2026年9月25日 03:01
已更改
check_answer
2026年9月25日 03:01
已更改
get_mock_test
2026年9月25日 03:01
已更改
get_daily_challenge
2026年9月25日 03:01
已更改
get_journey_stats
2026年9月19日 02:49
已添加
get_test_info
2026年9月17日 07:58
已添加
calculate_presence
2026年9月17日 07:58
已添加
get_citizenship_stats
2026年9月17日 07:58
已添加
get_test_day_guide
2026年9月17日 07:58
已添加
get_oath_guide
2026年9月17日 07:58
已添加
get_journey_stats
2026年9月17日 07:58
已添加
get_study_guide
2026年9月17日 07:58
已添加
check_answer
2026年9月17日 07:58
已添加
get_mock_test
2026年9月17日 07:58
已添加
get_daily_challenge
2026年9月17日 07:58
已添加
get_practice_question
2026年9月17日 07:58