MSDS Chain

Ask any chemical safety question in natural language. Handles: storage conditions, spill/exposure emergency procedures, first-aid measures, PPE requirements, disposal guidance, MSDS lookups, GHS label interpretation, and general lab safety questions. Use this as the catch-all when the question doesn't fit neatly into compatibility, risk warnings, or compliance checks. Args: question: Any chemical safety question, e.g. "How should I store acetone and methanol in the same cabinet?" "What PPE is needed when handling concentrated HCl?" "Is it safe to dispose of acetone down the drain?"

Run a comprehensive safety check on a list of chemicals in one call. Returns a combined report with: - Pairwise compatibility matrix (compatible/caution/incompatible) - PPE requirements (merged across all chemicals) - Storage grouping recommendations (which chemicals can share a cabinet) - Key risk warnings This is the recommended first call when reviewing an experiment protocol or Opentrons deck layout — it gives a complete safety picture without needing to call multiple tools separately. Args: chemicals: List of chemical names or CAS numbers (2-20 items), e.g. ["acetone", "sulfuric acid", "sodium hydroxide", "methanol"]

Check pairwise compatibility between a list of chemicals. Returns compatibility status (compatible / caution / incompatible) for each pair, along with specific hazard reasons and storage recommendations. Use this before an experiment to verify it is safe to use the listed chemicals together in the same lab setting. Args: chemicals: List of chemical names or CAS numbers, e.g. ["acetone", "methanol", "ethanol"] or ["67-64-1", "67-56-1"]

Determine the safe order for mixing/adding two chemicals. Returns the recommended addition sequence, the dangerous sequence to avoid, reasoning (exothermic potential, gas evolution, splashing risk), and any required precautions (cooling, dilution rate, inert atmosphere). Classic examples: "acid into water, never water into acid"; "add oxidizer to substrate slowly, not the reverse". Use this when reviewing liquid transfer steps in an Opentrons protocol or any manual procedure involving sequential addition of reagents. Args: chemical_a: First chemical name or CAS number chemical_b: Second chemical name or CAS number context: Optional context about the procedure, e.g. "diluting for titration" or "quenching a reaction"

Check multi-region regulatory compliance status for chemicals. Checks against: EU (SVHC/REACH/CLP/CMR), US (OSHA PEL/TSCA), CN, JP, KR, CA, AU, TW regulations. Use this when preparing export documentation, compliance audits, or when working with chemicals that may be restricted in certain jurisdictions. Args: chemicals: List of chemical names or CAS numbers regions: Optional list of region codes to check, e.g. ["EU", "US", "CN"] Defaults to EU + US if not specified. Valid codes: EU, US, CN, JP, KR, CA, AU, TW

Check which international regulatory lists a chemical appears on. Searches across 15+ regulatory databases including: - US: EPA TSCA, OSHA PEL, California Prop 65, CompTox - EU: SVHC Candidate List, REACH Annex XVII, CLP, Seveso III - APAC: China Hazardous Chemicals, Japan CSCL, Australia AIIC, Singapore EPMA - Americas: Canada DSL Returns a summary of all matching lists, helping you understand a chemical's global regulatory footprint at a glance. Args: chemical: Chemical name or CAS number

Compare two versions of a Safety Data Sheet (SDS) for the same chemical. Identifies what changed between revisions: new hazard classifications, updated exposure limits, revised PPE requirements, changed storage conditions, regulatory status updates, or H-code additions/removals. Useful for tracking regulatory compliance when a supplier issues a new SDS, or for auditing whether a chemical's risk profile has changed over time. Args: chemical: Chemical name or CAS number, e.g. "acetone" or "67-64-1" version_old: Description of the older SDS version — can be a version number ("v7.2"), a date ("January 2022"), or a brief summary of key fields ("NFPA H1/F3/R0, no CMR listing"). version_new: Description of the newer SDS version — same format as version_old, e.g. "v8.1" or "March 2024". Returns: A structured diff report covering: GHS classification changes, H-code additions/removals, PPE updates, exposure limit changes, storage condition changes, regulatory listing changes, and an overall risk-trend assessment (increased / decreased / unchanged).

Run a full MSDS safety audit for a list of chemicals and return a session id. Creates a persistent audit session on MSDS Chain, runs pairwise compatibility and risk analysis across all chemicals, and returns a session_id that can later be passed to `get_audit_report` to fetch the signed PDF report URL. Use this when the user wants an archivable, signed record of a safety review (e.g. for SOPs, compliance audits, or to share with a PI / safety officer), rather than a one-off Q&A. Args: experiment_name: Short human-readable label for the audit, e.g. "Grignard prep — 2026-04-16" or "Solvent screening #3". chemicals: List of chemical names or CAS numbers to include in the audit, e.g. ["acetone", "methanol", "67-64-1"]. Returns: Session id + compatibility summary (compatible/caution/incompatible pair counts + top warnings). An API key must be configured (MSDS_API_KEY) so the session is bound to your account and the report is retrievable.

Get a short-lived signed URL to download the audit report PDF. Use after `create_audit_session` to retrieve an archivable PDF report containing the chemicals, compatibility matrix, risk warnings, and session metadata. Args: session_id: The session id returned by `create_audit_session`, e.g. "DEMO-A1B2C3D4". Returns: A signed URL valid for ~5 minutes. The session must be owned by the API key's user (MSDS_API_KEY).

Suggest safer alternatives for a chemical, considering its intended use. Returns 2-4 alternative chemicals with: name, CAS number, why it's safer (lower toxicity, higher flash point, non-CMR, etc.), any trade-offs (cost, availability, performance), and relevant regulatory context (e.g., REACH SVHC substitution requirement). Use this when a chemical is flagged as high-risk, restricted, or when the user is exploring greener chemistry options. Args: chemical: Chemical name or CAS number to find alternatives for use_case: Optional context about how the chemical is being used, e.g. "degreasing solvent", "extraction solvent for organic synthesis", "cleaning agent for labware"