pharmguide-mcp

An MCP server that gives Claude and other AI agents the evidence behind Omiclamp:

• Pharmacogenomics (PGx): what published guideline bodies (CPIC, DPWG, the FDA, Health Canada, ClinPGx, with PharmGKB shown verbatim) say about how a person's genes affect a medication. Every evidence row carries its source, citation, link and date.
• Nutrigenomics (NGX): ten gene-diet topics graded for scientific validity against the Grimaldi et al. 2017 framework, with failed replications and guideline dissent surfaced as conflicts.

It runs on your machine. Nothing you ask it, including a genotype, is sent anywhere. The engine and its compiled data ship inside the package, so the answers match www.omiclamp.com for the same build.

Use it for what it is

This is an educational reference, not medical or dietary advice and not clinical decision support. It reports and contrasts what sources say; it does not tell anyone what to take.

• Do not use it to make or automate prescribing, dosing or dietary decisions for a particular person.
• Keep the educational_disclaimer (or disclaimer) and the sources attached to anything you show from a response.
• Cite the guideline body on each row, not this server, and honour its licence: CPIC is CC BY 4.0; DPWG, ClinPGx and PharmGKB are CC BY-SA 4.0 (share-alike; PharmGKB verbatim only); FDA tables are US public domain. describe_capabilities returns the full table.
• Every response carries provenance with the compile date. Say how current the data is.

Install

Needs uv. Nothing else to install: uvx fetches the package on first run.

Claude Code

claude mcp add omiclamp -- uvx pharmguide-mcp

Claude Desktop and other MCP clients

{
  "mcpServers": {
    "omiclamp": {
      "command": "uvx",
      "args": ["pharmguide-mcp"]
    }
  }
}

Tools

Develop

From a checkout of the Omiclamp repository:

cd pharmguide-mcp
PYTHONPATH=..:. python -m pytest -q        # includes parity with every record the site serves
PYTHONPATH=..:. python -m pharmguide_mcp.server
./build.sh                                  # wheel + sdist into dist/, engine and data bundled

The server only registers tools and framing (server.py); tools.py delegates to the pharmguide.signal engine and reshapes its output, with no clinical logic of its own. NGX is served from the YAMLs in ngx_data/, kept identical to pharmguide-web/ngx-evidence/.

Release

Bump version in pyproject.toml, merge, then push a matching tag: git tag mcp-v0.3.0 && git push origin mcp-v0.3.0. The Publish MCP server workflow tests, builds and publishes to PyPI. Rebuild and release whenever the compiled data changes, or installed copies keep serving the old evidence.