# 52_NDF_RT

> Query NDF-RT (National Drug File Reference Terminology) via the NCI EVS REST API. Use when looking up drug mechanisms of action, physiological effects, pharmacologic classes, chemical structures, or drug–disease relationships (may_treat / may_prevent) in NDF-RT. Accepts drug names or NDF-RT codes.

- Skill: `gabrielmoreira/52-ndf-rt` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/52-ndf-rt`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/52-ndf-rt/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/52-ndf-rt

---


# NDF-RT Query Skill

Search NDF-RT concepts by drug name or NDF-RT code via the NCI EVS REST API.
Auto-detects entity type by pattern:

| Input Pattern | Detected As | Lookup Logic |
|---|---|---|
| `N0000145918` | NDF-RT code (`N` + 10 digits) | direct concept GET |
| anything else | free text | full-text search endpoint |

## API

| Function | Input | Returns |
|---|---|---|
| `search(entity, limit)` | single entity string | `dict` with `entity`, `type`, `results` |
| `search_batch(entities, limit)` | list of entity strings | `dict[str, dict]` |
| `summarize(result, entity)` | search result dict + label | compact multi-line text |
| `to_json(result)` | search result dict | `list[dict]` |

### Result dict structure

Each item in `results` contains:

| Key | Description |
|---|---|
| `code` | NDF-RT concept code |
| `name` | Preferred concept name |
| `kind` | Concept kind (e.g. `DRUG_KIND`, `DISEASE_KIND`) |
| `properties` | flat `{type: value}` property dict |
| `roles` | list of `{type, relatedCode, relatedName}` role relationships |
| `parents` | list of `{code, name}` ISA parent concepts |
| `synonyms` | deduplicated list of synonym strings |

### Key NDF-RT relationship types (roles)

| Role | Meaning |
|---|---|
| `has_MoA` | mechanism of action |
| `has_PE` | physiological effect |
| `has_EPC` | established pharmacologic class |
| `may_treat` | indicated disease/condition |
| `may_prevent` | preventable disease/condition |
| `CI_with` | contraindicated with |
| `has_Chemical_Structure` | chemical structure classification |

## Usage

See `if __name__ == "__main__"` block in `52_NDF_RT.py` for runnable examples
covering: drug name search, code lookup, batch search, JSON output, and root
concept listing.

## Data

- **Source**: NCI EVS REST API (`https://api-evsrest.nci.nih.gov/api/v1`)
- **Terminology**: `ndfrt`
- **Auth**: none required
- **Rate limits**: not documented; use reasonable request spacing
- **Maintainer**: U.S. Department of Veterans Affairs / NCI Enterprise Vocabulary Services