MCP server: One MCP server.

Cid10 Br

@sidneybissoliMCP server · External

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

Medical referencev1.1.0MITTypeScript
Freeno charge per call

Runs on your machine from its package; the steps are below.

What it does

  1. Reads
  2. Writes
  3. High impact

At most: only reads or looks up information.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

npmcid10-br-mcpv1.1.0

Run

npx -y cid10-br-mcp

MCP client config

{
  "mcpServers": {
    "cid10-br": {
      "command": "npx",
      "args": [
        "-y",
        "cid10-br-mcp"
      ]
    }
  }
}
README3 min read

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.

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

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

Global Installation

bash
npm install -g cid10-br-mcp

Then add to Claude Desktop config:

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

Available Tools

ToolDescription
cid10_searchSearch CID-10 codes by term (code or description)
cid10_lookupGet detailed information for a specific code
cid10_hierarchyGet all codes under a category/prefix
cid10_capitulosList all 22 chapters of CID-10
cid10_statsGeneral statistics about the database
cid10_validarValidate 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

bash
# 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

bash
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

Similar modules

Browse Medical reference