Skip to content
MCP server

PubChem Finder

Structure search over PubChem with a local fingerprint index, live lookups and RDKit tools

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, API
Runs
Locally
Version
2.2.3
Listing updated
2 days ago

About PubChem Finder

PubChem Finder is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.

Most PubChem connectors forward questions to PubChem's web API, where structure search is rate-limited and can time out. This server builds a local fingerprint index instead, so similarity and substructure searches return scored results in milliseconds using FPSim2. Until you build an index it searches a built-in set of 1,932 FDA-approved drugs and says so; the README also shows a demo over the first 444,794 PubChem compounds.

Offline RDKit tools cover descriptors, salt removal, QED, synthetic accessibility, PAINS/Brenk/NIH alerts, Lipinski checks and structure drawings with highlighted matches. Live tools fetch names, CAS numbers, GHS hazard data, pharmacology, toxicity and bioassay summaries, each citing its source.

It installs with uv, runs over stdio (or HTTP on 127.0.0.1:8000), and keeps the index in the directory set by PUBCHEM_FINDER_HOME. There is no database server and no Docker.

Install

Run in a terminal

claude mcp add pubchem-finder -- uvx pubchem-finder

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pubchem-finder": {
      "command": "uvx",
      "args": [
        "pubchem-finder"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pubchem-finder": {
      "command": "uvx",
      "args": [
        "pubchem-finder"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pubchem-finder": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pubchem-finder"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pubchem-finder": {
      "command": "uvx",
      "args": [
        "pubchem-finder"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pubchem-finder": {
      "command": "uvx",
      "args": [
        "pubchem-finder"
      ]
    }
  }
}

Configuration

  • PUBCHEM_FINDER_HOMEData directory for the local index and the PubChem response cache (default: the platform's user data directory)

Tools this server provides (17)

Taken from the project documentation; the running server may differ.

pubchem_lookup
Resolves a name, CID, SMILES or InChIKey to PubChem records with identifiers and properties.
compound_properties
RDKit descriptors and a Lipinski check for a SMILES, offline.
standardize
Removes salts and counter-ions, neutralizes and canonicalizes a structure.
compare
Tanimoto similarity between two structures on ECFP4 and MACCS fingerprints.
medchem_profile
QED, synthetic accessibility, Lipinski/Veber rules, PAINS/Brenk/NIH alerts and Murcko scaffold.
draw_molecules
Draws structures inline with optional SMARTS highlighting or comparison to a reference.
similarity_search
Finds the most similar compounds in the local index.
substructure_search
Finds indexed compounds containing a SMILES or SMARTS fragment.
index_status
Reports whether the local index is built and what it covers.
pubchem_similarity_search
Live similarity search across all of PubChem, re-scored with ECFP4.
pubchem_substructure_search
Live search for PubChem compounds containing a fragment.
pubchem_exact_match
Returns PubChem records for exactly this structure.
pubchem_synonyms
Common, brand and systematic names plus CAS numbers.
pubchem_xrefs
Registry IDs, PubMed articles and patents.
pubchem_description
Curated compound descriptions with sources.
pubchem_annotations
One section of the compound page such as GHS classification, pharmacology or toxicity.
pubchem_bioactivity
Bioassay summary with outcomes, top targets and lowest potency values.

What it does

Scored similarity search
Ranks indexed compounds by ECFP4 Tanimoto similarity, optionally grouped by Murcko scaffold.
Substructure search
Matches SMILES or SMARTS fragments with a fingerprint screen and an atom-by-atom check.
Offline RDKit chemistry
Descriptors, standardization, QED, synthetic accessibility and structural alerts for any SMILES.
Molecule drawings
Renders structures inline, highlighting a SMARTS match or what changed against a reference.
Cited PubChem data
Synonyms, hazards, pharmacology, toxicity and bioassays, each naming its source.
Local index
Builds a file-based index of all or part of PubChem with no server.

Good for

  • Find the closest analogues of a drug and see what changed
  • Check a compound for PAINS alerts and Lipinski compliance
  • Look up the GHS label and hazards for a compound
  • Find indexed compounds containing an aryl sulfonamide
  • Summarize the main bioassay targets of a drug

Pricing

Open source

Free; install from PyPI

PubChem Finder FAQ

What does it search before I build an index?

A built-in demo set of 1,932 FDA-approved drugs, built in about a second on first use.

How do I install it in Claude Code?

Run `claude mcp add pubchem-finder -- uvx --python 3.14 pubchem-finder mcp`.

Where is data stored?

In the directory named by PUBCHEM_FINDER_HOME, by default the platform's user data directory.

Can it run over HTTP?

Yes, with `--transport http` on 127.0.0.1:8000, but it has no authentication or TLS of its own.

Is PubChem Finder free?

Yes. PubChem Finder is open source, so you can use and self-host it for free.

How do I add PubChem Finder to Claude Code?

Run this command in your terminal: claude mcp add pubchem-finder -- uvx pubchem-finder

What are the best alternatives to PubChem Finder?

The closest alternatives to PubChem Finder are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

Alternatives to PubChem Finder

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science