# Tools

URL: https://docs.healthcare.dev/mcp/tools

All tools are read-only (`readOnlyHint: true`), return at most 10 results by default and include
`source` and `data_version` so answers can be cited.

| Tool                     | Use it to                                               | Example input                                | Don't use it for                            |
| ------------------------ | ------------------------------------------------------- | -------------------------------------------- | ------------------------------------------- |
| `lookup_code`            | Get one ICD-10-CM, ICD-10-PCS or HCPCS code             | `{ "system": "icd10cm", "code": "E11.9" }`   | Finding a code from a description (search)  |
| `search_codes`           | Find codes by description or prefix                     | `{ "system": "icd10cm", "query": "asthma" }` | Picking a diagnosis for a patient           |
| `explain_code_hierarchy` | See a code's ancestors and children                     | `{ "system": "icd10cm", "code": "E11.22" }`  | Code lookups where you only need the record |
| `lookup_drug`            | Get an FDA product by NDC or an RxNorm concept by RxCUI | `{ "ndc": "0002-0152-01" }`                  | Dosing or interaction questions             |
| `search_drugs`           | Find drugs by name across RxNorm and NDC                | `{ "query": "metformin" }`                   | Recommending a drug                         |
| `map_ndc_to_rxnorm`      | Turn an NDC into RxNorm concepts                        | `{ "ndc": "00002015201" }`                   | Products not in the FDA NDC Directory       |
| `validate_npi`           | Check an NPI's format and check digit                   | `{ "npi": "1234567893" }`                    | Confirming a provider exists (coming soon)  |
| `list_datasets`          | See versions and freshness of every dataset             | `{}`                                         | Record lookups                              |
| `get_dataset_changes`    | See what was added, changed or retired in a release     | `{ "dataset": "icd10cm" }`                   | Full dataset downloads                      |

Resources: `healthcare-dev://datasets`, `healthcare-dev://changes/{dataset}`. Prompts:
`code_this_diagnosis`, `check_ndc`.

The input examples are illustrative; your client shows each tool's exact JSON schema.