Find the evidence on a substance or a question
find_evidenceAnswers "what does X do?" and "does X affect Y?" for a supplement, nutrient, drug, food compound or plant (for example "does magnesium help sleep?", "what is creatine shown to do?", "omega-3 and triglycerides"). Pass the substance as query and the effect or outcome asked about, if there is one, as about. When the person names two substances ("is creatine safe with caffeine"), pass one as query and the other as about, in one call; findings about the pair together come back under in_combination. It resolves the name to the node that has findings and returns up to limit findings (default 10), strongest evidence first, each with its evidence strength in words, the study design, the quote, the paper, a permalink and a citation to quote as it stands. total_findings counts every match. The result is complete for the query: another wording of the same substance resolves to the same node, so do not call again to rephrase. Call again only to narrow (evidence_strength, about), to raise limit (at most 50), or to ask about something else. Without about, summary lists everything the node has findings about. If matched is null, or total_findings is 0, Catalyst has recorded no findings on it. That is a complete answer: say so, and do not answer from memory as though from Catalyst. Try search_nodes only when other_matches or summary shows a node the person plausibly meant. An evidence strength says how well the evidence supports a finding and is not a recommendation. For what a compound can become, use reach; for reference-database relations, use get_relations.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "find_evidence"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| about | No | Optional: the effect, outcome or second substance asked about (e.g. "sleep", "blood pressure", "caffeine"), or a node id from search_nodes. | |
| limit | No | Findings to return, strongest evidence first. The default is enough to answer; total_findings says how many match. | |
| query | Yes | The substance the person asked about, in their words (e.g. "magnesium", "vitamin D", "BPC-157"), or a node id from search_nodes. For a question about an outcome alone (e.g. "what lowers blood pressure"), the outcome. | |
| detail | No | brief (default) returns each finding with its claim, evidence strength, design, population, dose, quote, paper, permalink and a citation to quote as it stands. full adds every other recorded field and is longer; use it only when the person asks for all fields. | brief |
| evidence_strength | No | Optional floor: only findings at this evidence strength or stronger, from strong down to insufficient. |