MCP Server
HardCopy Labs
com.hardcopylabs/hardcopy
What this MCP does
Validates 3D models, estimates print pricing and submits physical 3D-print orders for shipment, with status and reorder support.
Capabilities
Tools
5
tools
check_job_status
Check an order's status
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.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'check_job_statusArguments', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'title': 'Job Id', 'description': 'The order id, like hc-1a2b3c4d, returned by submit_print_job.'}}}
Output schema
{'type': 'object', 'title': 'check_job_statusOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
preview_print_order
Preview the exact parts before ordering
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.
Read only
Idempotent
Input schema
{'type': 'object', '$defs': {'OrderPart': {'type': 'object', 'title': 'OrderPart', 'required': ['name'], 'properties': {'name': {'type': 'string', 'title': 'Name', 'maxLength': 120, 'minLength': 1, 'description': 'Short part name, shown on the card and receipt.'}, 'color': {'type': 'string', 'title': 'Color', 'default': 'black', 'maxLength': 40, 'description': 'Filament color for this part.'}, 'material': {'type': 'string', 'title': 'Material', 'default': 'pla', 'maxLength': 20, 'description': 'PLA or PETG only.'}, 'model_id': {'type': 'string', 'title': 'Model Id', 'default': '', 'maxLength': 64, 'description': 'Reusable id from validate_stl; valid for 24 hours.'}, 'quantity': {'type': 'integer', 'title': 'Quantity', 'default': 1, 'maximum': 500, 'minimum': 1, 'description': "Copies of THIS part. Capped by how long this part takes to print, not a flat number -- checked once its geometry is known; a rejected order reports the real cap for this part's size."}, 'stl_base64': {'type': 'string', 'title': 'Stl Base64', 'default': '', 'maxLength': 25000000, 'description': 'STL in millimeters; give exactly one model source.'}, 'openscad_source': {'type': 'string', 'title': 'Openscad Source', 'default': '', 'maxLength': 50000, 'description': 'OpenSCAD in millimeters; give exactly one model source.'}}, 'additionalProperties': False}}, 'title': 'preview_print_orderArguments', 'properties': {'color': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Color', 'default': None, 'description': 'Selected filament color. Default black for new models; omit to retain reorder colors.'}, 'notes': {'type': 'string', 'title': 'Notes', 'default': '', 'description': 'Operator instructions to show and bind to this preview; changes require a new preview.'}, 'parts': {'anyOf': [{'type': 'array', 'items': {'$ref': '#/$defs/OrderPart'}, 'maxItems': 20}, {'type': 'null'}], 'title': 'Parts', 'default': None, 'description': "The WHOLE order, one entry per part. Use a model_id from earlier validation, an STL, or OpenSCAD. Each entry has its own name, material, color and quantity. Each part's quantity is capped by its own print time, not a flat count. Shipping and handling are charged once; never add independent quote totals."}, 'job_name': {'type': 'string', 'title': 'Job Name', 'default': '', 'description': 'Short order name shown with the preview.'}, 'material': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Material', 'default': None, 'description': 'PLA or PETG. Default PLA for new models; omit to retain reorder materials.'}, 'quantity': {'type': 'integer', 'title': 'Quantity', 'default': 1, 'description': 'How many identical copies. The totals cover all of them. Capped by how long the part takes to print, not a flat number -- a quick part allows many copies, a very large or slow one may allow as few as 1; submit_print_job reports the real cap if this is too many.'}, 'reorder_of': {'type': 'string', 'title': 'Reorder Of', 'default': '', 'description': 'Existing order ID to preview for reorder; omit new model inputs when using this.'}, 'stl_base64': {'type': 'string', 'title': 'Stl Base64', 'default': '', 'description': 'The model as a base64-encoded STL file (binary or ASCII), in millimeters.'}, 'openscad_source': {'type': 'string', 'title': 'Openscad Source', 'default': '', 'description': 'OpenSCAD source in millimeters. Rendered and validated before preview; never an illustrative AI image.'}, 'replaces_preview_id': {'type': 'string', 'title': 'Replaces Preview Id', 'default': '', 'description': 'When revising an unplaced order, pass its previous preview id. It is invalidated even if the new render fails.'}}}
Output schema
{'type': 'object', 'title': 'preview_print_orderOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
reorder_print_job
Reorder a past print
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.
Open world
Input schema
{'type': 'object', 'title': 'reorder_print_jobArguments', 'required': ['job_id', 'ship_to'], 'properties': {'color': {'type': 'string', 'title': 'Color', 'default': '', 'description': "Filament color. Leave empty to keep the earlier order's color."}, 'notes': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Notes', 'default': None, 'description': 'Optional notes for the operator.'}, 'job_id': {'type': 'string', 'title': 'Job Id', 'description': 'The id of the earlier order to copy, like hc-1a2b3c4d.'}, 'ship_to': {'type': 'string', 'title': 'Ship To', 'description': "Recipient's full name and US street address, including city, state and ZIP. Not copied from the earlier order. We ship within the United States only."}, 'material': {'type': 'string', 'title': 'Material', 'default': '', 'description': "pla or petg. Leave empty to keep the earlier order's material."}, 'quantity': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Quantity', 'default': None, 'description': 'How many identical copies. Capped by print time, not a flat number; the totals cover all of them.'}, 'preview_id': {'type': 'string', 'title': 'Preview Id', 'default': '', 'description': 'The id returned by preview_print_order for the images shown to the buyer.'}, 'contact_email': {'type': 'string', 'title': 'Contact Email', 'default': '', 'description': "The buyer's email, for the receipt and order updates. Not copied from the earlier order."}, 'buyer_confirmed': {'type': 'boolean', 'title': 'Buyer Confirmed', 'default': False, 'description': 'True ONLY after showing every preview image/options/price and receiving explicit buyer confirmation. Not proof of human viewing.'}, 'preview_version': {'type': 'string', 'title': 'Preview Version', 'default': '', 'description': 'The exact preview version the buyer confirmed; changes require a new preview.'}}}
Output schema
{'type': 'object', 'title': 'reorder_print_jobOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
submit_print_job
Order a 3D print
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.
Open world
Input schema
{'type': 'object', '$defs': {'OrderPart': {'type': 'object', 'title': 'OrderPart', 'required': ['name'], 'properties': {'name': {'type': 'string', 'title': 'Name', 'maxLength': 120, 'minLength': 1, 'description': 'Short part name, shown on the card and receipt.'}, 'color': {'type': 'string', 'title': 'Color', 'default': 'black', 'maxLength': 40, 'description': 'Filament color for this part.'}, 'material': {'type': 'string', 'title': 'Material', 'default': 'pla', 'maxLength': 20, 'description': 'PLA or PETG only.'}, 'model_id': {'type': 'string', 'title': 'Model Id', 'default': '', 'maxLength': 64, 'description': 'Reusable id from validate_stl; valid for 24 hours.'}, 'quantity': {'type': 'integer', 'title': 'Quantity', 'default': 1, 'maximum': 500, 'minimum': 1, 'description': "Copies of THIS part. Capped by how long this part takes to print, not a flat number -- checked once its geometry is known; a rejected order reports the real cap for this part's size."}, 'stl_base64': {'type': 'string', 'title': 'Stl Base64', 'default': '', 'maxLength': 25000000, 'description': 'STL in millimeters; give exactly one model source.'}, 'openscad_source': {'type': 'string', 'title': 'Openscad Source', 'default': '', 'maxLength': 50000, 'description': 'OpenSCAD in millimeters; give exactly one model source.'}}, 'additionalProperties': False}}, 'title': 'submit_print_jobArguments', 'required': ['job_name'], 'properties': {'color': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Color', 'default': None, 'description': 'Filament color, e.g. black or white.'}, 'notes': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Notes', 'default': None, 'description': 'Optional notes for the operator, e.g. which face should look best.'}, 'parts': {'anyOf': [{'type': 'array', 'items': {'$ref': '#/$defs/OrderPart'}, 'maxItems': 20}, {'type': 'null'}], 'title': 'Parts', 'default': None, 'description': "The WHOLE order, one entry per part. Use a model_id from earlier validation, an STL, or OpenSCAD. Each entry has its own name, material, color and quantity. Each part's quantity is capped by its own print time, not a flat count. Shipping and handling are charged once; never add independent quote totals."}, 'ship_to': {'type': 'string', 'title': 'Ship To', 'default': '', 'description': "Required. Recipient's full name and US street address, including city, state and ZIP. We ship within the United States only."}, 'job_name': {'type': 'string', 'title': 'Job Name', 'description': 'A short name for the item, shown on the order and the receipt, e.g. "Desk cable clip".'}, 'material': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Material', 'default': None, 'description': 'Print material: pla or petg.'}, 'quantity': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Quantity', 'default': None, 'description': 'How many identical copies. Capped by print time, not a flat number; the totals cover all of them.'}, 'preview_id': {'type': 'string', 'title': 'Preview Id', 'default': '', 'description': 'The id returned by preview_print_order for the images shown to the buyer.'}, 'stl_base64': {'type': 'string', 'title': 'Stl Base64', 'default': '', 'description': 'The model as a base64-encoded STL file, in millimeters. Give this or openscad_source, not both.'}, 'contact_email': {'type': 'string', 'title': 'Contact Email', 'default': '', 'description': "The buyer's email, for the receipt and order updates."}, 'buyer_confirmed': {'type': 'boolean', 'title': 'Buyer Confirmed', 'default': False, 'description': 'True ONLY after showing every preview image/options/price and receiving explicit buyer confirmation. Not proof of human viewing.'}, 'openscad_source': {'type': 'string', 'title': 'Openscad Source', 'default': '', 'description': 'OpenSCAD source for the model, in millimeters; rendered on our server. Preferred for models designed in the conversation. Give this or stl_base64, not both.'}, 'preview_version': {'type': 'string', 'title': 'Preview Version', 'default': '', 'description': 'The exact preview version the buyer confirmed; changes require a new preview.'}}}
Output schema
{'type': 'object', 'title': 'submit_print_jobOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
validate_stl
Check a 3D model and get a price
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.
Read only
Idempotent
Input schema
{'type': 'object', '$defs': {'OrderPart': {'type': 'object', 'title': 'OrderPart', 'required': ['name'], 'properties': {'name': {'type': 'string', 'title': 'Name', 'maxLength': 120, 'minLength': 1, 'description': 'Short part name, shown on the card and receipt.'}, 'color': {'type': 'string', 'title': 'Color', 'default': 'black', 'maxLength': 40, 'description': 'Filament color for this part.'}, 'material': {'type': 'string', 'title': 'Material', 'default': 'pla', 'maxLength': 20, 'description': 'PLA or PETG only.'}, 'model_id': {'type': 'string', 'title': 'Model Id', 'default': '', 'maxLength': 64, 'description': 'Reusable id from validate_stl; valid for 24 hours.'}, 'quantity': {'type': 'integer', 'title': 'Quantity', 'default': 1, 'maximum': 500, 'minimum': 1, 'description': "Copies of THIS part. Capped by how long this part takes to print, not a flat number -- checked once its geometry is known; a rejected order reports the real cap for this part's size."}, 'stl_base64': {'type': 'string', 'title': 'Stl Base64', 'default': '', 'maxLength': 25000000, 'description': 'STL in millimeters; give exactly one model source.'}, 'openscad_source': {'type': 'string', 'title': 'Openscad Source', 'default': '', 'maxLength': 50000, 'description': 'OpenSCAD in millimeters; give exactly one model source.'}}, 'additionalProperties': False}}, 'title': 'validate_stlArguments', 'properties': {'parts': {'anyOf': [{'type': 'array', 'items': {'$ref': '#/$defs/OrderPart'}, 'maxItems': 20}, {'type': 'null'}], 'title': 'Parts', 'default': None, 'description': "The WHOLE order, one entry per part. Use a model_id from earlier validation, an STL, or OpenSCAD. Each entry has its own name, material, color and quantity. Each part's quantity is capped by its own print time, not a flat count. Shipping and handling are charged once; never add independent quote totals."}, 'quantity': {'type': 'integer', 'title': 'Quantity', 'default': 1, 'description': 'How many identical copies. The totals cover all of them. Capped by how long the part takes to print, not a flat number -- a quick part allows many copies, a very large or slow one may allow as few as 1; submit_print_job reports the real cap if this is too many.'}, 'stl_base64': {'type': 'string', 'title': 'Stl Base64', 'default': '', 'description': 'The model as a base64-encoded STL file (binary or ASCII), in millimeters.'}}}
Output schema
{'type': 'object', 'title': 'validate_stlOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
History
Recent tool changes
Changed
reorder_print_job
Oct. 2, 2026, 2:41 a.m.
Changed
submit_print_job
Oct. 2, 2026, 2:41 a.m.
Changed
validate_stl
Oct. 2, 2026, 2:41 a.m.
Added
preview_print_order
Oct. 2, 2026, 2:41 a.m.
Added
reorder_print_job
Sept. 28, 2026, 2:40 a.m.
Changed
check_job_status
Sept. 28, 2026, 2:40 a.m.
Changed
submit_print_job
Sept. 28, 2026, 2:40 a.m.
Changed
validate_stl
Sept. 28, 2026, 2:40 a.m.
Added
check_job_status
Sept. 26, 2026, 2:40 a.m.
Added
submit_print_job
Sept. 26, 2026, 2:40 a.m.
Added
validate_stl
Sept. 26, 2026, 2:40 a.m.
Discover
Similar MCP servers
roastify-mcp
io.github.lonniev/roastify-mcp
Supports a coffee commerce workflow with product and blend catalogs, inventory, coupons, packaging design editing, artwork genera…
YouCam for Beauty & Personal Care
com.makeupar/beauty
Offers image-based beauty and personal-care analysis and virtual try-on tools for makeup, hair, facial features, body reshaping, …
agentee
art.allover/agentee
Searches and purchases all-over print apparel, manages carts, promotions, shipping, checkout, orders, and user-submitted designs.
mu
com.wearmu/mu
Supports AI-assisted print-on-demand product design, storefronts, manufacturing quotes, orders, fulfillment, shipping, sales, and…
studiomcphub
io.github.codex-curator/studiomcphub
Provides image enhancement, background removal, vectorization, color and print preparation, artwork search and analysis, product …
Capucine
fr.scorelook/capucine
Provides sourced personal styling guidance, weather-aware outfit recommendations, apparel shopping criteria, and links to verifie…
YouCam for Fashion & Retail
com.makeupar/fashion
Provides image-based virtual try-on experiences for clothing, accessories, jewelry, watches, makeup, fabric, hats, scarves, and s…
R3PLICA AI Connector
space.r3plica/catalog
Searches and presents premium design-brand products, collections, finishes, specifications, comparisons, images, and catalog link…