pubchem-mcp-server

v0.6.1 pre-1.0

Search PubChem for chemical compounds, properties, safety, bioactivity, and cross-references.

pubchem.caseyjhand.com/mcp
claude mcp add --transport http pubchem-mcp-server https://pubchem.caseyjhand.com/mcp
codex mcp add pubchem-mcp-server --url https://pubchem.caseyjhand.com/mcp
{
  "mcpServers": {
    "pubchem-mcp-server": {
      "url": "https://pubchem.caseyjhand.com/mcp"
    }
  }
}
gemini mcp add --transport http pubchem-mcp-server https://pubchem.caseyjhand.com/mcp
{
  "mcpServers": {
    "pubchem-mcp-server": {
      "command": "bunx",
      "args": [
        "mcp-remote",
        "https://pubchem.caseyjhand.com/mcp"
      ]
    }
  }
}
{
  "mcpServers": {
    "pubchem-mcp-server": {
      "type": "http",
      "url": "https://pubchem.caseyjhand.com/mcp"
    }
  }
}
curl -X POST https://pubchem.caseyjhand.com/mcp \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2026-07-28","capabilities":{},"clientInfo":{"name":"curl","version":"1.0.0"}}}'

Tools

10

pubchem_search_compounds

open-world

Search PubChem for chemical compounds by identifier (name, SMILES, or InChIKey, batched up to 25), molecular formula in Hill notation, substructure or superstructure containment, or 2D Tanimoto similarity. Returns a page of CIDs — reach matches past maxResults with offset. Optionally hydrate results with properties to avoid a follow-up pubchem_get_compound_details call.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pubchem_search_compounds",
    "arguments": {
      "searchType": "<searchType>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "searchType": {
      "type": "string",
      "enum": [
        "identifier",
        "formula",
        "substructure",
        "superstructure",
        "similarity"
      ],
      "description": "Search strategy. \"identifier\": name/SMILES/InChIKey lookup. \"formula\": molecular formula. \"substructure\": find compounds containing the query as a substructure. \"superstructure\": find compounds that are themselves substructures of the query. \"similarity\": 2D Tanimoto similarity to the query."
    },
    "identifierType": {
      "description": "Required for identifier search. Type of chemical identifier: \"name\", \"smiles\", or \"inchikey\".",
      "type": "string",
      "enum": [
        "name",
        "smiles",
        "inchikey"
      ]
    },
    "identifiers": {
      "description": "Required for identifier search. Array of identifiers to resolve (1-25). Examples: [\"aspirin\", \"ibuprofen\"] for name, [\"CC(=O)OC1=CC=CC=C1C(=O)O\"] for SMILES, [\"BSYNRYMUTXBXSQ-UHFFFAOYSA-N\"] for inchikey (27-char block format).",
      "minItems": 1,
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "formula": {
      "description": "Required for formula search. Molecular formula in Hill notation (e.g. \"C6H12O6\", \"CaH2O2\").",
      "type": "string"
    },
    "allowOtherElements": {
      "default": false,
      "description": "Formula search only. When true, includes compounds with additional elements beyond the formula.",
      "type": "boolean"
    },
    "query": {
      "description": "Required for substructure/superstructure/similarity searches. A SMILES string (e.g. \"CC(=O)O\") or PubChem CID as a string (e.g. \"2244\").",
      "type": "string"
    },
    "queryType": {
      "description": "Required for structure/similarity searches. Format of the query: \"smiles\" or \"cid\".",
      "type": "string",
      "enum": [
        "smiles",
        "cid"
      ]
    },
    "threshold": {
      "default": 90,
      "description": "Similarity search only. Minimum Tanimoto similarity (70-100). 90+ for close analogs, 70-80 for scaffold hops. Default: 90.",
      "type": "number",
      "minimum": 70,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first CID to return. Pass the nextOffset from a previous call to read the following page. Identifier lookups resolve every match up front, so paging them is free; formula, substructure, superstructure, and similarity searches have to ask PubChem for offset + maxResults records to reach a page, so deep pages cost progressively more upstream — hence the 10000 ceiling. Default: 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "maxResults": {
      "default": 20,
      "description": "Maximum CIDs to return per page (1-200). Use offset to reach matches past this page. Default: 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "properties": {
      "description": "Optional: fetch these properties for each result, avoiding a follow-up details call. E.g. [\"MolecularFormula\", \"MolecularWeight\", \"CanonicalSMILES\"].",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "MolecularFormula",
          "MolecularWeight",
          "CanonicalSMILES",
          "IsomericSMILES",
          "InChI",
          "InChIKey",
          "IUPACName",
          "Title",
          "XLogP",
          "ExactMass",
          "MonoisotopicMass",
          "TPSA",
          "Complexity",
          "Charge",
          "HBondDonorCount",
          "HBondAcceptorCount",
          "RotatableBondCount",
          "HeavyAtomCount",
          "IsotopeAtomCount",
          "AtomStereoCount",
          "DefinedAtomStereoCount",
          "UndefinedAtomStereoCount",
          "BondStereoCount",
          "DefinedBondStereoCount",
          "UndefinedBondStereoCount",
          "CovalentUnitCount",
          "Volume3D"
        ]
      }
    }
  },
  "required": [
    "searchType",
    "allowOtherElements",
    "threshold",
    "offset",
    "maxResults"
  ],
  "additionalProperties": false
}
view source ↗

