Japan Drug Supply Status Relay
Is this drug's shipment normal, limited or suspended in Japan (MHLW)? Hosted, history kept.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~4,365Tokens (tool definitions)
~12.9 KBTypical response size
Significant attention impact (3.41% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"jp-drug-supply": {
"url": "https://jp-drug-supply-production.mk-career-planning.workers.dev/mcp"
}
}
}Remote endpoints
https://jp-drug-supply-production.mk-career-planning.workers.dev/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
๐ข Read-only๐ก Write๐ด Deleteโช Unknown
๐ขcatalog
List the tools of this server with prices, data sources, licensing, daily limits and data freshness.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"server": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"version": {
"type": "string"
},
"stage": {
"type": "string"
}
},
"required": [
"name",
"version",
"stage"
],
"additionalProperties": {}
},
"payment": {
"type": "object",
"properties": {
"protocol": {
"type": "string"
},
"network": {
"type": "string"
},
"asset": {
"type": "string"
},
"enabled": {
"type": "boolean"
}
},
"required": [
"protocol",
"network",
"asset",
"enabled"
],
"additionalProperties": {}
},
"daily_limits": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "Daily limits of paid calls (calls, usd, timezone) or a misconfiguration notice."
},
"paused": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "boolean"
},
"description": "Operator pause flags (true = paused)."
},
"tools": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"price_usd": {
"type": "number",
"description": "Price per call in USD (0 = free)."
},
"description": {
"type": "string"
}
},
"required": [
"name",
"price_usd",
"description"
],
"additionalProperties": {}
},
"description": "Every tool of this server with its price."
},
"legal": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"fetch_status_values": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"publisher": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"publisher",
"url"
],
"additionalProperties": {},
"description": "Publisher and URL of the upstream document or dataset."
},
"upstream_updated_at": {
"description": "Update time stated by the upstream, or null when it states none.",
"type": [
"string",
"null"
]
},
"retrieved_at": {
"description": "When this service retrieved the upstream data (null if unknown).",
"type": [
"string",
"null"
]
},
"content_sha256": {
"type": [
"string",
"null"
]
},
"parser_version": {
"type": "string"
},
"fetch_status": {
"type": "string",
"enum": [
"found",
"empty",
"stale",
"unavailable",
"unsupported"
],
"description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
},
"processed_by": {
"type": "string"
}
},
"required": [
"source",
"upstream_updated_at",
"retrieved_at",
"content_sha256",
"parser_version",
"fetch_status",
"processed_by"
],
"additionalProperties": {},
"description": "Freshness receipt for one upstream source."
},
"description": "Freshness receipts for every upstream source used."
},
"terms": {
"type": "string",
"description": "URL of the terms of service."
}
},
"required": [
"server",
"payment",
"daily_limits",
"paused",
"tools",
"legal",
"terms"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}๐ขdrug_supply_status(query, max_results)
What shipment status has MHLW published for this prescription drug in Japan? Look up by YJ code, NHI price list code, or Japanese product or ingredient name. Returns the shipment status as published by MHLW (normal, limited shipment and its sub-category, supply suspended) with English labels as our translation, reason, outlook, manufacturer, MHLW dates and the previous status observed by this service. Relay only: not medical advice, not a statement about any pharmacy's stock.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 100,
"description": "YJ code (12 characters, e.g. 4419002B1033), NHI price list code, or a Japanese product or ingredient name, e.g. 'ใญใญใฝใใณ' or 'ใขใปใใขใใใใงใณ'"
},
"max_results": {
"description": "Maximum number of products to return, 1-50 (default 20)",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"query": {
"type": "object",
"properties": {
"query": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"code",
"name"
]
}
},
"required": [
"query",
"kind"
],
"additionalProperties": {}
},
"status": {
"type": "string",
"enum": [
"found",
"matches",
"candidates",
"not_in_current_list",
"no_match_in_checked_list",
"unknown"
],
"description": "found = the YJ code is in the list; matches = products whose name or ingredient contains the query; candidates = similarly spelled product names (not matches); not_in_current_list = the code was in an earlier version observed here but not in the current one; no_match_in_checked_list = nothing matched in the version checked; unknown = data stale, still loading or unreadable."
},
"unknown_reason": {
"type": [
"string",
"null"
]
},
"interpretation": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"yj_code": {
"type": "string"
},
"product_name_ja": {
"type": [
"string",
"null"
]
},
"manufacturer_ja": {
"type": [
"string",
"null"
]
},
"shipment_status": {
"anyOf": [
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "This service's code for the MHLW category, e.g. limited_shipment_own_circumstances."
},
"group": {
"anyOf": [
{
"type": "string",
"enum": [
"normal",
"limited",
"suspended"
]
},
{
"type": "null"
}
]
},
"ja": {
"type": "string",
"description": "The value exactly as published by MHLW."
},
"en": {
"description": "English label: this service's translation, not official MHLW wording.",
"type": [
"string",
"null"
]
}
},
"required": [
"code",
"group",
"ja",
"en"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"status_statement": {
"type": "string"
},
"status_updated_on": {
"type": [
"string",
"null"
]
},
"history": {
"anyOf": [
{
"type": "object",
"properties": {
"tracking_since": {
"type": "string"
},
"current_status_observed_since": {
"type": "string"
},
"previous_status": {
"anyOf": [
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "This service's code for the MHLW category, e.g. limited_shipment_own_circumstances."
},
"group": {
"anyOf": [
{
"type": "string",
"enum": [
"normal",
"limited",
"suspended"
]
},
{
"type": "null"
}
]
},
"ja": {
"type": "string",
"description": "The value exactly as published by MHLW."
},
"en": {
"description": "English label: this service's translation, not official MHLW wording.",
"type": [
"string",
"null"
]
}
},
"required": [
"code",
"group",
"ja",
"en"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"required": [
"tracking_since",
"current_status_observed_since",
"previous_status"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"source": {
"type": "object",
"properties": {
"page_url": {
"type": "string"
},
"xlsx_url": {
"type": "string"
},
"as_of_date": {
"type": [
"string",
"null"
]
}
},
"required": [
"page_url",
"xlsx_url",
"as_of_date"
],
"additionalProperties": {}
},
"match": {
"type": "object",
"properties": {
"match_type": {
"type": "string",
"enum": [
"code",
"name_exact",
"name_prefix",
"name_contains",
"ingredient_contains",
"name_all_words",
"fuzzy_name"
]
},
"score": {
"type": "number"
}
},
"required": [
"match_type",
"score"
],
"additionalProperties": {}
}
},
"required": [
"yj_code",
"product_name_ja",
"manufacturer_ja",
"shipment_status",
"status_statement",
"status_updated_on",
"history",
"source",
"match"
],
"additionalProperties": {}
},
"description": "Products with their shipment status as published by MHLW. Not a suggestion of other products."
},
"items_total": {
"type": "number"
},
"items_truncated": {
"type": "boolean"
},
"removed_item": {
"anyOf": [
{
"type": "object",
"properties": {
"yj_code": {
"type": "string"
},
"missing_since_version_observed_at": {
"type": "string"
}
},
"required": [
"yj_code",
"missing_since_version_observed_at"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"list_version": {
"anyOf": [
{
"type": "object",
"properties": {
"sha256": {
"type": "string"
},
"as_of_date": {
"type": [
"string",
"null"
]
},
"observed_at": {
"type": "string"
}
},
"required": [
"sha256",
"as_of_date",
"observed_at"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"freshness": {
"anyOf": [
{
"type": "object",
"properties": {
"last_successful_check_at": {
"type": [
"string",
"null"
]
},
"stale": {
"type": "boolean"
},
"stale_after_hours": {
"type": "number"
}
},
"required": [
"last_successful_check_at",
"stale",
"stale_after_hours"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"history": {
"type": "object",
"properties": {
"tracking_since": {
"type": [
"string",
"null"
]
},
"note": {
"type": "string"
}
},
"required": [
"tracking_since",
"note"
],
"additionalProperties": {}
},
"legal_notice": {
"type": "string"
},
"label_note": {
"type": "string"
},
"not_covered": {
"type": "array",
"items": {
"type": "string"
}
},
"attribution": {
"type": "object",
"properties": {
"source_ja": {
"type": "string"
},
"processed_ja": {
"type": "string"
},
"source_en": {
"type": "string"
},
"terms_url": {
"type": "string"
},
"license_url": {
"type": "string"
},
"license_note": {
"type": "string"
}
},
"required": [
"source_ja",
"processed_ja",
"source_en",
"terms_url",
"license_url",
"license_note"
],
"additionalProperties": {}
},
"answered_at": {
"type": "string"
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"publisher": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"publisher",
"url"
],
"additionalProperties": {},
"description": "Publisher and URL of the upstream document or dataset."
},
"upstream_updated_at": {
"description": "Update time stated by the upstream, or null when it states none.",
"type": [
"string",
"null"
]
},
"retrieved_at": {
"description": "When this service retrieved the upstream data (null if unknown).",
"type": [
"string",
"null"
]
},
"content_sha256": {
"type": [
"string",
"null"
]
},
"parser_version": {
"type": "string"
},
"fetch_status": {
"type": "string",
"enum": [
"found",
"empty",
"stale",
"unavailable",
"unsupported"
],
"description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
},
"processed_by": {
"type": "string"
}
},
"required": [
"source",
"upstream_updated_at",
"retrieved_at",
"content_sha256",
"parser_version",
"fetch_status",
"processed_by"
],
"additionalProperties": {},
"description": "Freshness receipt for one upstream source."
},
"description": "Freshness receipts for every upstream source used."
},
"terms": {
"type": "string",
"description": "URL of the terms of service."
}
},
"required": [
"query",
"status",
"unknown_reason",
"interpretation",
"items",
"items_total",
"items_truncated",
"removed_item",
"list_version",
"freshness",
"history",
"legal_notice",
"label_note",
"not_covered",
"attribution",
"answered_at",
"provenance",
"terms"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}๐ขdrug_supply_changes(since, yj_code, change_type, limit)
Which products in the Japan MHLW supply status list changed status, or were added, removed or modified, since a date? From this service's own record of list versions (MHLW publishes only the current list). Each change has the YJ code, product, status before and after (as published, with English labels as our translation) and the versions compared. History starts at tracking_since; nothing earlier was observed. Free: last 30 days (see history_window). Relay only.
Input Schema
{
"type": "object",
"properties": {
"since": {
"type": "string",
"maxLength": 40,
"description": "ISO 8601 date or date-time with time zone, e.g. 2026-10-01 or 2026-10-01T00:00:00Z"
},
"yj_code": {
"description": "Optional filter: YJ code, e.g. 4419002B1033",
"type": "string",
"maxLength": 20
},
"change_type": {
"description": "Optional filter: status_changed, added, removed or modified (other fields only)",
"type": "string",
"enum": [
"status_changed",
"added",
"removed",
"modified"
]
},
"limit": {
"description": "Maximum number of changes, 1-200 (default 100)",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"required": [
"since"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"query": {
"type": "object",
"properties": {
"since": {
"type": "string"
}
},
"required": [
"since"
],
"additionalProperties": {}
},
"tracking_since": {
"description": "When this service downloaded its first list version. Nothing before it was observed.",
"type": [
"string",
"null"
]
},
"history_window": {
"type": "object",
"properties": {
"free_days": {
"type": "number",
"description": "Days of recorded history served free of charge."
},
"requested_since": {
"type": "string",
"description": "The since you asked for (normalized to ISO 8601)."
},
"served_since": {
"type": "string",
"description": "The since actually applied: requested_since, or the start of the free window if requested_since was earlier."
},
"clamped": {
"type": "boolean",
"description": "true when requested_since was earlier than the free window and the answer covers only the window."
},
"older_history": {
"type": "string",
"description": "Status of recorded history older than the free window."
}
},
"required": [
"free_days",
"requested_since",
"served_since",
"clamped",
"older_history"
],
"additionalProperties": {},
"description": "Free history window applied to this answer."
},
"coverage": {
"type": "object",
"properties": {
"since_before_tracking": {
"type": "boolean"
},
"note": {
"type": "string"
},
"versions_in_window": {
"type": "array",
"items": {
"type": "object",
"properties": {
"sha256": {
"type": "string"
}
},
"required": [
"sha256"
],
"additionalProperties": {}
}
}
},
"required": [
"since_before_tracking",
"note",
"versions_in_window"
],
"additionalProperties": {}
},
"changes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"yj_code": {
"type": "string"
},
"change_type": {
"type": "string",
"enum": [
"status_changed",
"added",
"removed",
"modified"
]
},
"status_before": {
"anyOf": [
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "This service's code for the MHLW category, e.g. limited_shipment_own_circumstances."
},
"group": {
"anyOf": [
{
"type": "string",
"enum": [
"normal",
"limited",
"suspended"
]
},
{
"type": "null"
}
]
},
"ja": {
"type": "string",
"description": "The value exactly as published by MHLW."
},
"en": {
"description": "English label: this service's translation, not official MHLW wording.",
"type": [
"string",
"null"
]
}
},
"required": [
"code",
"group",
"ja",
"en"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"status_after": {
"anyOf": [
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "This service's code for the MHLW category, e.g. limited_shipment_own_circumstances."
},
"group": {
"anyOf": [
{
"type": "string",
"enum": [
"normal",
"limited",
"suspended"
]
},
{
"type": "null"
}
]
},
"ja": {
"type": "string",
"description": "The value exactly as published by MHLW."
},
"en": {
"description": "English label: this service's translation, not official MHLW wording.",
"type": [
"string",
"null"
]
}
},
"required": [
"code",
"group",
"ja",
"en"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"list_version": {
"type": "object",
"properties": {
"sha256": {
"type": "string"
}
},
"required": [
"sha256"
],
"additionalProperties": {}
},
"previous_version": {
"type": "object",
"properties": {
"sha256": {
"type": "string"
}
},
"required": [
"sha256"
],
"additionalProperties": {}
}
},
"required": [
"observed_at",
"yj_code",
"change_type",
"status_before",
"status_after",
"list_version",
"previous_version"
],
"additionalProperties": {}
},
"description": "Per-product differences between list versions observed by this service, oldest first."
},
"truncated": {
"type": "boolean"
},
"legal_notice": {
"type": "string"
},
"label_note": {
"type": "string"
},
"history_note": {
"type": "string"
},
"not_covered": {
"type": "array",
"items": {
"type": "string"
}
},
"attribution": {
"type": "object",
"properties": {
"source_ja": {
"type": "string"
},
"processed_ja": {
"type": "string"
},
"source_en": {
"type": "string"
},
"terms_url": {
"type": "string"
},
"license_url": {
"type": "string"
},
"license_note": {
"type": "string"
}
},
"required": [
"source_ja",
"processed_ja",
"source_en",
"terms_url",
"license_url",
"license_note"
],
"additionalProperties": {}
},
"answered_at": {
"type": "string"
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"publisher": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"publisher",
"url"
],
"additionalProperties": {},
"description": "Publisher and URL of the upstream document or dataset."
},
"upstream_updated_at": {
"description": "Update time stated by the upstream, or null when it states none.",
"type": [
"string",
"null"
]
},
"retrieved_at": {
"description": "When this service retrieved the upstream data (null if unknown).",
"type": [
"string",
"null"
]
},
"content_sha256": {
"type": [
"string",
"null"
]
},
"parser_version": {
"type": "string"
},
"fetch_status": {
"type": "string",
"enum": [
"found",
"empty",
"stale",
"unavailable",
"unsupported"
],
"description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
},
"processed_by": {
"type": "string"
}
},
"required": [
"source",
"upstream_updated_at",
"retrieved_at",
"content_sha256",
"parser_version",
"fetch_status",
"processed_by"
],
"additionalProperties": {},
"description": "Freshness receipt for one upstream source."
},
"description": "Freshness receipts for every upstream source used."
},
"terms": {
"type": "string",
"description": "URL of the terms of service."
}
},
"required": [
"query",
"tracking_since",
"history_window",
"coverage",
"changes",
"truncated",
"legal_notice",
"label_note",
"history_note",
"not_covered",
"attribution",
"answered_at",
"provenance",
"terms"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}๐ขget_receipt(receipt_id)
Re-fetch the stored result of a settled paid call by its receipt_id, for when the response was lost after payment. Free. Unknown or unsettled receipt ids return RECEIPT_NOT_FOUND. Results are kept for 90 days after settlement.
Input Schema
{
"type": "object",
"properties": {
"receipt_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "The receipt_id returned with a paid result (\"rcpt_\" + 64 hex characters)."
}
},
"required": [
"receipt_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"receipt_id": {
"type": "string",
"description": "Receipt id of the settled paid call (\"rcpt_\" + 64 hex). Use with get_receipt."
},
"tool": {
"type": "string",
"description": "Name of the paid tool that produced the result."
},
"settled_at": {
"type": [
"string",
"null"
]
},
"payment": {
"type": "object",
"properties": {
"network": {
"type": [
"string",
"null"
]
},
"transaction": {
"type": [
"string",
"null"
]
}
},
"required": [
"network",
"transaction"
],
"additionalProperties": {}
},
"result": {
"description": "The stored result, exactly as returned by the paid call."
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"publisher": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"publisher",
"url"
],
"additionalProperties": {},
"description": "Publisher and URL of the upstream document or dataset."
},
"upstream_updated_at": {
"description": "Update time stated by the upstream, or null when it states none.",
"type": [
"string",
"null"
]
},
"retrieved_at": {
"description": "When this service retrieved the upstream data (null if unknown).",
"type": [
"string",
"null"
]
},
"content_sha256": {
"type": [
"string",
"null"
]
},
"parser_version": {
"type": "string"
},
"fetch_status": {
"type": "string",
"enum": [
"found",
"empty",
"stale",
"unavailable",
"unsupported"
],
"description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
},
"processed_by": {
"type": "string"
}
},
"required": [
"source",
"upstream_updated_at",
"retrieved_at",
"content_sha256",
"parser_version",
"fetch_status",
"processed_by"
],
"additionalProperties": {},
"description": "Freshness receipt for one upstream source."
},
"description": "Freshness receipts for every upstream source used."
},
"terms": {
"type": "string",
"description": "URL of the terms of service."
}
},
"required": [
"receipt_id",
"tool",
"settled_at",
"payment",
"result",
"provenance",
"terms"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}Community
Evidence
Recent observations
verifiedversion not recorded4 tools