Look up Japanese national exam dates (MHLW list)
exam_schedule_lookupWhen is this Japanese national exam held and when are results announced, as published on MHLW's list page, and did the dates change? Give exam (exam_id like nurse, or the name in Japanese or English); omit it to list exams, optionally by category. Returns next_events and all events with ISO dates, revision_status, revisions (before and after), possibly_stale, retrieved_at and source. Application periods are not covered. Confirm on the official exam page.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "exam_schedule_lookup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| exam | No | exam_id (e.g. nurse, pharmacist, certified-social-worker) or exam name in Japanese (看護師国家試験, 看護師) or English | |
| limit | No | Maximum number of exams when listing, 1-120 (default 50) | |
| category | No | Optional filter when listing: medical (Medical, pharmaceutical, health and food sanitation), occupational_safety (Technical, occupational safety and health), beauty_health (Beauty and health), welfare_care (Welfare and long-term care) | |
| include_undated | No | When listing, also include exams for which the page gives no dates (default false) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| exams | Yes | ||
| query | Yes | ||
| terms | Yes | URL of the terms of service. | |
| total | Yes | ||
| source | Yes | Where the answer comes from: MHLW's list page, when this service last read it, and the page version used. | |
| status | Yes | listed = on the current list page; no_longer_listed_since = seen earlier by this service, not on the current page (reason not stated); not_found_in_checked_records = not on the page nor seen leaving it since tracking_since; unknown = page not loaded or stale, or only partial-name candidates (unknown_reason). | |
| today_jst | Yes | ||
| truncated | Yes | ||
| candidates | Yes | Partial-name candidates when no exam has exactly this name or id. Not matches. | |
| provenance | Yes | Freshness receipts for every upstream source used. | |
| answered_at | Yes | ||
| attribution | Yes | ||
| status_note | Yes | ||
| legal_notice | Yes | ||
| official_check | Yes | Read first: dates as published on MHLW's list page at retrieved_at; confirm on the official exam page before applying. | |
| unknown_reason | Yes | ||
| registry_status | Yes | The common registry status section shared across this operator's servers. Null when listing without an exam query. |