pubchem_get_compound_details

open-world

Get detailed compound information by CID. Returns physicochemical properties (molecular weight, SMILES, InChIKey, XLogP, TPSA, etc.), optionally with a textual description (pharmacology, mechanism, therapeutic use), known synonyms, drug-likeness assessment (Lipinski/Veber rules), and/or pharmacological classification (FDA classes, MeSH classes, ATC codes). Accepts up to 100 CIDs per call.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pubchem_get_compound_details",
    "arguments": {
      "cids": "<cids>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cids": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      },
      "description": "PubChem Compound IDs to fetch (1-100). Resolve from names/SMILES with pubchem_search_compounds."
    },
    "properties": {
      "description": "Properties to retrieve. Defaults to a core set: MolecularFormula, MolecularWeight, IUPACName, CanonicalSMILES, IsomericSMILES, InChIKey, XLogP, TPSA, HBondDonorCount, HBondAcceptorCount, RotatableBondCount, HeavyAtomCount, Charge, Complexity.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "MolecularFormula",
          "MolecularWeight",
          "CanonicalSMILES",
          "IsomericSMILES",
          "InChI",
          "InChIKey",
          "IUPACName",
          "Title",
          "XLogP",
          "ExactMass",
          "MonoisotopicMass",
          "TPSA",
          "Complexity",
          "Charge",
          "HBondDonorCount",
          "HBondAcceptorCount",
          "RotatableBondCount",
          "HeavyAtomCount",
          "IsotopeAtomCount",
          "AtomStereoCount",
          "DefinedAtomStereoCount",
          "UndefinedAtomStereoCount",
          "BondStereoCount",
          "DefinedBondStereoCount",
          "UndefinedBondStereoCount",
          "CovalentUnitCount",
          "Volume3D"
        ]
      }
    },
    "includeDescription": {
      "default": false,
      "description": "Include textual descriptions (pharmacology, mechanism, therapeutic use) attributed by source. Well-studied compounds have many overlapping summaries — paged via descriptionOffset/maxDescriptions. Fetched only for the first 10 CIDs in the batch; remaining CIDs return without descriptions and are listed in the response's skippedCids.",
      "type": "boolean"
    },
    "descriptionOffset": {
      "default": 0,
      "description": "Zero-based index of the first description to return within each compound's description list. The same offset is applied to every compound in the batch. Pass the nextDescriptionOffset from a previous call to read the following page. Default: 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "maxDescriptions": {
      "default": 3,
      "description": "Max number of distinct description entries per compound per page (1-20). PubChem returns near-duplicate summaries from many depositors; duplicates are collapsed before this cap applies. Default: 3.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "includeSynonyms": {
      "default": false,
      "description": "Fetch known names and synonyms (trade names, systematic names, registry numbers), paged via synonymOffset/maxSynonyms. Fetched for every found CID in the batch. Slower for large CID lists.",
      "type": "boolean"
    },
    "synonymOffset": {
      "default": 0,
      "description": "Zero-based index of the first synonym to return within each compound's synonym list. The same offset is applied to every compound in the batch. Pass the nextSynonymOffset from a previous call to read the following page. Default: 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "maxSynonyms": {
      "default": 20,
      "description": "Max synonyms returned per compound per page (1-100). PubChem lists hundreds for common drugs; use synonymOffset to reach the ones past this page. Default: 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "includeDrugLikeness": {
      "default": false,
      "description": "Compute drug-likeness assessment: Lipinski Rule of Five (MW, XLogP, HBD, HBA) and Veber rules (TPSA, rotatable bonds). Computed from the returned properties, so it adds no latency.",
      "type": "boolean"
    },
    "includeClassification": {
      "default": false,
      "description": "Include pharmacological classification: FDA Established Pharmacologic Classes, mechanisms of action, MeSH classes, and ATC codes. Fetched only for the first 10 CIDs in the batch; remaining CIDs return without classification and are listed in the response's skippedCids.",
      "type": "boolean"
    }
  },
  "required": [
    "cids",
    "includeDescription",
    "descriptionOffset",
    "maxDescriptions",
    "includeSynonyms",
    "synonymOffset",
    "maxSynonyms",
    "includeDrugLikeness",
    "includeClassification"
  ],
  "additionalProperties": false
}
view source ↗

