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
claude mcp add --env PUBCHEM_FINDER_HOME=<PUBCHEM_FINDER_HOME> --transport stdio pubchem-finder -- uvx pubchem-finderWhat 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_aandsmiles_busing 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-finderReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from pubchem-finder <command>
Platform CLI
codex mcp add pubchem-finder --env PUBCHEM_FINDER_HOME=<PUBCHEM_FINDER_HOME> -- uvx pubchem-finderReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from pubchem-finder <command>
Config file
{
"mcpServers": {
"pubchem-finder": {
"command": "uvx",
"args": [
"pubchem-finder"
],
"env": {
"PUBCHEM_FINDER_HOME": "<PUBCHEM_FINDER_HOME>"
}
}
}
}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>
Config file
{
"servers": {
"pubchem-finder": {
"type": "stdio",
"command": "uvx",
"args": [
"pubchem-finder"
],
"env": {
"PUBCHEM_FINDER_HOME": "<PUBCHEM_FINDER_HOME>"
}
}
}
}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>
Platform CLI
gemini mcp add -e PUBCHEM_FINDER_HOME=<PUBCHEM_FINDER_HOME> pubchem-finder uvx pubchem-finderReplace <…> 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.