MCP-Server

International Classifications MCP

io.github.lbruce-wq/international-classifications
Daten & Analytik Wissen & Dokumentation Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Browses, searches, validates, exports, and maps official statistical classifications and survey codelists.

browse_hierarchy
Browse classification hierarchy
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'title': 'browse_hierarchyArguments', 'required': ['classification_id'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 200, 'maximum': 500, 'minimum': 1}, 'parent_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Parent Code', 'default': None}, 'classification_id': {'type': 'string', 'title': 'Classification Id'}}}
Ausgabeschema
{'type': 'object', '$defs': {'CodeItem': {'type': 'object', 'title': 'CodeItem', 'required': ['classification_id', 'code', 'label'], 'properties': {'code': {'type': 'string', 'title': 'Code'}, 'label': {'type': 'string', 'title': 'Label'}, 'level': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Level', 'default': None}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Score', 'default': None}, 'excludes': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Excludes', 'default': None}, 'includes': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Includes', 'default': None}, 'language': {'type': 'string', 'title': 'Language', 'default': 'en'}, 'node_kind': {'enum': ['code', 'codelist'], 'type': 'string', 'title': 'Node Kind', 'default': 'code'}, 'definition': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Definition', 'default': None}, 'source_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Source Url', 'default': None}, 'codelist_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Codelist Id', 'default': None}, 'parent_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Parent Code', 'default': None}, 'source_title': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Source Title', 'default': None}, 'classification_id': {'type': 'string', 'title': 'Classification Id'}, 'classification_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Classification Version', 'default': None}}}}, 'title': 'browse_hierarchyOutput', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'$ref': '#/$defs/CodeItem'}, 'title': 'Result'}}}
export_choice_list
Export a choice list
Return a structured choice list at a selected hierarchy level. MICS exports require one codelist_id and never merge unrelated answer lists.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'title': 'export_choice_listArguments', 'required': ['classification_id'], 'properties': {'level': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Level', 'default': None}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 1000, 'maximum': 10000, 'minimum': 1}, 'format': {'enum': ['xlsform', 'simple'], 'type': 'string', 'title': 'Format', 'default': 'xlsform'}, 'codelist_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Codelist Id', 'default': None}, 'classification_id': {'type': 'string', 'title': 'Classification Id'}}}
Ausgabeschema
{'type': 'object', 'title': 'ChoiceListResponse', 'required': ['classification_id', 'option_count', 'level', 'format', 'rows'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'title': 'Rows'}, 'level': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Level'}, 'format': {'type': 'string', 'title': 'Format'}, 'warning': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Warning', 'default': None}, 'codelist_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Codelist Id', 'default': None}, 'option_count': {'type': 'integer', 'title': 'Option Count'}, 'codelist_title': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Codelist Title', 'default': None}, 'classification_id': {'type': 'string', 'title': 'Classification Id'}}}
get_classification
Get classification metadata
Get authoritative metadata and coverage for one classification_id returned by list_classifications.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'title': 'get_classificationArguments', 'required': ['classification_id'], 'properties': {'classification_id': {'type': 'string', 'title': 'Classification Id'}}}
Ausgabeschema
{'type': 'object', 'title': 'ClassificationSummary', 'required': ['id', 'name', 'version', 'acronym', 'custodian', 'domain', 'status', 'coverage', 'description', 'source_url', 'licence_note'], 'properties': {'id': {'type': 'string', 'title': 'Id'}, 'name': {'type': 'string', 'title': 'Name'}, 'domain': {'type': 'string', 'title': 'Domain'}, 'status': {'type': 'string', 'title': 'Status'}, 'acronym': {'type': 'string', 'title': 'Acronym'}, 'version': {'type': 'string', 'title': 'Version'}, 'coverage': {'type': 'string', 'title': 'Coverage'}, 'custodian': {'type': 'string', 'title': 'Custodian'}, 'code_count': {'type': 'integer', 'title': 'Code Count', 'default': 0}, 'source_url': {'type': 'string', 'title': 'Source Url'}, 'description': {'type': 'string', 'title': 'Description'}, 'licence_note': {'type': 'string', 'title': 'Licence Note'}}}
get_code_definition
Get code definition
Retrieve one exact code or codelist container, including its node_kind, hierarchy position and explanatory notes.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'title': 'get_code_definitionArguments', 'required': ['classification_id', 'code'], 'properties': {'code': {'type': 'string', 'title': 'Code'}, 'classification_id': {'type': 'string', 'title': 'Classification Id'}}}
Ausgabeschema
{'type': 'object', 'title': 'CodeItem', 'required': ['classification_id', 'code', 'label'], 'properties': {'code': {'type': 'string', 'title': 'Code'}, 'label': {'type': 'string', 'title': 'Label'}, 'level': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Level', 'default': None}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Score', 'default': None}, 'excludes': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Excludes', 'default': None}, 'includes': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Includes', 'default': None}, 'language': {'type': 'string', 'title': 'Language', 'default': 'en'}, 'node_kind': {'enum': ['code', 'codelist'], 'type': 'string', 'title': 'Node Kind', 'default': 'code'}, 'definition': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Definition', 'default': None}, 'source_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Source Url', 'default': None}, 'codelist_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Codelist Id', 'default': None}, 'parent_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Parent Code', 'default': None}, 'source_title': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Source Title', 'default': None}, 'classification_id': {'type': 'string', 'title': 'Classification Id'}, 'classification_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Classification Version', 'default': None}}}
list_classifications
List classifications
List classification families, versions, custodians, coverage and licensing notes. Start here when the correct standard is unknown.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'title': 'list_classificationsArguments', 'properties': {'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Domain', 'default': None}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Status', 'default': None}}}
Ausgabeschema
{'type': 'object', '$defs': {'ClassificationSummary': {'type': 'object', 'title': 'ClassificationSummary', 'required': ['id', 'name', 'version', 'acronym', 'custodian', 'domain', 'status', 'coverage', 'description', 'source_url', 'licence_note'], 'properties': {'id': {'type': 'string', 'title': 'Id'}, 'name': {'type': 'string', 'title': 'Name'}, 'domain': {'type': 'string', 'title': 'Domain'}, 'status': {'type': 'string', 'title': 'Status'}, 'acronym': {'type': 'string', 'title': 'Acronym'}, 'version': {'type': 'string', 'title': 'Version'}, 'coverage': {'type': 'string', 'title': 'Coverage'}, 'custodian': {'type': 'string', 'title': 'Custodian'}, 'code_count': {'type': 'integer', 'title': 'Code Count', 'default': 0}, 'source_url': {'type': 'string', 'title': 'Source Url'}, 'description': {'type': 'string', 'title': 'Description'}, 'licence_note': {'type': 'string', 'title': 'Licence Note'}}}}, 'title': 'list_classificationsOutput', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'$ref': '#/$defs/ClassificationSummary'}, 'title': 'Result'}}}
list_codelists
List codelists
List independent option lists within a classification before searching or exporting one list.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'title': 'list_codelistsArguments', 'required': ['classification_id'], 'properties': {'classification_id': {'type': 'string', 'title': 'Classification Id'}}}
Ausgabeschema
{'type': 'object', '$defs': {'CodelistSummary': {'type': 'object', 'title': 'CodelistSummary', 'required': ['classification_id', 'codelist_id', 'title', 'concept', 'source_version', 'option_count', 'warning', 'source_url'], 'properties': {'title': {'type': 'string', 'title': 'Title'}, 'concept': {'type': 'string', 'title': 'Concept'}, 'warning': {'type': 'string', 'title': 'Warning'}, 'source_url': {'type': 'string', 'title': 'Source Url'}, 'codelist_id': {'type': 'string', 'title': 'Codelist Id'}, 'option_count': {'type': 'integer', 'title': 'Option Count'}, 'source_version': {'type': 'string', 'title': 'Source Version'}, 'classification_id': {'type': 'string', 'title': 'Classification Id'}}}}, 'title': 'list_codelistsOutput', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'$ref': '#/$defs/CodelistSummary'}, 'title': 'Result'}}}
map_codes
Map codes between versions
Apply official stored correspondences and expose splits, merges, changed meanings and unmapped codes. Never assume one-to-one equivalence.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'title': 'map_codesArguments', 'required': ['source_classification_id', 'target_classification_id', 'codes'], 'properties': {'codes': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Codes', 'minItems': 1}, 'source_classification_id': {'type': 'string', 'title': 'Source Classification Id'}, 'target_classification_id': {'type': 'string', 'title': 'Target Classification Id'}}}
Ausgabeschema
{'type': 'object', '$defs': {'Citation': {'type': 'object', 'title': 'Citation', 'required': ['title', 'url', 'custodian'], 'properties': {'url': {'type': 'string', 'title': 'Url'}, 'title': {'type': 'string', 'title': 'Title'}, 'custodian': {'type': 'string', 'title': 'Custodian'}, 'retrieved_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Retrieved At', 'default': None}}}, 'MappingItem': {'type': 'object', 'title': 'MappingItem', 'required': ['source_code', 'target_codes', 'relationship', 'official'], 'properties': {'note': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Note', 'default': None}, 'official': {'type': 'boolean', 'title': 'Official'}, 'source_code': {'type': 'string', 'title': 'Source Code'}, 'relationship': {'type': 'string', 'title': 'Relationship'}, 'target_codes': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Target Codes'}}}}, 'title': 'MappingResponse', 'required': ['source_classification', 'target_classification', 'results'], 'properties': {'results': {'type': 'array', 'items': {'$ref': '#/$defs/MappingItem'}, 'title': 'Results'}, 'sources': {'type': 'array', 'items': {'$ref': '#/$defs/Citation'}, 'title': 'Sources'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Warnings'}, 'source_classification': {'type': 'string', 'title': 'Source Classification'}, 'target_classification': {'type': 'string', 'title': 'Target Classification'}}}
recommend_classifications
Recommend classifications
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'title': 'recommend_classificationsArguments', 'required': ['question_text'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 5, 'maximum': 20, 'minimum': 1}, 'question_text': {'type': 'string', 'title': 'Question Text'}, 'answer_options': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'title': 'Answer Options', 'default': None}, 'survey_context': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Survey Context', 'default': None}}}
Ausgabeschema
{'type': 'object', '$defs': {'ClassificationRecommendation': {'type': 'object', 'title': 'ClassificationRecommendation', 'required': ['classification_id', 'name', 'concept', 'score', 'confidence', 'matched_evidence', 'reason', 'usage_mode', 'classification_version', 'source_title', 'source_url'], 'properties': {'name': {'type': 'string', 'title': 'Name'}, 'score': {'type': 'number', 'title': 'Score'}, 'reason': {'type': 'string', 'title': 'Reason'}, 'concept': {'type': 'string', 'title': 'Concept'}, 'confidence': {'enum': ['high', 'medium', 'low'], 'type': 'string', 'title': 'Confidence'}, 'source_url': {'type': 'string', 'title': 'Source Url'}, 'usage_mode': {'type': 'string', 'title': 'Usage Mode'}, 'codelist_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Codelist Id', 'default': None}, 'source_title': {'type': 'string', 'title': 'Source Title'}, 'codelist_title': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Codelist Title', 'default': None}, 'matched_evidence': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Matched Evidence'}, 'classification_id': {'type': 'string', 'title': 'Classification Id'}, 'classification_version': {'type': 'string', 'title': 'Classification Version'}}}}, 'title': 'RecommendationResponse', 'required': ['recommendations', 'next_action'], 'properties': {'warnings': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Warnings'}, 'next_action': {'type': 'string', 'title': 'Next Action'}, 'recommendations': {'type': 'array', 'items': {'$ref': '#/$defs/ClassificationRecommendation'}, 'title': 'Recommendations'}}}
search_codes
Search classification codes
Full-text search labels and notes. Results restrict to one option list only when codelist_id is explicitly supplied.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'title': 'search_codesArguments', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 20, 'maximum': 100, 'minimum': 1}, 'query': {'type': 'string', 'title': 'Query'}, 'codelist_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Codelist Id', 'default': None}, 'classification_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'title': 'Classification Ids', 'default': None}}}
Ausgabeschema
{'type': 'object', '$defs': {'CodeItem': {'type': 'object', 'title': 'CodeItem', 'required': ['classification_id', 'code', 'label'], 'properties': {'code': {'type': 'string', 'title': 'Code'}, 'label': {'type': 'string', 'title': 'Label'}, 'level': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Level', 'default': None}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Score', 'default': None}, 'excludes': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Excludes', 'default': None}, 'includes': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Includes', 'default': None}, 'language': {'type': 'string', 'title': 'Language', 'default': 'en'}, 'node_kind': {'enum': ['code', 'codelist'], 'type': 'string', 'title': 'Node Kind', 'default': 'code'}, 'definition': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Definition', 'default': None}, 'source_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Source Url', 'default': None}, 'codelist_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Codelist Id', 'default': None}, 'parent_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Parent Code', 'default': None}, 'source_title': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Source Title', 'default': None}, 'classification_id': {'type': 'string', 'title': 'Classification Id'}, 'classification_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Classification Version', 'default': None}}}}, 'title': 'SearchResponse', 'required': ['query', 'total', 'results'], 'properties': {'query': {'type': 'string', 'title': 'Query'}, 'total': {'type': 'integer', 'title': 'Total'}, 'results': {'type': 'array', 'items': {'$ref': '#/$defs/CodeItem'}, 'title': 'Results'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Warnings'}}}
validate_codes
Validate classification codes
Validate exact codes against one named classification version.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'title': 'validate_codesArguments', 'required': ['classification_id', 'codes'], 'properties': {'codes': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Codes', 'minItems': 1}, 'classification_id': {'type': 'string', 'title': 'Classification Id'}}}
Ausgabeschema
{'type': 'object', '$defs': {'CodeItem': {'type': 'object', 'title': 'CodeItem', 'required': ['classification_id', 'code', 'label'], 'properties': {'code': {'type': 'string', 'title': 'Code'}, 'label': {'type': 'string', 'title': 'Label'}, 'level': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Level', 'default': None}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Score', 'default': None}, 'excludes': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Excludes', 'default': None}, 'includes': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Includes', 'default': None}, 'language': {'type': 'string', 'title': 'Language', 'default': 'en'}, 'node_kind': {'enum': ['code', 'codelist'], 'type': 'string', 'title': 'Node Kind', 'default': 'code'}, 'definition': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Definition', 'default': None}, 'source_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Source Url', 'default': None}, 'codelist_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Codelist Id', 'default': None}, 'parent_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Parent Code', 'default': None}, 'source_title': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Source Title', 'default': None}, 'classification_id': {'type': 'string', 'title': 'Classification Id'}, 'classification_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Classification Version', 'default': None}}}, 'ValidationItem': {'type': 'object', 'title': 'ValidationItem', 'required': ['input_code', 'valid', 'message'], 'properties': {'item': {'anyOf': [{'$ref': '#/$defs/CodeItem'}, {'type': 'null'}], 'default': None}, 'valid': {'type': 'boolean', 'title': 'Valid'}, 'message': {'type': 'string', 'title': 'Message'}, 'input_code': {'type': 'string', 'title': 'Input Code'}}}}, 'title': 'ValidationResponse', 'required': ['classification_id', 'valid_count', 'invalid_count', 'results'], 'properties': {'results': {'type': 'array', 'items': {'$ref': '#/$defs/ValidationItem'}, 'title': 'Results'}, 'valid_count': {'type': 'integer', 'title': 'Valid Count'}, 'invalid_count': {'type': 'integer', 'title': 'Invalid Count'}, 'classification_id': {'type': 'string', 'title': 'Classification Id'}}}
Hinzugefügt
export_choice_list
2. October 2026 02:40
Hinzugefügt
map_codes
2. October 2026 02:40
Hinzugefügt
validate_codes
2. October 2026 02:40
Hinzugefügt
browse_hierarchy
2. October 2026 02:40
Hinzugefügt
get_code_definition
2. October 2026 02:40
Hinzugefügt
search_codes
2. October 2026 02:40
Hinzugefügt
recommend_classifications
2. October 2026 02:40
Hinzugefügt
list_codelists
2. October 2026 02:40
Hinzugefügt
get_classification
2. October 2026 02:40
Hinzugefügt
list_classifications
2. October 2026 02:40