# PubChem Finder

> PubChem Finder is an open-source MCP server for health and science. Structure search over PubChem with a local fingerprint index, live lookups and RDKit tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/mysterionrise/pubchem-finder
- **MCP Registry name:** io.github.MysterionRise/pubchem-finder
- **Categories:** health and science
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add pubchem-finder -- uvx pubchem-finder
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/pubchem-finder
