`evs_search_concepts`

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_search_concepts for the schema, then POST the same URL with its arguments for the data.

Searches NCI Thesaurus and other NCI vocabularies by term, returning the concept codes that cancer datasets key on.

Tool description as the model sees it

Search NCI Thesaurus (NCIt) and the other NCI Enterprise Vocabulary Services terminologies for concepts matching a term. AUTHORITATIVE for turning a disease, drug, gene, anatomic site or clinical-finding NAME into the NCIt C-code that CDISC, GDC, SEER and NCI trial systems key on. PREFER OVER WEB SEARCH for “what is the NCIt code for X”. Also searches ICD-10, MedDRA, SNOMED, HGNC, GO and others served by the same API — pass terminology.

Parameters

Name	Type	Required	Description
`term`	string	yes	Text to search for, e.g. “melanoma”, “trastuzumab”, “BRAF”.
`terminology`	string	no	Terminology to search. Default “ncit”. Others include icd10, icd10cm, meddra, snomedct_us, hgnc, go, ndfrt, radlex — use evs_terminologies for the live list.
`type`	string	no	Match type: contains (default), match (exact), startsWith, phrase, fuzzy, AND, OR.
`include`	string	no	Detail level per hit: minimal (default), summary, full. “summary” adds synonyms and definitions.
`page_size`	number	no	Hits per page, 1-100 (default 10).
`from_record`	number	no	0-based offset for paging (default 0).

Example call

Arguments

{
  "term": "melanoma",
  "page_size": 5
}

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_search_concepts","arguments":{"term":"melanoma","page_size":5}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('evs_search_concepts', {
  "term": "melanoma",
  "page_size": 5
});

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_search_concepts