Skip to main content
Glama

CID-10 Brasil MCP Server

WARNING

This package is deprecated. It has been superseded by medical-terminologies-mcp (npm), which serves the same full Brazilian CID-10 (DataSUS V2008) plus ICD-11, LOINC, RxNorm, MeSH, ATC and the authoritative WHO ICD-10→ICD-11 crosswalk, with source provenance on every response — and also offers a hosted endpoint at https://medical.sidneybissoli.com/mcp (no install needed). This repository stays available for reference but will receive no further updates.

npm version npm downloads node MCP Registry LobeHub GitHub stars GitHub Sponsors License: MIT

🇧🇷 Leia em Português

MCP Server for Brazilian ICD-10 (DATASUS) - International Classification of Diseases

A Model Context Protocol (MCP) server that provides access to the Brazilian version of ICD-10 (CID-10), maintained by DATASUS/Ministry of Health of Brazil.

See it in action

Ask your assistant, in plain Portuguese:

  • "Qual o código CID-10 para infarto agudo do miocárdio?" → cid10_search / cid10_lookup

  • "Liste todas as subcategorias do diabetes tipo 2 (E11)." → cid10_hierarchy

  • "O código C50 é válido e pode ser causa de óbito?" → cid10_validar

The answers come straight from the bundled DATASUS V2008 dataset — official codes and descriptions, not guesses from training data.

Related MCP server: Medical Terminologies MCP

Features

  • Search - Search codes by term (code or description)

  • Lookup - Get detailed information for a specific CID-10 code

  • Hierarchy - Navigate the hierarchical structure (chapters, groups, categories, subcategories)

  • Statistics - General statistics about the CID-10 database

  • Validation - Validate codes for use in health systems (SUS)

Installation

Using with Claude Desktop

Add to your Claude Desktop configuration file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cid10-br": {
      "command": "npx",
      "args": ["cid10-br-mcp"]
    }
  }
}

Global Installation

npm install -g cid10-br-mcp

Then add to Claude Desktop config:

{
  "mcpServers": {
    "cid10-br": {
      "command": "cid10-br-mcp"
    }
  }
}

Available Tools

Tool

Description

cid10_search

Search CID-10 codes by term (code or description)

cid10_lookup

Get detailed information for a specific code

cid10_hierarchy

Get all codes under a category/prefix

cid10_capitulos

List all 22 chapters of CID-10

cid10_stats

General statistics about the database

cid10_validar

Validate a code for use in health systems

Usage Examples

Once configured, you can ask Claude:

  • "What is CID-10 code A90?"

  • "Search for diabetes codes in CID-10"

  • "List all codes under category E11"

  • "What are the chapters of CID-10?"

  • "Is F32.1 a valid code for medical records?"

Data Source

The data comes from official DATASUS sources:

  • CID-10-CAPITULOS.CSV - 22 chapters

  • CID-10-GRUPOS.CSV - Groups within chapters

  • CID-10-CATEGORIAS.CSV - 3-character categories

  • CID-10-SUBCATEGORIAS.CSV - Detailed subcategories

Source: DATASUS - CID-10

Development

Prerequisites

  • Node.js >= 18.0.0

  • npm

Setup

# Clone the repository
git clone https://github.com/SidneyBissoli/cid10-br-mcp.git
cd cid10-br-mcp

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

Testing with MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

Contributing

Contributions are welcome! Feel free to:

  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/new-feature)

  3. Commit your changes (git commit -m 'Add new feature')

  4. Push to the branch (git push origin feature/new-feature)

  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Sidney Bissoli


Made for the Brazilian health community

Available Tools

6 tools
cid10_capitulosA

Lista todos os 22 capítulos da CID-10 brasileira. Útil para navegação e entendimento da estrutura hierárquica da classificação.

Inputs: no named parameters.

cid10_hierarchyA

Retorna todos os códigos CID-10 sob uma categoria/prefixo. Útil para obter todas as subcategorias de uma condição. Exemplo: prefixo "E11" retorna todos os tipos de diabetes mellitus tipo 2.

Inputs: prefixo (required).

cid10_lookupA

Consulta detalhes de um código CID-10 específico. Retorna informações completas incluindo descrição, restrições de sexo, se pode ser causa de óbito, e classificação cruz/asterisco.

Inputs: codigo (required).

cid10_statsB

Retorna estatísticas gerais da base de dados CID-10 brasileira carregada.

Inputs: no named parameters.

cid10_validarA

Valida se um código CID-10 existe e retorna informações sobre sua validade para uso em sistemas de saúde (AIH, APAC, SIM, etc.).

Inputs: codigo (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool serves a distinct purpose: validation, search, lookup, hierarchy browsing, chapter listing, and statistics. There is no functional overlap between them.

    Naming Consistency4/5

    All tools share the 'cid10_' prefix and use action-oriented names, though there is a mix of Portuguese (validar, capítulos) and English (search, lookup) verbs, slightly reducing consistency.

    Tool Count5/5

    With 6 tools, the server is well-scoped for a medical code classification system, covering essential operations without unnecessary bloat.

    Completeness5/5

    The tool set covers the full expected lifecycle: validation, search, detailed lookup, hierarchical navigation, overview of chapters, and database statistics. No obvious gaps for typical usage.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers