International Classifications MCP
Deterministic MCP for statistical classifications and survey codelists with provenance.
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"international-classifications": {
"url": "https://classifications.impactengines.ai/mcp"
}
}
}リモートエンドポイント
https://classifications.impactengines.ai/mcpstreamable-httpできること
ツール一覧
ツール(10)
🟢list_classifications(domain, status)
List classification families, versions, custodians, coverage and licensing notes. Start here when the correct standard is unknown.
入力スキーマ
{
"type": "object",
"properties": {
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Domain"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
}
},
"title": "list_classificationsArguments"
}出力スキーマ
{
"type": "object",
"properties": {
"result": {
"items": {
"$ref": "#/$defs/ClassificationSummary"
},
"title": "Result",
"type": "array"
}
},
"required": [
"result"
],
"$defs": {
"ClassificationSummary": {
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"version": {
"title": "Version",
"type": "string"
},
"acronym": {
"title": "Acronym",
"type": "string"
},
"custodian": {
"title": "Custodian",
"type": "string"
},
"domain": {
"title": "Domain",
"type": "string"
},
"status": {
"title": "Status",
"type": "string"
},
"coverage": {
"title": "Coverage",
"type": "string"
},
"code_count": {
"default": 0,
"title": "Code Count",
"type": "integer"
},
"description": {
"title": "Description",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"licence_note": {
"title": "Licence Note",
"type": "string"
}
},
"required": [
"id",
"name",
"version",
"acronym",
"custodian",
"domain",
"status",
"coverage",
"description",
"source_url",
"licence_note"
],
"title": "ClassificationSummary",
"type": "object"
}
},
"title": "list_classificationsOutput"
}🟢get_classification(classification_id)
Get authoritative metadata and coverage for one classification_id returned by list_classifications.
入力スキーマ
{
"type": "object",
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
}
},
"required": [
"classification_id"
],
"title": "get_classificationArguments"
}出力スキーマ
{
"type": "object",
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"version": {
"title": "Version",
"type": "string"
},
"acronym": {
"title": "Acronym",
"type": "string"
},
"custodian": {
"title": "Custodian",
"type": "string"
},
"domain": {
"title": "Domain",
"type": "string"
},
"status": {
"title": "Status",
"type": "string"
},
"coverage": {
"title": "Coverage",
"type": "string"
},
"code_count": {
"default": 0,
"title": "Code Count",
"type": "integer"
},
"description": {
"title": "Description",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"licence_note": {
"title": "Licence Note",
"type": "string"
}
},
"required": [
"id",
"name",
"version",
"acronym",
"custodian",
"domain",
"status",
"coverage",
"description",
"source_url",
"licence_note"
],
"title": "ClassificationSummary"
}🟢list_codelists(classification_id)
List independent option lists within a classification before searching or exporting one list.
入力スキーマ
{
"type": "object",
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
}
},
"required": [
"classification_id"
],
"title": "list_codelistsArguments"
}出力スキーマ
{
"type": "object",
"properties": {
"result": {
"items": {
"$ref": "#/$defs/CodelistSummary"
},
"title": "Result",
"type": "array"
}
},
"required": [
"result"
],
"$defs": {
"CodelistSummary": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"codelist_id": {
"title": "Codelist Id",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"concept": {
"title": "Concept",
"type": "string"
},
"source_version": {
"title": "Source Version",
"type": "string"
},
"option_count": {
"title": "Option Count",
"type": "integer"
},
"warning": {
"title": "Warning",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
}
},
"required": [
"classification_id",
"codelist_id",
"title",
"concept",
"source_version",
"option_count",
"warning",
"source_url"
],
"title": "CodelistSummary",
"type": "object"
}
},
"title": "list_codelistsOutput"
}🟢recommend_classifications(question_text, answer_options, survey_context, limit)
Return a deterministic ranked shortlist of all relevant classification concepts and codelists. Ranking supports user choice; it is not an automatic selection. Include answer options and context.
入力スキーマ
{
"type": "object",
"properties": {
"question_text": {
"title": "Question Text",
"type": "string"
},
"answer_options": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Answer Options"
},
"survey_context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Survey Context"
},
"limit": {
"default": 5,
"maximum": 20,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"required": [
"question_text"
],
"title": "recommend_classificationsArguments"
}出力スキーマ
{
"type": "object",
"properties": {
"recommendations": {
"items": {
"$ref": "#/$defs/ClassificationRecommendation"
},
"title": "Recommendations",
"type": "array"
},
"warnings": {
"items": {
"type": "string"
},
"title": "Warnings",
"type": "array"
},
"next_action": {
"title": "Next Action",
"type": "string"
}
},
"required": [
"recommendations",
"next_action"
],
"$defs": {
"ClassificationRecommendation": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"concept": {
"title": "Concept",
"type": "string"
},
"score": {
"title": "Score",
"type": "number"
},
"confidence": {
"enum": [
"high",
"medium",
"low"
],
"title": "Confidence",
"type": "string"
},
"matched_evidence": {
"items": {
"type": "string"
},
"title": "Matched Evidence",
"type": "array"
},
"reason": {
"title": "Reason",
"type": "string"
},
"usage_mode": {
"title": "Usage Mode",
"type": "string"
},
"classification_version": {
"title": "Classification Version",
"type": "string"
},
"source_title": {
"title": "Source Title",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"codelist_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Id"
},
"codelist_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Title"
}
},
"required": [
"classification_id",
"name",
"concept",
"score",
"confidence",
"matched_evidence",
"reason",
"usage_mode",
"classification_version",
"source_title",
"source_url"
],
"title": "ClassificationRecommendation",
"type": "object"
}
},
"title": "RecommendationResponse"
}🟢search_codes(query, classification_ids, codelist_id, limit)
Full-text search labels and notes. Results restrict to one option list only when codelist_id is explicitly supplied.
入力スキーマ
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"classification_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Classification Ids"
},
"codelist_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Id"
},
"limit": {
"default": 20,
"maximum": 100,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"required": [
"query"
],
"title": "search_codesArguments"
}出力スキーマ
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"total": {
"title": "Total",
"type": "integer"
},
"results": {
"items": {
"$ref": "#/$defs/CodeItem"
},
"title": "Results",
"type": "array"
},
"warnings": {
"items": {
"type": "string"
},
"title": "Warnings",
"type": "array"
}
},
"required": [
"query",
"total",
"results"
],
"$defs": {
"CodeItem": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"code": {
"title": "Code",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
},
"level": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Level"
},
"parent_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent Code"
},
"definition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Definition"
},
"includes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Includes"
},
"excludes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Excludes"
},
"language": {
"default": "en",
"title": "Language",
"type": "string"
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Score"
},
"classification_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Classification Version"
},
"source_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Title"
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Url"
},
"codelist_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Id"
},
"node_kind": {
"default": "code",
"enum": [
"code",
"codelist"
],
"title": "Node Kind",
"type": "string"
}
},
"required": [
"classification_id",
"code",
"label"
],
"title": "CodeItem",
"type": "object"
}
},
"title": "SearchResponse"
}🟢get_code_definition(classification_id, code)
Retrieve one exact code or codelist container, including its node_kind, hierarchy position and explanatory notes.
入力スキーマ
{
"type": "object",
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"code": {
"title": "Code",
"type": "string"
}
},
"required": [
"classification_id",
"code"
],
"title": "get_code_definitionArguments"
}出力スキーマ
{
"type": "object",
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"code": {
"title": "Code",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
},
"level": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Level"
},
"parent_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent Code"
},
"definition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Definition"
},
"includes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Includes"
},
"excludes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Excludes"
},
"language": {
"default": "en",
"title": "Language",
"type": "string"
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Score"
},
"classification_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Classification Version"
},
"source_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Title"
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Url"
},
"codelist_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Id"
},
"node_kind": {
"default": "code",
"enum": [
"code",
"codelist"
],
"title": "Node Kind",
"type": "string"
}
},
"required": [
"classification_id",
"code",
"label"
],
"title": "CodeItem"
}🟢browse_hierarchy(classification_id, parent_code, limit)
Browse top-level nodes or immediate children. Curated families return node_kind=codelist containers at root; pass that code as parent_code to browse its options.
入力スキーマ
{
"type": "object",
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"parent_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent Code"
},
"limit": {
"default": 200,
"maximum": 500,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"required": [
"classification_id"
],
"title": "browse_hierarchyArguments"
}出力スキーマ
{
"type": "object",
"properties": {
"result": {
"items": {
"$ref": "#/$defs/CodeItem"
},
"title": "Result",
"type": "array"
}
},
"required": [
"result"
],
"$defs": {
"CodeItem": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"code": {
"title": "Code",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
},
"level": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Level"
},
"parent_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent Code"
},
"definition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Definition"
},
"includes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Includes"
},
"excludes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Excludes"
},
"language": {
"default": "en",
"title": "Language",
"type": "string"
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Score"
},
"classification_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Classification Version"
},
"source_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Title"
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Url"
},
"codelist_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Id"
},
"node_kind": {
"default": "code",
"enum": [
"code",
"codelist"
],
"title": "Node Kind",
"type": "string"
}
},
"required": [
"classification_id",
"code",
"label"
],
"title": "CodeItem",
"type": "object"
}
},
"title": "browse_hierarchyOutput"
}🟢validate_codes(classification_id, codes)
Validate exact codes against one named classification version.
入力スキーマ
{
"type": "object",
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"codes": {
"items": {
"type": "string"
},
"minItems": 1,
"title": "Codes",
"type": "array"
}
},
"required": [
"classification_id",
"codes"
],
"title": "validate_codesArguments"
}出力スキーマ
{
"type": "object",
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"valid_count": {
"title": "Valid Count",
"type": "integer"
},
"invalid_count": {
"title": "Invalid Count",
"type": "integer"
},
"results": {
"items": {
"$ref": "#/$defs/ValidationItem"
},
"title": "Results",
"type": "array"
}
},
"required": [
"classification_id",
"valid_count",
"invalid_count",
"results"
],
"$defs": {
"CodeItem": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"code": {
"title": "Code",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
},
"level": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Level"
},
"parent_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent Code"
},
"definition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Definition"
},
"includes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Includes"
},
"excludes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Excludes"
},
"language": {
"default": "en",
"title": "Language",
"type": "string"
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Score"
},
"classification_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Classification Version"
},
"source_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Title"
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Url"
},
"codelist_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Id"
},
"node_kind": {
"default": "code",
"enum": [
"code",
"codelist"
],
"title": "Node Kind",
"type": "string"
}
},
"required": [
"classification_id",
"code",
"label"
],
"title": "CodeItem",
"type": "object"
},
"ValidationItem": {
"properties": {
"input_code": {
"title": "Input Code",
"type": "string"
},
"valid": {
"title": "Valid",
"type": "boolean"
},
"item": {
"anyOf": [
{
"$ref": "#/$defs/CodeItem"
},
{
"type": "null"
}
],
"default": null
},
"message": {
"title": "Message",
"type": "string"
}
},
"required": [
"input_code",
"valid",
"message"
],
"title": "ValidationItem",
"type": "object"
}
},
"title": "ValidationResponse"
}🟢map_codes(source_classification_id, target_classification_id, codes)
Apply official stored correspondences and expose splits, merges, changed meanings and unmapped codes. Never assume one-to-one equivalence.
入力スキーマ
{
"type": "object",
"properties": {
"source_classification_id": {
"title": "Source Classification Id",
"type": "string"
},
"target_classification_id": {
"title": "Target Classification Id",
"type": "string"
},
"codes": {
"items": {
"type": "string"
},
"minItems": 1,
"title": "Codes",
"type": "array"
}
},
"required": [
"source_classification_id",
"target_classification_id",
"codes"
],
"title": "map_codesArguments"
}出力スキーマ
{
"type": "object",
"properties": {
"source_classification": {
"title": "Source Classification",
"type": "string"
},
"target_classification": {
"title": "Target Classification",
"type": "string"
},
"results": {
"items": {
"$ref": "#/$defs/MappingItem"
},
"title": "Results",
"type": "array"
},
"sources": {
"items": {
"$ref": "#/$defs/Citation"
},
"title": "Sources",
"type": "array"
},
"warnings": {
"items": {
"type": "string"
},
"title": "Warnings",
"type": "array"
}
},
"required": [
"source_classification",
"target_classification",
"results"
],
"$defs": {
"Citation": {
"properties": {
"title": {
"title": "Title",
"type": "string"
},
"url": {
"title": "Url",
"type": "string"
},
"custodian": {
"title": "Custodian",
"type": "string"
},
"retrieved_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Retrieved At"
}
},
"required": [
"title",
"url",
"custodian"
],
"title": "Citation",
"type": "object"
},
"MappingItem": {
"properties": {
"source_code": {
"title": "Source Code",
"type": "string"
},
"target_codes": {
"items": {
"type": "string"
},
"title": "Target Codes",
"type": "array"
},
"relationship": {
"title": "Relationship",
"type": "string"
},
"official": {
"title": "Official",
"type": "boolean"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Note"
}
},
"required": [
"source_code",
"target_codes",
"relationship",
"official"
],
"title": "MappingItem",
"type": "object"
}
},
"title": "MappingResponse"
}🟢export_choice_list(classification_id, level, codelist_id, format, limit)
Return a structured choice list at a selected hierarchy level. MICS exports require one codelist_id and never merge unrelated answer lists.
入力スキーマ
{
"type": "object",
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"level": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Level"
},
"codelist_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Id"
},
"format": {
"default": "xlsform",
"enum": [
"xlsform",
"simple"
],
"title": "Format",
"type": "string"
},
"limit": {
"default": 1000,
"maximum": 10000,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"required": [
"classification_id"
],
"title": "export_choice_listArguments"
}出力スキーマ
{
"type": "object",
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"codelist_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Id"
},
"codelist_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Title"
},
"option_count": {
"title": "Option Count",
"type": "integer"
},
"level": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Level"
},
"format": {
"title": "Format",
"type": "string"
},
"rows": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Rows",
"type": "array"
},
"warning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Warning"
}
},
"required": [
"classification_id",
"option_count",
"level",
"format",
"rows"
],
"title": "ChoiceListResponse"
}コミュニティ
エビデンス