pubchem_get_compound_image

open-world

Fetch a 2D structure diagram (PNG image) for a compound by CID.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pubchem_get_compound_image",
    "arguments": {
      "cid": "<cid>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cid": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "PubChem Compound ID. Resolve from name/SMILES with pubchem_search_compounds."
    },
    "size": {
      "default": "large",
      "description": "Image size: \"small\" (100x100) or \"large\" (300x300). Default: \"large\".",
      "type": "string",
      "enum": [
        "small",
        "large"
      ]
    }
  },
  "required": [
    "cid",
    "size"
  ],
  "additionalProperties": false
}
view source ↗

pubchem_get_compound_3d_structure

open-world

Get a compound's default 3D conformer — atomic coordinates and bonds — for one CID. format="json" (default) returns atoms and bonds parsed into structured fields; format="sdf" returns the raw V2000 SDF text for passthrough to docking, rendering, or conformer tools. Optionally lists alternate conformer IDs. Not every compound has computed 3D coordinates (large molecules, mixtures, and some salts do not).

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pubchem_get_compound_3d_structure",
    "arguments": {
      "cid": "<cid>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cid": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "PubChem Compound ID. Resolve from name/SMILES with pubchem_search_compounds."
    },
    "format": {
      "default": "json",
      "description": "Output format. \"json\" (default) returns parsed atoms and bonds. \"sdf\" returns the raw V2000 SDF text for passthrough to other tools.",
      "type": "string",
      "enum": [
        "sdf",
        "json"
      ]
    },
    "includeAlternateConformerIds": {
      "default": false,
      "description": "List the IDs of additional computed conformers beyond the default. Slower than the default response. Default: false.",
      "type": "boolean"
    },
    "maxAtoms": {
      "description": "Cap the atoms returned in the format=\"json\" preview. atomCount always reports the full total; omitted rows are disclosed via the truncated/shownAtoms enrichment. Defaults to the first 200 atoms.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "maxBonds": {
      "description": "Cap the bonds returned in the format=\"json\" preview. bondCount always reports the full total; omitted rows are disclosed via the truncated/shownBonds enrichment. Defaults to the first 200 bonds.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "includeRawSdf": {
      "default": false,
      "description": "For format=\"sdf\", return the complete raw V2000 SDF even when it exceeds the safe line cap. Default false: an SDF longer than 500 lines is line-capped with disclosure. No effect when format=\"json\".",
      "type": "boolean"
    }
  },
  "required": [
    "cid",
    "format",
    "includeAlternateConformerIds",
    "includeRawSdf"
  ],
  "additionalProperties": false
}
view source ↗

pubchem_get_compound_xrefs

open-world

