cid10-br-mcp

CID-10 Brasil MCP Server

       

🇧🇷 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.

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

• GitHub: @SidneyBissoli
• Email: sbissoli76@gmail.com

Links

• npm package
• MCP Registry
• Model Context Protocol
• DATASUS CID-10

---

Made for the Brazilian health community