🏥 CID-10 BR MCP Server

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.

✨ 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: [email protected]

🔗 Links

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

Made with ❤️ for the Brazilian health community