HardCopy Labs MCP Server

Look up the current status of a print job (submitted, approved, printing, QC, shipped) and its UPS tracking number once shipped. Use when the user asks about an order they placed with HardCopy Labs.

MANDATORY before creating any order or checkout, including reorders. Render exact validated geometry and quote the whole order. Display EVERY returned part image with name, dimensions, material/color, quantity, notes and total to the buyer. The in-chat card shows images where supported; otherwise embed image_url values or give viewer_url and ask the buyer to review there. Never substitute an AI illustration, or describe unshown images as reviewed. Ask for explicit buyer confirmation of this version only after presenting the preview. Changes require a new preview and new confirmation; pass replaces_preview_id to revoke the old preview. Preview failure blocks ordering. After confirmation call submit_print_job (or reorder_print_job) using preview_id, preview_version, buyer_confirmed=true and shipping/contact details; do not resend models or option overrides. Preview generation and viewing never create an order. Separate parts are displayed individually, not as an inferred assembly.

A REORDER ALSO REQUIRES A NEW VISUAL PREVIEW AND BUYER CONFIRMATION. First call preview_print_order with reorder_of and any desired changes, show every image/options/price to the buyer, and obtain confirmation. Then call this with preview_id, preview_version and buyer_confirmed=true, without option overrides. Without a preview this returns a preview only; it never creates an order. In preview_print_order, quantity means complete sets for multi-part reorders; material/color overrides apply to every part. Omit overrides to preserve choices. Prices are recalculated. The previous order's geometry is reused without requesting a new upload. Shipping/contact details are never copied from the previous order; confirm the new address with the buyer. Orders cancelled by HardCopy Labs or still awaiting payment cannot be reordered. Returns a new job ID, total and payment link when payment is required, only after the new preview is confirmed.

Create an order ONLY AFTER preview_print_order, image display and buyer confirmation. First present every preview image (or the viewer fallback), dimensions, material/color, quantity and quote. Obtain explicit buyer confirmation for that preview version. Then send preview_id, preview_version, buyer_confirmed=true, job_name and shipping details ONLY; omit model/options fields. Any relevant change needs a new preview. Legacy model inputs without a preview return a preview and NEVER create an order. Set geometry, material, color, quantities and operator notes in preview_print_order. OpenSCAD is preferred for designs made in conversation; uploaded STL and cached model IDs are also supported there. One preview covers the whole multi-part order. Confirm the shipping address with the buyer. ship_to requires their full name and US address; contact_email is used for updates. This returns a job ID and total, plus a payment link when payment is required. The buyer pays in their own browser.

Check whether a 3D model can be printed, before ordering. A text validation quote is NOT approval to order. Call preview_print_order next, show its exact model images/options/price to the buyer, then obtain confirmation. Use this when the user has an STL file (base64-encoded) and wants to know if it is printable, or as a pre-check before submit_print_job. Returns printability (watertight/manifold status), dimensions, which printers it fits on, and the total for each material: what submit_print_job will charge for this file, shipping included. If the user is designing an object in this conversation, generate the STL, then call this to confirm it can be manufactured. Pass quantity (default 1) when the user wants several copies, so the totals cover all of them. For multiple parts, pass the WHOLE order in parts with each material/color/quantity. Never add separate quotes: totals already include shipping and handling once. To keep payloads small, validate each STL first and reuse its model_id (24 hours). PLA and PETG are the only materials offered.