Server definition
- Hash
- sha256:6879ec9550d369947228254ab42df3ac314c369e15d40d8a2948ba800b27b122
- What it is
- What a remote MCP server returned when asked what it offers: 10 tools
The blob, as servednamed by its sha256
{
"instructions": "Deterministic access to official international statistical classifications. No LLM or paid AI runs inside this server. Distinguish occupation (ISCO), industry (ISIC), status in employment (ICSE), labour-force status, education level (ISCED), and field of study (ISCED-F). For questionnaire review, call recommend_classifications with the question, answer options and context. Present every returned relevant alternative and its role; ranking is not an automatic selection. MICS7 content is limited to question-specific response codelists. MICS indicator definitions belong in a development-indicators service, not this classification registry. Never route an indicator, proportion, prevalence or rate request to an answer codelist. Before exporting MICS responses, call list_codelists and select exactly one codelist_id; never merge independent MICS answer lists. Do not dump a full detailed classification into a questionnaire unless explicitly requested. Detailed occupation, industry, disease and crime schemes are normally post-coded. Mappings may be one-to-many or definition-changing: preserve warnings and citations. National census geography is out of scope.",
"tools": [
{
"description": "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.",
"inputSchema": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"limit": {
"default": 200,
"maximum": 500,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"parent_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent Code"
}
},
"required": [
"classification_id"
],
"title": "browse_hierarchyArguments",
"type": "object"
},
"name": "browse_hierarchy",
"outputSchema": {
"$defs": {
"CodeItem": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"classification_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Classification Version"
},
"code": {
"title": "Code",
"type": "string"
},
"codelist_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Id"
},
"definition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Definition"
},
"excludes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Excludes"
},
"includes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Includes"
},
"label": {
"title": "Label",
"type": "string"
},
"language": {
"default": "en",
"title": "Language",
"type": "string"
},
"level": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Level"
},
"node_kind": {
"default": "code",
"enum": [
"code",
"codelist"
],
"title": "Node Kind",
"type": "string"
},
"parent_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent Code"
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Score"
},
"source_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Title"
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Url"
}
},
"required": [
"classification_id",
"code",
"label"
],
"title": "CodeItem",
"type": "object"
}
},
"properties": {
"result": {
"items": {
"$ref": "#/$defs/CodeItem"
},
"title": "Result",
"type": "array"
}
},
"required": [
"result"
],
"title": "browse_hierarchyOutput",
"type": "object"
}
},
{
"description": "Return a structured choice list at a selected hierarchy level. MICS exports require one codelist_id and never merge unrelated answer lists.",
"inputSchema": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"codelist_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Id"
},
"format": {
"default": "xlsform",
"enum": [
"xlsform",
"simple"
],
"title": "Format",
"type": "string"
},
"level": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Level"
},
"limit": {
"default": 1000,
"maximum": 10000,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"required": [
"classification_id"
],
"title": "export_choice_listArguments",
"type": "object"
},
"name": "export_choice_list",
"outputSchema": {
"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"
},
"format": {
"title": "Format",
"type": "string"
},
"level": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Level"
},
"option_count": {
"title": "Option Count",
"type": "integer"
},
"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",
"type": "object"
}
},
{
"description": "Get authoritative metadata and coverage for one classification_id returned by list_classifications.",
"inputSchema": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
}
},
"required": [
"classification_id"
],
"title": "get_classificationArguments",
"type": "object"
},
"name": "get_classification",
"outputSchema": {
"properties": {
"acronym": {
"title": "Acronym",
"type": "string"
},
"code_count": {
"default": 0,
"title": "Code Count",
"type": "integer"
},
"coverage": {
"title": "Coverage",
"type": "string"
},
"custodian": {
"title": "Custodian",
"type": "string"
},
"description": {
"title": "Description",
"type": "string"
},
"domain": {
"title": "Domain",
"type": "string"
},
"id": {
"title": "Id",
"type": "string"
},
"licence_note": {
"title": "Licence Note",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"status": {
"title": "Status",
"type": "string"
},
"version": {
"title": "Version",
"type": "string"
}
},
"required": [
"id",
"name",
"version",
"acronym",
"custodian",
"domain",
"status",
"coverage",
"description",
"source_url",
"licence_note"
],
"title": "ClassificationSummary",
"type": "object"
}
},
{
"description": "Retrieve one exact code or codelist container, including its node_kind, hierarchy position and explanatory notes.",
"inputSchema": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"code": {
"title": "Code",
"type": "string"
}
},
"required": [
"classification_id",
"code"
],
"title": "get_code_definitionArguments",
"type": "object"
},
"name": "get_code_definition",
"outputSchema": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"classification_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Classification Version"
},
"code": {
"title": "Code",
"type": "string"
},
"codelist_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Id"
},
"definition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Definition"
},
"excludes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Excludes"
},
"includes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Includes"
},
"label": {
"title": "Label",
"type": "string"
},
"language": {
"default": "en",
"title": "Language",
"type": "string"
},
"level": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Level"
},
"node_kind": {
"default": "code",
"enum": [
"code",
"codelist"
],
"title": "Node Kind",
"type": "string"
},
"parent_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent Code"
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Score"
},
"source_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Title"
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Url"
}
},
"required": [
"classification_id",
"code",
"label"
],
"title": "CodeItem",
"type": "object"
}
},
{
"description": "List classification families, versions, custodians, coverage and licensing notes. Start here when the correct standard is unknown.",
"inputSchema": {
"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"
},
"name": "list_classifications",
"outputSchema": {
"$defs": {
"ClassificationSummary": {
"properties": {
"acronym": {
"title": "Acronym",
"type": "string"
},
"code_count": {
"default": 0,
"title": "Code Count",
"type": "integer"
},
"coverage": {
"title": "Coverage",
"type": "string"
},
"custodian": {
"title": "Custodian",
"type": "string"
},
"description": {
"title": "Description",
"type": "string"
},
"domain": {
"title": "Domain",
"type": "string"
},
"id": {
"title": "Id",
"type": "string"
},
"licence_note": {
"title": "Licence Note",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"status": {
"title": "Status",
"type": "string"
},
"version": {
"title": "Version",
"type": "string"
}
},
"required": [
"id",
"name",
"version",
"acronym",
"custodian",
"domain",
"status",
"coverage",
"description",
"source_url",
"licence_note"
],
"title": "ClassificationSummary",
"type": "object"
}
},
"properties": {
"result": {
"items": {
"$ref": "#/$defs/ClassificationSummary"
},
"title": "Result",
"type": "array"
}
},
"required": [
"result"
],
"title": "list_classificationsOutput",
"type": "object"
}
},
{
"description": "List independent option lists within a classification before searching or exporting one list.",
"inputSchema": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
}
},
"required": [
"classification_id"
],
"title": "list_codelistsArguments",
"type": "object"
},
"name": "list_codelists",
"outputSchema": {
"$defs": {
"CodelistSummary": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"codelist_id": {
"title": "Codelist Id",
"type": "string"
},
"concept": {
"title": "Concept",
"type": "string"
},
"option_count": {
"title": "Option Count",
"type": "integer"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"source_version": {
"title": "Source Version",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"warning": {
"title": "Warning",
"type": "string"
}
},
"required": [
"classification_id",
"codelist_id",
"title",
"concept",
"source_version",
"option_count",
"warning",
"source_url"
],
"title": "CodelistSummary",
"type": "object"
}
},
"properties": {
"result": {
"items": {
"$ref": "#/$defs/CodelistSummary"
},
"title": "Result",
"type": "array"
}
},
"required": [
"result"
],
"title": "list_codelistsOutput",
"type": "object"
}
},
{
"description": "Apply official stored correspondences and expose splits, merges, changed meanings and unmapped codes. Never assume one-to-one equivalence.",
"inputSchema": {
"properties": {
"codes": {
"items": {
"type": "string"
},
"minItems": 1,
"title": "Codes",
"type": "array"
},
"source_classification_id": {
"title": "Source Classification Id",
"type": "string"
},
"target_classification_id": {
"title": "Target Classification Id",
"type": "string"
}
},
"required": [
"source_classification_id",
"target_classification_id",
"codes"
],
"title": "map_codesArguments",
"type": "object"
},
"name": "map_codes",
"outputSchema": {
"$defs": {
"Citation": {
"properties": {
"custodian": {
"title": "Custodian",
"type": "string"
},
"retrieved_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Retrieved At"
},
"title": {
"title": "Title",
"type": "string"
},
"url": {
"title": "Url",
"type": "string"
}
},
"required": [
"title",
"url",
"custodian"
],
"title": "Citation",
"type": "object"
},
"MappingItem": {
"properties": {
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Note"
},
"official": {
"title": "Official",
"type": "boolean"
},
"relationship": {
"title": "Relationship",
"type": "string"
},
"source_code": {
"title": "Source Code",
"type": "string"
},
"target_codes": {
"items": {
"type": "string"
},
"title": "Target Codes",
"type": "array"
}
},
"required": [
"source_code",
"target_codes",
"relationship",
"official"
],
"title": "MappingItem",
"type": "object"
}
},
"properties": {
"results": {
"items": {
"$ref": "#/$defs/MappingItem"
},
"title": "Results",
"type": "array"
},
"source_classification": {
"title": "Source Classification",
"type": "string"
},
"sources": {
"items": {
"$ref": "#/$defs/Citation"
},
"title": "Sources",
"type": "array"
},
"target_classification": {
"title": "Target Classification",
"type": "string"
},
"warnings": {
"items": {
"type": "string"
},
"title": "Warnings",
"type": "array"
}
},
"required": [
"source_classification",
"target_classification",
"results"
],
"title": "MappingResponse",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"answer_options": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Answer Options"
},
"limit": {
"default": 5,
"maximum": 20,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"question_text": {
"title": "Question Text",
"type": "string"
},
"survey_context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Survey Context"
}
},
"required": [
"question_text"
],
"title": "recommend_classificationsArguments",
"type": "object"
},
"name": "recommend_classifications",
"outputSchema": {
"$defs": {
"ClassificationRecommendation": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"classification_version": {
"title": "Classification Version",
"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"
},
"concept": {
"title": "Concept",
"type": "string"
},
"confidence": {
"enum": [
"high",
"medium",
"low"
],
"title": "Confidence",
"type": "string"
},
"matched_evidence": {
"items": {
"type": "string"
},
"title": "Matched Evidence",
"type": "array"
},
"name": {
"title": "Name",
"type": "string"
},
"reason": {
"title": "Reason",
"type": "string"
},
"score": {
"title": "Score",
"type": "number"
},
"source_title": {
"title": "Source Title",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"usage_mode": {
"title": "Usage Mode",
"type": "string"
}
},
"required": [
"classification_id",
"name",
"concept",
"score",
"confidence",
"matched_evidence",
"reason",
"usage_mode",
"classification_version",
"source_title",
"source_url"
],
"title": "ClassificationRecommendation",
"type": "object"
}
},
"properties": {
"next_action": {
"title": "Next Action",
"type": "string"
},
"recommendations": {
"items": {
"$ref": "#/$defs/ClassificationRecommendation"
},
"title": "Recommendations",
"type": "array"
},
"warnings": {
"items": {
"type": "string"
},
"title": "Warnings",
"type": "array"
}
},
"required": [
"recommendations",
"next_action"
],
"title": "RecommendationResponse",
"type": "object"
}
},
{
"description": "Full-text search labels and notes. Results restrict to one option list only when codelist_id is explicitly supplied.",
"inputSchema": {
"properties": {
"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"
},
"query": {
"title": "Query",
"type": "string"
}
},
"required": [
"query"
],
"title": "search_codesArguments",
"type": "object"
},
"name": "search_codes",
"outputSchema": {
"$defs": {
"CodeItem": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"classification_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Classification Version"
},
"code": {
"title": "Code",
"type": "string"
},
"codelist_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Id"
},
"definition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Definition"
},
"excludes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Excludes"
},
"includes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Includes"
},
"label": {
"title": "Label",
"type": "string"
},
"language": {
"default": "en",
"title": "Language",
"type": "string"
},
"level": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Level"
},
"node_kind": {
"default": "code",
"enum": [
"code",
"codelist"
],
"title": "Node Kind",
"type": "string"
},
"parent_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent Code"
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Score"
},
"source_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Title"
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Url"
}
},
"required": [
"classification_id",
"code",
"label"
],
"title": "CodeItem",
"type": "object"
}
},
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"results": {
"items": {
"$ref": "#/$defs/CodeItem"
},
"title": "Results",
"type": "array"
},
"total": {
"title": "Total",
"type": "integer"
},
"warnings": {
"items": {
"type": "string"
},
"title": "Warnings",
"type": "array"
}
},
"required": [
"query",
"total",
"results"
],
"title": "SearchResponse",
"type": "object"
}
},
{
"description": "Validate exact codes against one named classification version.",
"inputSchema": {
"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"
},
"name": "validate_codes",
"outputSchema": {
"$defs": {
"CodeItem": {
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"classification_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Classification Version"
},
"code": {
"title": "Code",
"type": "string"
},
"codelist_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Codelist Id"
},
"definition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Definition"
},
"excludes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Excludes"
},
"includes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Includes"
},
"label": {
"title": "Label",
"type": "string"
},
"language": {
"default": "en",
"title": "Language",
"type": "string"
},
"level": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Level"
},
"node_kind": {
"default": "code",
"enum": [
"code",
"codelist"
],
"title": "Node Kind",
"type": "string"
},
"parent_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent Code"
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Score"
},
"source_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Title"
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Url"
}
},
"required": [
"classification_id",
"code",
"label"
],
"title": "CodeItem",
"type": "object"
},
"ValidationItem": {
"properties": {
"input_code": {
"title": "Input Code",
"type": "string"
},
"item": {
"anyOf": [
{
"$ref": "#/$defs/CodeItem"
},
{
"type": "null"
}
],
"default": null
},
"message": {
"title": "Message",
"type": "string"
},
"valid": {
"title": "Valid",
"type": "boolean"
}
},
"required": [
"input_code",
"valid",
"message"
],
"title": "ValidationItem",
"type": "object"
}
},
"properties": {
"classification_id": {
"title": "Classification Id",
"type": "string"
},
"invalid_count": {
"title": "Invalid Count",
"type": "integer"
},
"results": {
"items": {
"$ref": "#/$defs/ValidationItem"
},
"title": "Results",
"type": "array"
},
"valid_count": {
"title": "Valid Count",
"type": "integer"
}
},
"required": [
"classification_id",
"valid_count",
"invalid_count",
"results"
],
"title": "ValidationResponse",
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:6879ec9550d369947228254ab42df3ac314c369e15d40d8a2948ba800b27b122 | sha256sum