Formlab MCP server

Read from the package source without running it. The installed server may list more.

• compare_formulations

  Compare two or more formulations side-by-side on the same set of leaf ingredients (flattened wt-%). Returns one row per ingredient with each formula's wt-% in its own column. Useful for "what's different between Formula A and Formula B" questions.

• find_by_smarts

  Find every ingredient whose SMILES contains the given SMARTS substructure pattern. Requires RDKit-JS (optional dependency); install with `npm install @rdkit/rdkit` in the mcp folder if you get a "not installed" error.

• find_failures

  Pareto-style failure analysis: which test parameters fail their acceptance criteria most often, and on which samples / formulations. Returns ranked list of (parameter, failureCount, failureRate, exampleFailures).

• find_similar_formulations

  Find formulations whose flattened composition contains a given ingredient (by name or id) above a threshold wt-%. Useful for "what other formulas use silicone oil at ≥5%" queries. Returns ranked by wt-% descending.

• get_batch

  Get full details for a single batch including its actual composition (as-prepared, when logged), child samples, lineage (parent / sub-blend parents), and inventory consumption note. Accepts internal id or UID.

• get_coverage_matrix

  Coverage map: which formulations have been tested on which parameters. Returns counts per (formulation × parameter) cell so the LLM can answer "what's untested" or "what's been measured many times" questions.

• get_doe_matrix

  Build a Design-of-Experiments style pivot matrix: rows = formulations (or samples / batches / tests), columns = composition wt-% per ingredient + aggregated test-parameter values. Same shape as the FormLab DOE Matrix view. Returns CSV when format=csv (default) for compact LLM consumption, or structured JSON when format=json.

• get_formulation

  Get full details for a single formulation including its composition (raw rows AND flattened wt-% leaves with sub-formulas expanded), step procedure, and recent batches. Accepts either internal id or UID (e.g. FORM-001).

• get_ingredient

  Get full details for a single ingredient including stock movements, formulations using it, and stock-on-hand. Accepts internal id or UID (e.g. ING-001).

• get_sample

  Get full details for a single sample including its actual variant composition, all test results bound to it, blend lineage, and storage info. Accepts internal id or UID (e.g. SAMP-0001).

• get_test_result

  Get full details for a single test result report including every measurement's value, unit, type, and acceptance criteria. Accepts internal id or UID.

• list_batches

  List batches (production / lab-prep events), optionally filtered by formulation, status, or origin-only (hides batches derived from other batches). Returns metadata; use get_batch for the full consumption ledger and samples.

• list_formulations

  List formulations (recipes) in the FormLab database, optionally filtered by status, project, family, tag, or name pattern. Returns one row per formula with key metadata. Use get_formulation for the full composition.

• list_ingredients

  List ingredients (raw materials) in the FormLab library, optionally filtered by family, supplier, or name pattern. Returns metadata; use get_ingredient for full details.

• list_samples

  List samples (physical specimens), optionally filtered by batch, formulation, status, or origin (which batch they came from). Returns metadata; use get_sample for tests and variant composition.

• list_test_results

  List test result reports, optionally filtered by sample, parameter, date range, or lab. Returns metadata + parameters tested. Use get_test_result for full measurement values.

• Code scan8 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancerepository not readable: repo not found3/15
• Maintainer identityno repository or website to verify2/10

Formlab: common questions

Is Formlab MCP server safe?

With care: it is graded C, so read the findings first (65/100). Read the Formlab safety report

How do I install Formlab?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does Formlab need an API key?

Not as far as the registry entry and our scan can tell: no credentials are declared or required.

Is Formlab maintained?

The latest release is v0.1.7.