# Catalyst evidence graph [Health: Active]

**Category:** 🧬 Biology & Bioinformatics  
**Repository:** https://github.com/colorcatalyst/catalyst-mcp  
**GitHub Stars:** 0  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/catalyst-evidence-graph

## Description
Findings on what compounds and supplements do in the body, with evidence strength, quote and paper.

## Tools
Capabilities this server exposes over MCP:

- **find_evidence** — Use this when someone asks what a supplement, nutrient, drug, food compound or plant does in the body, or whether it affects something specific (for example "does magnesium help sleep?", "what is creatine shown to do?", "omega-3 and triglycerides"). Pass the substance (or an outcome such as "sleep") as query, and the specific effect, if there is one, as about. One call resolves the name to the node that has findings and returns them, each with its evidence strength in words, the study design, the quote, the paper, a permalink and a citation to quote as it stands. Without about, summary lists everything the node has findings about. If nothing matches, it says so: tell the person Catalyst has no findings on it rather than answering from memory as though from Catalyst. An evidence strength says how well the evidence supports a finding; it is not a recommendation.
- **search_nodes** — Search the Catalyst evidence graph by name or synonym (for example "magnesium", "vitamin D", "sleep", "creatine"). Returns node ids to pass to get_findings or get_relations. Each hit says how many findings it has, and hits with findings come first, so the first hit with findings above 0 is usually the one to use. It finds things; it does not say anything about them.
- **get_findings** — The curated study findings for one node: for a compound, organism or material, what it has been shown to affect; for an outcome, which compounds have been studied against it. summary lists everything the node has findings about, one row each, across ALL its findings and not only the rows returned. Use it to see what is covered, then pass about (an id from summary, or words such as "sleep") to get the findings on one thing. Each finding carries its evidence strength, one of five named levels from strong to insufficient (strong, moderate, limited, very_limited, insufficient), the verbatim sentence it was drawn from, the paper, the population and dose, and a permalink. An evidence strength says how well the evidence supports the finding; it is not a recommendation. Always give the evidence strength with the claim, and link the permalink. An empty list means nothing has been curated yet, not that the compound does nothing.
- **get_finding** — One finding by its id (the last part of a permalink, /e/{id}): the claim, its evidence strength and what that level means, the verbatim quote, the study design and the paper, and evidence_strength_reasons: each rule that set the level, in order, and what the assessment does not weigh. Use it to explain why the evidence behind a finding is as strong as it is, from evidence_strength_reasons rather than by guessing.
- **get_relations** — What public reference databases (Reactome, UniProt, Rhea, ChEBI and others) record about a node: transporters, enzymes, pathways, expression. Every row is assertion_class 'inferred': a hypothesis about how a compound could act, not a result anyone measured in people. Present these as possible mechanisms and never as effects. For effects, use get_findings.
- **get_reactions** — Biochemical reactions from Rhea and Human-GEM that a compound is a substrate or product of, or that a protein catalyses or transports. Every row is assertion_class 'inferred': a reaction two public databases record, not a result anyone measured in a person. Present these as known biochemistry, never as an effect a compound has, and never as a recommendation. For effects, use get_findings. A compound flagged is_hub (water, ATP, protons and the like) returns its reaction count only, because it participates in nearly everything and a row list would not be biology anyone reads. Coverage: the whole of one Rhea release and one Human-GEM release, each reaction counted once; a participant that is not a node in this graph is listed but not linked, and only human enzymes that are nodes are listed at all. An empty result means no reaction in those releases names this node, not that the body has none.
- **reach** — Breadth-first reachability through the reactions two public databases (Rhea, Human-GEM) record: what a compound could become, and through which reactions and enzymes, within up to 3 steps. Every route is assertion_class 'inferred': a hypothesis drawn from reference databases, never a measured or reported effect. Present it as known biochemical connectivity — never as an effect, a recommendation, or a claim that the body actually does this. For measured effects, use get_findings. Common cofactors and currency species (water, ATP, protons and the like) are excluded as intermediate steps, so a route never reads 'reaches everything through ATP'. A currency species is also never materialised as from_id or to_id itself — asking about one returns reachable: null with a coverage note explaining that, not a checked "0 routes". Give to_id to check one target compound; omit it to list everything from_id reaches. A route not being found can mean three different things, and the result's coverage field says which: reachability may not have been BUILT for this scope yet (nothing has been checked); it may have been checked and found NOT REACHABLE through the reactions loaded — never read that as "the body cannot make it"; or the compound asked about may be a currency species, structurally excluded rather than searched.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "catalyst-evidence-graph": {
    "url": "https://catalystproject.ai/mcp"
  }
}
```

## Documentation

## What Catalyst evidence graph MCP server does

Catalyst evidence graph MCP server gives MCP-compatible clients access to a curated evidence graph covering compounds, supplements, nutrients, and foods studied in humans. Agents can look up findings associated with a compound or an outcome and inspect the supporting context rather than receiving an unsupported summary.

Each finding includes an `evidence_strength` level: `strong`, `moderate`, `limited`, `very_limited`, or `insufficient`. The level is computed from the underlying study. Results also provide the quoted sentence used as evidence, the paper, the studied population, the dose, and a permalink for verification.

The graph also includes relations drawn from reference databases, including targets, pathways, and reactions. These relations are labelled as hypotheses and should not be treated as reported study findings. Evidence strength is descriptive, not a recommendation or medical advice.

## How it works

The hosted endpoint is available at `https://catalystproject.ai/mcp` using MCP over Streamable HTTP. It is read-only and does not require an account or API key. Clients connect directly to the endpoint, while this repository supplies client configuration, registry metadata, and extensions for selected environments.

The `get_findings` operation accepts an `evidence_strength` floor so callers can limit results to findings at or above a selected level. Since version 0.2.0, results use named evidence levels instead of letter grades. The former `grade` field and argument are no longer supported; requests that send `grade` receive an error identifying the replacement.

## Setup and configuration

Add the server URL to an MCP client using its HTTP or custom-connector configuration. A generic configuration is:

```json
{ "mcpServers": { "catalyst": { "url": "https://catalystproject.ai/mcp" } } }
```

Claude supports a custom connector, while Cursor and VS Code have client-specific setup options. Claude Code can install either the hosted server alone or the repository’s plugin, which also adds a skill for presenting evidence strength. Gemini CLI can install the repository as an extension. VS Code also provides an extension that registers the server with Copilot’s agent mode.

No environment variables, local database, API credential, or self-hosted process are required for the hosted service. The repository is MIT-licensed, while graph content follows the terms and source licenses documented by the project.

## Tools and capabilities

The Catalyst evidence graph MCP server supports:

- Finding evidence associated with a compound or outcome.
- Filtering findings using an `evidence_strength` threshold.
- Returning study-derived evidence levels and verbatim supporting sentences.
- Providing paper, population, dose, and verification permalink details.
- Exposing target, pathway, and reaction relations from reference databases.
- Connecting through Claude, Cursor, VS Code, Gemini CLI, Claude Code, and other MCP clients that support the endpoint.

## Limitations and notes

The service does not return products, prices, shopping links, or ranked recommendations. Its evidence levels describe support for a finding and should not be interpreted as advice about what to take.

The server stores no queries and has no accounts. Rate limits count calls per minute using the client name and a keyed hash of the network address rather than the address itself. The repository contains integrations and extensions, but the graph service itself is hosted at the project endpoint.

_Full upstream README: https://allmcps.com/mcp/catalyst-evidence-graph/readme_