Pubtator Relations
pubtator_relationsList the relations PubTator 3 has extracted for a gene, disease, chemical or variant, which drugs treat a disease, which genes a disease is associated with, which chemicals inhibit a gene, ranked by supporting-publication count, each labelled machine-extracted, and the top relations carrying their supporting passages (the actual sentences, with PMIDs). Filter by relation type (treat, cause, associate, interact, inhibit, stimulate, prevent, positive/negative_correlate, cotreat, drug_interact, compare) and/or by a second entity. Accepts a PubTator id (@GENE_BRCA1) or a plain name. Sourced from the PubTator 3 relation-extraction model at NCBI/NLM, predictions from text, not curated. Keyless.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"type": "treat",
"limit": 10,
"entity": "@CHEMICAL_Doxorubicin",
"evidence_for": 2
},
"name": "pubtator_relations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Restrict to one relation type. Omit for all types. | |
| limit | No | Max relations to return, 1-50 (default 20). | |
| entity | Yes | The entity to list relations for: a PubTator id ("@GENE_BRCA1", "@CHEMICAL_Doxorubicin") or a plain name ("BRCA1", "doxorubicin"), a name is resolved via autocomplete and reported in resolved_from. | |
| target | No | Optional second entity to restrict to (id or plain name), e.g. "@DISEASE_Breast_Neoplasms". | |
| evidence_for | No | How many of the top relations get supporting passages attached (one search each), 0-5 (default 3). Each attaches up to 3 passages with PMIDs. |