`evs_concept_relations`

Pack: nci-evs · Endpoint: https://gateway.pipeworx.io/nci-evs/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/evs_concept_relations for the schema, then POST the same URL with its arguments for the data.

Parents, children, roles and associations around one NCI Thesaurus concept code.

Tool description as the model sees it

Walk the NCIt hierarchy and relationship graph around one concept code, via NCI Enterprise Vocabulary Services. AUTHORITATIVE for “what is X a kind of” (parents), “what kinds of X are there” (children), the defining ROLE relationships that give an NCIt disease its biology (Disease_Has_Finding, Disease_Has_Primary_Anatomic_Site, Gene_Product_Has_Biochemical_Function), and the associations linking it to CDISC/GDC value sets. Use this to expand a disease or drug into its subtypes before querying trial or genomic data.

Parameters

Name	Type	Required	Description
`code`	string	yes	Concept code, e.g. “C3224” (Melanoma) in NCIt.
`terminology`	string	no	Terminology the code belongs to. Default “ncit”.
`kinds`	string	no	Comma-separated relation kinds to fetch: parents, children, roles, associations, inverseAssociations, inverseRoles, descendants. Default “parents,children”.

Example call

Arguments

{
  "code": "C3224",
  "kinds": "parents,children,roles"
}

curl

curl -X POST https://gateway.pipeworx.io/nci-evs/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"evs_concept_relations","arguments":{"code":"C3224","kinds":"parents,children,roles"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('evs_concept_relations', {
  "code": "C3224",
  "kinds": "parents,children,roles"
});

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "nci-evs": {
      "url": "https://gateway.pipeworx.io/nci-evs/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

evs_concept_relations