Filament intelligence for slicers and agents
ParaMat provides machine-readable consensus settings for 3,689 FFF/FDM filament product lines, read-only job preflight, and a private-by-default outcome contract. Use MCP for agent workflows or the JSON API directly from a slicer.
Safe starting points, not guaranteed optima. Returned settings should be checked against the printer, hotend, nozzle, and manufacturer limits, then verified with a small calibration print.
Choose an integration
MCP for AI agents
Connect a Streamable HTTP MCP client to:
https://mcp.paramat3d.comRecommended flow: identify_by_gtin for a scanned barcode, or search_materials followed by get_print_settings.
JSON for slicers
No agent runtime is required. The read-only endpoints allow cross-origin GET requests and return JSON:
GET https://mcp.paramat3d.com/v1/search?q=bambu%20pla%20basic
GET https://mcp.paramat3d.com/v1/settings?brand=Bambu%20Lab&product=PLA%20Basic
GET https://mcp.paramat3d.com/v1/gtin?barcode=...
POST https://mcp.paramat3d.com/v1/preflight
POST https://mcp.paramat3d.com/v1/outcome/validateFrom a label photo to settings
A vision-capable slicer or agent can read the visible brand, product family, and barcode from a spool label, then call identify_by_gtin when a barcode is reliable or search_materials with the recognized label text. It should show candidate identity and confidence before calling get_print_settings; image files are not uploaded to or retained by ParaMat.
MCP tools
| Tool | Purpose |
|---|---|
search_materials | Resolve label text to candidate brand/product identities. |
get_print_settings | Return nozzle and bed ranges, flow, volumetric speed, fan, retraction, pressure advance, density, handling guidance, confidence, and sources where available. |
identify_by_gtin | Resolve an EAN/UPC/GTIN barcode to a material and its settings. |
prepare_data_issue | Create a reviewable issue-email draft. It never sends or stores the report. |
preflight_print_job | Detect identity, sourced-temperature, hardware-limit, nozzle, enclosure, drying, and quantity issues without changing the printer. |
get_outcome_receipt_spec | Return the private-by-default outcome contract and schema links. |
validate_outcome_receipt | Validate a receipt without retaining, publishing, or promoting it. |
Minimal slicer example
const url = new URL("https://mcp.paramat3d.com/v1/settings");
url.searchParams.set("brand", filament.brand);
url.searchParams.set("product", filament.product);
const response = await fetch(url);
if (!response.ok) throw new Error(`ParaMat lookup failed: ${response.status}`);
const settings = await response.json();
// Present as suggested starting values; let the operator review before applying.Preflight and outcome loop
Before proposing a profile change, call preflight_print_job with the resolved material, active spool, slicer profile, printer limits, nozzle, enclosure state, and job estimate. Treat blocked_by_policy as a stop, show warnings and unknowns, and always require operator confirmation. After the print, create a receipt using the outcome schema or the private browser form; validation is non-retaining and local storage remains the default. Record quantified moisture, orientation, plate layout, and measured machine values when known—those are the current highest-value uncertainty fields.
Application guidance
- Keep missing values as unknown; do not invent defaults.
- Show source count and cross-source spread beside recommendations.
- Require operator review before changing an active printer profile.
- Respect hardware and material maximum ratings.
- Relay the ParaMat attribution and calibration disclaimer.
For filament manufacturers
Publish revisioned, machine-readable settings through the ParaMat manufacturer program. Verified authority is shown separately from community confidence so agents know whether a profile is official, cross-confirmed, or single-source.
Report missing or incorrect data
Agents can call prepare_data_issue, then present or send the returned draft through an approved email capability. Humans and programs can also write directly to paramat3d@sunn3d.com. ParaMat’s MCP endpoint itself does not send email, which prevents it from being used as an open mail relay.
Discovery and license
MCP server manifest · preflight schema · outcome schema · outcome example · LLM-readable index · source and issues
Dataset: CC BY 4.0. Attribute “ParaMat / Sunnyday Technologies” and link to paramat3d.com.