Skip to main content
MCP server CX Codex

PubChem Finder — Claude Code MCP server: what it does, how to install

PubChem Finder — an MCP server for chemical structure searches across PubChem, offline RDKit molecular profiling, and toxicity lookups without API rate limits.

MIT ★ 11 updated 2026-10-29

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env PUBCHEM_FINDER_HOME=<PUBCHEM_FINDER_HOME> --transport stdio pubchem-finder -- uvx pubchem-finder
Open on GitHub

What PubChem Finder does

The server blends live PubChem endpoints with local chemical analysis. It queries PubChem for GHS hazard labels, pharmacology, and bioassay data while citing references. Offline RDKit utilities calculate Lipinski descriptors, strip salts, render compound structures, and flag PAINS or Brenk alerts.

Similarity and substructure queries use a local FPSim2 fingerprint index stored in two data files. Without a generated local index, similarity and substructure search calls will fail to return matches.

Running the tool requires uv. It communicates via stdio or streamable HTTP at 127.0.0.1:8000/mcp. Because HTTP transport provides no native authentication, binding it beyond localhost creates exposure risks.

What it helps with

  • Screen compounds against PAINS, Brenk, and Lipinski filters offline
  • Run substructure searches with SMARTS without API query throttling
  • Fetch PubChem toxicity records and GHS safety classifications
  • Render comparative chemical structures with highlighted matching fragments

Example prompts for the agent

  • Check if caffeine satisfies Lipinski rules and look up its molecular weight
  • Retrieve the GHS hazard classifications and cited toxicity details for ibuprofen
  • Compare smiles_a and smiles_b using ECFP4 fingerprints

How to install PubChem Finder

Platform CLI

claude mcp add --env PUBCHEM_FINDER_HOME=<PUBCHEM_FINDER_HOME> --transport stdio pubchem-finder -- uvx pubchem-finder

Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from pubchem-finder <command>

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about PubChem Finder

How to install PubChem Finder in Claude Code?

Run claude mcp add pubchem-finder -- uvx pubchem-finder. To set a custom index path, run claude mcp add --env PUBCHEM_FINDER_HOME=<PUBCHEM_FINDER_HOME> --transport stdio pubchem-finder -- uvx pubchem-finder.

What does PubChem Finder do?

It equips your AI client with cheminformatics tools to inspect chemical structures, compute molecular descriptors, and pull PubChem compound records.

Is a local index mandatory for all tools?

No. Property calculations, RDKit profiling, and standard PubChem lookups operate directly. The local index is necessary only for similarity and substructure matching tools.

Similar MCP servers

All MCP servers for Science and research →

Project sponsors

Companies that keep this analytics open