Get external database cross-references for a compound: PubMed citations, patent IDs, gene/protein associations, registry numbers, and taxonomy IDs. Results are paged per type — capped at maxPerType with the total count reported; reach the IDs past a page with offset.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pubchem_get_compound_xrefs",
    "arguments": {
      "cid": "<cid>",
      "xrefTypes": "<xrefTypes>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cid": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "PubChem Compound ID. Resolve from name/SMILES with pubchem_search_compounds."
    },
    "xrefTypes": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "RegistryID",
          "RN",
          "PubMedID",
          "PatentID",
          "GeneID",
          "ProteinGI",
          "TaxonomyID"
        ]
      },
      "description": "Cross-reference types to retrieve. String IDs: RegistryID (DSSTox/EPA registry numbers), RN (CAS numbers), PatentID. Numeric IDs: PubMedID, GeneID (NCBI Gene), ProteinGI (legacy NCBI Protein GI), TaxonomyID."
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first ID to return within each xref type. The same offset is applied to every requested type. Pass the nextOffset from a previous call to read the following page. Default: 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "maxPerType": {
      "default": 50,
      "description": "Max IDs to return per xref type per page (1-500). A compound may have thousands of PubMed references; use offset to reach the ones past this page. Total count always reported. Default: 50.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "cid",
    "xrefTypes",
    "offset",
    "maxPerType"
  ],
  "additionalProperties": false
}
view source ↗

pubchem_get_compound_safety

open-world

Get GHS (Globally Harmonized System) hazard classification and safety data for one or more compounds by CID. Returns signal word, pictograms, hazard statements (H-codes), and precautionary statements (P-codes) per compound. Data sourced from PubChem depositors — source attribution included.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pubchem_get_compound_safety",
    "arguments": {
      "cids": "<cids>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cids": {
      "minItems": 1,
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      },
      "description": "PubChem Compound IDs to fetch safety data for (1-25). Resolve from names/SMILES with pubchem_search_compounds."
    }
  },
  "required": [
    "cids"
  ],
  "additionalProperties": false
}
view source ↗

pubchem_get_bioactivity

open-world

Get a compound's bioactivity profile: which assays tested it, activity outcomes (Active/Inactive/Inconclusive), target identifiers (NCBI Gene ID, UniProt/GenBank accession), and quantitative values (IC50, EC50, Ki, etc.). Filter by outcome and/or a specific molecular target (NCBI Gene ID or protein accession) to focus the profile — e.g. "is this compound active against target T?".

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pubchem_get_bioactivity",
    "arguments": {
      "cid": "<cid>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cid": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "PubChem Compound ID. Resolve from name/SMILES with pubchem_search_compounds."
    },
    "outcomeFilter": {
      "default": "all",
      "description": "Filter by activity outcome. \"active\" shows only assays where the compound showed activity — most useful for understanding biological profile. Default: \"all\".",
      "type": "string",
      "enum": [
        "active",
        "inactive",
        "all"
      ]
    },
    "targetGeneId": {
      "description": "Filter to assays against this NCBI Gene ID. Obtain Gene IDs from pubchem_search_assays or the targetGeneId field of an unfiltered result here. Combine with outcomeFilter=\"active\" to answer \"is this compound active against target T?\".",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "targetAccession": {
      "description": "Filter to assays against this target protein accession (UniProt/GenBank), e.g. \"P35354\". Obtain accessions from pubchem_search_assays or the targetAccession field of an unfiltered result here.",
      "type": "string"
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first assay to return, applied after the outcome and target filters. Pass the nextOffset from a previous call to read the following page. Default: 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "maxResults": {
      "default": 20,
      "description": "Max assay results to return per page (1-100). Well-studied compounds have thousands of records; use offset to reach the ones past this page. Default: 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "cid",
    "outcomeFilter",
    "offset",
    "maxResults"
  ],
  "additionalProperties": false
}
view source ↗

pubchem_get_compound_interactions

open-world

Get a compound's interaction data: drug-drug interactions (DrugBank), drug-food interactions, and chemical-target interactions (binding/activity from BindingDB, ChEMBL, and others). Each entry carries its originating source. Results are paged per kind, with the source-record total and the next offset reported for each. Richest for approved drugs; many compounds have no deposited interaction records.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pubchem_get_compound_interactions",
    "arguments": {
      "cid": "<cid>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cid": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "PubChem Compound ID. Resolve from name/SMILES with pubchem_search_compounds."
    },
    "kinds": {
      "default": [
        "drug-drug"
      ],
      "description": "Interaction kinds to fetch. \"drug-drug\" (interactions with other drugs), \"drug-food\" (dietary interactions), \"target\" (binding/activity against molecular targets). Default: [\"drug-drug\"].",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "drug-drug",
          "drug-food",
          "target"
        ]
      }
    },
    "offset": {
      "default": 0,
      "description": "Zero-based start position within each requested kind, counted in source records rather than returned entries. The same offset applies to every kind in the call, and the kinds advance at different rates — when paging past the first page, request one kind per call and pass that kind's nextOffset. Default: 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483646
    },
    "maxEntries": {
      "default": 10,
      "description": "Max entries per kind per page (1-50). Well-studied drugs have a long tail of interactions; use offset to reach the ones past this page. Default: 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "cid",
    "kinds",
    "offset",
    "maxEntries"
  ],
  "additionalProperties": false
}
view source ↗

