# Cid10 Br Mcp

> MCP Server para CID-10 Brasileira (DATASUS)

- **Type:** MCP server
- **Install:** `agentstack add mcp-sidneybissoli-cid10-br-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [SidneyBissoli](https://agentstack.voostack.com/s/sidneybissoli)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 1.0.1
- **License:** MIT
- **Upstream author:** [SidneyBissoli](https://github.com/SidneyBissoli)
- **Source:** https://github.com/SidneyBissoli/cid10-br-mcp

## Install

```sh
agentstack add mcp-sidneybissoli-cid10-br-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# CID-10 Brasil MCP Server

[](https://www.npmjs.com/package/cid10-br-mcp)
[](https://www.npmjs.com/package/cid10-br-mcp)
[](https://www.npmjs.com/package/cid10-br-mcp)
[](https://registry.modelcontextprotocol.io)
[](https://lobehub.com/mcp/sidneybissoli-cid10-br-mcp)
[](https://github.com/SidneyBissoli/cid10-br-mcp)
[](https://github.com/sponsors/SidneyBissoli)
[](https://opensource.org/licenses/MIT)

🇧🇷 [Leia em Português](README.pt-BR.md)

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

A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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

| 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](http://www2.datasus.gov.br/cid10/V2008/cid10.htm)

## 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](LICENSE) file for details.

## Author

**Sidney Bissoli**
- GitHub: [@SidneyBissoli](https://github.com/SidneyBissoli)
- Email: sbissoli76@gmail.com

## Links

- [npm package](https://www.npmjs.com/package/cid10-br-mcp)
- [MCP Registry](https://registry.modelcontextprotocol.io/?search=cid10)
- [Model Context Protocol](https://modelcontextprotocol.io/)
- [DATASUS CID-10](http://www2.datasus.gov.br/cid10/V2008/cid10.htm)

---

Made for the Brazilian health community

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [SidneyBissoli](https://github.com/SidneyBissoli)
- **Source:** [SidneyBissoli/cid10-br-mcp](https://github.com/SidneyBissoli/cid10-br-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v1.0.1 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **1.0.1** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-sidneybissoli-cid10-br-mcp
- Seller: https://agentstack.voostack.com/s/sidneybissoli
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.