CID-10 BR

Provides access to CID-10 data from DATASUS with search, lookup, hierarchy, statistics, and validation capabilities.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can access the Brazilian CID-10 (CID-10 BR) classification through a dedicated MCP server that exposes search, lookup, hierarchical navigation, statistics, and validation capabilities. This server helps health IT systems and applications efficiently work with CID-10 data from DATASUS, enabling integration, validation, and reporting for SUS-related workflows.

How to use

After you configure the MCP client to connect to the CID-10 BR MCP server, you can perform common tasks such as searching codes by term, looking up detailed information for a specific code, navigating the CID-10 hierarchy, retrieving statistics about the database, and validating codes for health system use.

How to install

Prerequisites: ensure you have Node.js version 18.0.0 or higher and npm installed on your system.

Install the MCP server package globally so you can run it from anywhere.

npm install -g cid10-br-mcp

Configure your MCP client to use the CID-10 BR MCP server. If you are using Claude Desktop, add a new MCP server entry as shown in the snippet below.

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

Start the MCP server locally using the runtime command provided by the configuration. You can verify the server is available by running the MCP client against the server and confirming responses for search, lookup, and hierarchy queries.

Notes and additional guidance

Data sources and structure: CID-10 BR data comes from DATASUS and includes 22 chapters, groups, categories, and subcategories in CSV form. The server exposes endpoints to search by term, retrieve code details, browse the hierarchy, obtain statistics, and validate codes for health records.

Usage patterns you can adopt include: searching for codes related to a condition, drilling down into a chapter to see categories and subcategories, and validating a code before including it in patient records or SUS systems.

Tools and endpoints available

The server provides a set of tools to perform common CID-10 operations.

Data sources and structure details

CID-10 BR data is sourced from official DATASUS CSV files, including: 22 chapters, groups, 3-character categories, and detailed subcategories. This structure supports hierarchical navigation and code validation.

Development and testing

Development prerequisites remain the same: Node.js is required to build and run the MCP server locally. You can test integration with an MCP Inspector tool to verify the server responds correctly to requests.

Available tools

cid10_search

Search CID-10 codes by term (code or description) and filter results.

cid10_lookup

Retrieve detailed information for a specific CID-10 code.

cid10_hierarchy

List all codes under a given category or prefix to explore the hierarchy.

cid10_capitulos

List all 22 CID-10 chapters for quick overview.

cid10_stats

Provide general statistics about the CID-10 database.

cid10_validar

Validate a CID-10 code for use in health information systems.