pubchem_search_assays

open-world

Find PubChem bioassays associated with a biological target. Search by gene symbol (e.g. "EGFR"), protein name, NCBI Gene ID, or UniProt accession. Returns a page of assay IDs (AIDs) — page past maxResults with offset — which can be explored further with pubchem_get_summary.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pubchem_search_assays",
    "arguments": {
      "targetType": "<targetType>",
      "targetQuery": "<targetQuery>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "targetType": {
      "type": "string",
      "enum": [
        "genesymbol",
        "proteinname",
        "geneid",
        "proteinaccession"
      ],
      "description": "Target identifier type. \"genesymbol\" and \"proteinname\" accept text names. \"geneid\" accepts NCBI Gene IDs. \"proteinaccession\" accepts UniProt accessions."
    },
    "targetQuery": {
      "type": "string",
      "description": "Target identifier. Examples: \"EGFR\" (genesymbol), \"Epidermal growth factor receptor\" (proteinname), \"1956\" (geneid), \"P00533\" (proteinaccession)."
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first AID to return. Pass the nextOffset from a previous call to read the following page. Default: 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "maxResults": {
      "default": 50,
      "description": "Max AIDs to return per page (1-200). Popular targets may have thousands of assays; use offset to reach the ones past this page. Default: 50.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "targetType",
    "targetQuery",
    "offset",
    "maxResults"
  ],
  "additionalProperties": false
}
view source ↗

pubchem_get_summary

open-world

Get descriptive summaries for PubChem entities by ID. Supports assays (AID), genes (Gene ID), proteins (UniProt accession), and taxonomy (Tax ID). Up to 10 per call.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pubchem_get_summary",
    "arguments": {
      "entityType": "<entityType>",
      "identifiers": "<identifiers>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "entityType": {
      "type": "string",
      "enum": [
        "assay",
        "gene",
        "protein",
        "taxonomy"
      ],
      "description": "Entity type. Determines ID format and returned fields."
    },
    "identifiers": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string",
            "description": "String identifier (e.g. UniProt accession)."
          },
          {
            "type": "number",
            "description": "Numeric identifier (e.g. AID, Gene ID, Tax ID)."
          }
        ],
        "description": "Entity identifier — string or number depending on entityType."
      },
      "description": "Entity identifiers (1-10). Type depends on entityType:\n- assay: AID (number), e.g. [1000]\n- gene: Gene ID (number), e.g. [1956]\n- protein: UniProt accession (string), e.g. [\"P00533\"]\n- taxonomy: Tax ID (number), e.g. [9606]"
    }
  },
  "required": [
    "entityType",
    "identifiers"
  ],
  "additionalProperties": false
}
view source ↗

Resources

6

Core physicochemical properties for a PubChem compound by CID. Use pubchem_get_compound_details to select properties or add descriptions, synonyms, drug-likeness, and classification.

uri pubchem://compound/{cid} mime application/json

GHS hazard classification for a PubChem compound by CID — signal word, pictograms, hazard (H) and precautionary (P) statements. Not every compound carries a deposited classification.

uri pubchem://compound/{cid}/safety mime application/json

A 2D structure diagram (PNG, 300x300) for a PubChem compound by CID. Use pubchem_get_compound_image to choose the image size.

uri pubchem://compound/{cid}/image mime image/png

External cross-references (CAS RN, registry IDs, PubMed) for a PubChem compound by CID, up to 25 per type. Use pubchem_get_compound_xrefs for the full set of xref types, a higher per-type cap, and to page through the rest with offset.

uri pubchem://compound/{cid}/xrefs mime application/json

Bioassay activity profile for a PubChem compound by CID. Returns up to 25 assays; use pubchem_get_bioactivity to filter by outcome or molecular target, raise the cap, and page through the rest with offset.

uri pubchem://compound/{cid}/bioactivity mime application/json

Summary for a PubChem BioAssay by AID — name, description, source, protocol, and substance counts.

uri pubchem://assay/{aid} mime application/json