Search 3D printable designs and print shops, and work on a Printlooper account from a chat.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add a material your shop prints (PLA, PETG, ABS, TPU, ASA, RESIN or NYLON) with its prices. Then add colors with add_material_colors. Needs a connected Printlooper account.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http printlooper https://api.printlooper.com/mcp
Add a material your shop prints (PLA, PETG, ABS, TPU, ASA, RESIN or NYLON) with its prices. Then add colors with add_material_colors. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| type* | string | |
| setup_fee_usd | number | |
| default_finish | string | |
| lead_time_days | integer | |
| min_job_price_usd | number | |
| price_per_gram_usd* | number | |
| failure_rate_percent | number | |
| post_processing_fee_usd | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"type",
"price_per_gram_usd"
],
"properties": {
"type": {
"enum": [
"PLA",
"PETG",
"ABS",
"TPU",
"ASA",
"RESIN",
"NYLON"
],
"type": "string"
},
"setup_fee_usd": {
"type": "number",
"default": 0,
"maximum": 200,
"minimum": 0
},
"default_finish": {
"enum": [
"matte",
"glossy",
"smooth",
"textured",
"silk"
],
"type": "string",
"default": "matte"
},
"lead_time_days": {
"type": "integer",
"maximum": 30,
"minimum": 1
},
"min_job_price_usd": {
"type": "number",
"maximum": 500,
"minimum": 0
},
"price_per_gram_usd": {
"type": "number",
"maximum": 2,
"minimum": 0.005
},
"failure_rate_percent": {
"type": "number",
"default": 0,
"maximum": 50,
"minimum": 0
},
"post_processing_fee_usd": {
"type": "number",
"default": 0,
"maximum": 200,
"minimum": 0
}
},
"additionalProperties": false
}Add the colors (filaments) you stock for one of your materials, each with a name, a hex color and a finish. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| colors* | array | |
| material_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"material_id",
"colors"
],
"properties": {
"colors": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"hex"
],
"properties": {
"hex": {
"type": "string",
"pattern": "^#?[0-9a-fA-F]{6}$"
},
"name": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"finish": {
"enum": [
"matte",
"glossy",
"smooth",
"textured",
"silk"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1
},
"material_id": {
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
}Tell Printlooper the file from start_model_upload has been uploaded, so it starts checking it. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| file_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"maxLength": 80
}
},
"additionalProperties": false
}Records your shop’s confirmation of the exact part and dimensions you stock, so designers can build parts around it. Only confirm a part you have checked: designs are cut to these numbers. Give evidence: a datasheet link or how you measured it. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| shape* | string | |
| depth_mm* | number | Same as width for a round or hexagonal part |
| evidence* | string | The datasheet lines, or how and with what it was measured |
| width_mm* | number | Diameter for a round part, across flats for a hexagonal part |
| height_mm* | number | |
| source_url | string | |
| offering_id* | string | offering_id from list_my_hardware |
| part_number* | string | |
| tolerance_mm |
Starts a listing from a ready staged model with the title, description, tags and price you suggest. The user opens complete_url to confirm they own the rights, pick the shop and colors, add photos and publish. Nothing goes live until they do. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| tags | array | |
| title* | string | |
| file_id* | string | A ready staged model id (file_...) |
| price_usd | number | Suggested retail price for sellers |
| description | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"file_id",
"title"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"title": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"file_id": {
"type": "string",
"maxLength": 80,
"description": "A ready staged model id (file_...)"
},
"price_usd": {
"type": "number",
"maximum": 10000,
"minimum": 1,
"description": "Suggested retail price for sellers"
},
"description": {
"type": "string",
"default": "",
"maxLength": 5000
}
},
"additionalProperties": false
}Reads a part's datasheet (a public https link, or pasted text) and drafts its catalog entry and exact dimensions. Every number is checked against a quoted line of the source, and nothing is saved. Review it with the user, then confirm with confirm_hardware_dimensions. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| url | string | |
| text | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"text": {
"type": "string",
"maxLength": 20000
}
},
"additionalProperties": false
}What your shop would charge for a print of a given weight in one of your materials, with the breakdown, for one unit or a batch. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| quantity | integer | |
| material_id* | string | |
| weight_grams* | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"material_id",
"weight_grams"
],
"properties": {
"quantity": {
"type": "integer",
"default": 1,
"maximum": 10000,
"minimum": 1
},
"material_id": {
"type": "string",
"maxLength": 64
},
"weight_grams": {
"type": "number",
"maximum": 20000,
"minimum": 0.1
}
},
"additionalProperties": false
}Details of one public design from search_designs: description, size, tags, whether it needs hardware, and its page.
| Argument | Type | Description |
|---|---|---|
| design_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"design_id"
],
"properties": {
"design_id": {
"type": "string",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
}For a marketplace design (from search_designs) or a staged model, quotes what print shops charge to make it, the platform fee and royalty, and the retail price that leaves a chosen margin. Use it before suggesting a price. Returns the page to create the listing. Each quote lists the materials and colors that shop offers; pass material and color to quote one of them. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| shop | string | Quote one print shop (id or handle). Otherwise up to three shops are quoted. |
| color | string | Quote this color, by hex (#1A1A1A) or name. Shops without it quote their default color. |
| finish | string | With color: the finish to prefer when a shop has that color in more than one, for example matte or glossy |
| material | string | Quote this material, for example PLA or PETG. Shops without it are left out. |
| design_id* | string | A design id from search_designs, or a staged model id (file_...) |
| margin_percent | number | Profit as a percent of the retail price |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"design_id"
],
"properties": {
"shop": {
"type": "string",
"maxLength": 80,
"description": "Quote one print shop (id or handle). Otherwise up to three shops are quoted."
},
"color": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Quote this color, by hex (#1A1A1A) or name. Shops without it quote their default color."
},
"finish": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "With color: the finish to prefer when a shop has that color in more than one, for example matte or glossy"
},
"material": {
"type": "string",
"maxLength": 20,
"minLength": 2,
"description": "Quote this material, for example PLA or PETG. Shops without it are left out."
},
"design_id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "A design id from search_designs, or a staged model id (file_...)"
},
"margin_percent": {
"type": "number",
"default": 40,
"maximum": 80,
"minimum": 5,
"description": "Profit as a percent of the retail price"
}
},
"additionalProperties": false
}Everything needed to write social posts, ads or an email about one of your listings: title, description, price, image links, the page link with tracking for the channel, and audience notes. Write the copy from these facts only; never promise delivery times or quality guarantees. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| channel | string | |
| listing_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"listing_id"
],
"properties": {
"channel": {
"enum": [
"instagram",
"tiktok",
"facebook",
"pinterest",
"x",
"reddit",
"email",
"other"
],
"type": "string",
"default": "instagram"
},
"listing_id": {
"type": "string",
"maxLength": 80
}
},
"additionalProperties": false
}Who is connected: first name, account type (designer, seller or print shop), which permissions were granted, and where to manage the account. Call this first to know which tools apply. Needs a connected Printlooper account.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Paid, pending and reversed earnings in US dollars (cents), and when the last payout was made. Needs a connected Printlooper account.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Your print shop: name, approval, capacity, daily order cap, lead time, and every material with its prices and colors. Needs a connected Printlooper account.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}A seller's Printlooper storefront: its link, how many products are live, and whether Shopify is connected. product_feed_url is a public, read only list of the live products for a site the seller runs themselves: show them there and link each Buy button to the product url, where the buyer pays on Printlooper. The look, logo and about text are edited in the storefront editor on Printlooper. Needs a connected Printlooper account.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}How your price per gram and minimum job compare with other approved Printlooper shops, per material (low quartile, median, high quartile). Shown only where enough shops offer the material to keep each shop anonymous. Needs a connected Printlooper account.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}One print shop with its printers, materials and colors, and recent reviews.
| Argument | Type | Description |
|---|---|---|
| shop* | string | The shop id or handle from list_print_shops |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"shop"
],
"properties": {
"shop": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The shop id or handle from list_print_shops"
}
},
"additionalProperties": false
}Status of a model from stage_model_from_url or start_model_upload: processing, ready (with size in mm, grams and parts) or failed (with the reason).
| Argument | Type | Description |
|---|---|---|
| file_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"maxLength": 80
}
},
"additionalProperties": false
}How a buyer gets their own 3D model printed and shipped: the page to upload it, accepted files, and what happens next. Use this when someone has an STL or 3MF and wants it printed.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Imports rows from your spreadsheet as your own products, published to Printlooper sellers. Run preview_catalog_import first and get the user to agree. All rows must be valid; nothing is imported if any row has a problem. Rows from the shop spreadsheet, one per product or variant. Each needs title, wholesale_price (your price to sellers) and photo_url (a public https image). Rows with the same title become variants of one product (give variant_title and optional variant_sku and variant_price). Optional: description, tags, storefront_price, material_label, care_instructions and warnings (at least 40 characters each, printed on the card in the box). Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| rows* | array | |
| confirm* | boolean |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"rows",
"confirm"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"photo_url"
],
"properties": {
"tags": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
},
"title": {
"type": "string",
"maxLength": 200
},
"warnings": {
"type": "string",
"maxLength": 2000
},
"photo_url": {
"type": "string",
"maxLength": 2048
},
"description": {
"type": "string",
"maxLength": 5000
},
"variant_sku": {
"type": "string",
"maxLength": 64
},
"variant_price": {
"type": [
"number",
"string"
]
},
"variant_title": {
"type": "string",
"maxLength": 200
},
"material_label": {
"type": "string",
"maxLength": 200
},
"wholesale_price": {
"type": [
"number",
"string"
]
},
"storefront_price": {
"type": [
"number",
"string"
]
},
"care_instructions": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"confirm": {
"type": "boolean",
"const": true
}
},
"additionalProperties": false
}Parts (magnets, inserts, bearings and more) that Printlooper print shops stock and have confirmed exact dimensions for, ready to build a design around on Printlooper. Filter by words in the part name.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | For example "magnet" or "M3 insert" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 80,
"description": "For example \"magnet\" or \"M3 insert\""
}
},
"additionalProperties": false
}Materials, finishes, strengths and colors the Printlooper print shops offer, with how many shops offer each. Filter colors by material, finish or color family.
| Argument | Type | Description |
|---|---|---|
| finish | string | |
| material | string | |
| color_family | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"finish": {
"type": "string",
"maxLength": 30
},
"material": {
"type": "string",
"maxLength": 20
},
"color_family": {
"type": "string",
"maxLength": 30
}
},
"additionalProperties": false
}Hardware your shop stocks (magnets, inserts, screws and more), with stock, price and whether you confirmed exact dimensions for designers. Needs a connected Printlooper account.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}A seller's products or a designer's designs, newest first, with status and price. For a product, storefront_published says whether it is shown on the storefront, which is what pause_listing and resume_listing change. Page with starting_after set to next_cursor. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| starting_after | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"starting_after": {
"type": "string",
"maxLength": 80
}
},
"additionalProperties": false
}Orders that earned this account money (sales, royalties, design work), newest first, with order status and earnings. No buyer details. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| starting_after | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"starting_after": {
"type": "string",
"maxLength": 80
}
},
"additionalProperties": false
}Print jobs assigned to your shop that are not shipped yet, oldest first, with status, quantity and deadline. No buyer details. Accept and ship jobs on Printlooper. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| limit | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 30,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}Search Printlooper print shops (the makers who print and ship orders) by location, material, lead time and multicolor capability.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | |
| state | string | US state code |
| material | string | PLA, PETG, ABS, TPU, ... |
| multi_color | boolean | |
| max_lead_days | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 80
},
"state": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "US state code"
},
"material": {
"type": "string",
"maxLength": 20,
"description": "PLA, PETG, ABS, TPU, ..."
},
"multi_color": {
"type": "boolean"
},
"max_lead_days": {
"type": "integer",
"maximum": 60,
"minimum": 1
}
},
"additionalProperties": false
}Hide a seller product from your Printlooper storefront. Nothing is deleted; resume_listing shows it again. Shopify listings are not changed. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| listing_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"listing_id"
],
"properties": {
"listing_id": {
"type": "string",
"maxLength": 80
}
},
"additionalProperties": false
}Checks rows from your spreadsheet before importing them as your own products (sold to Printlooper sellers): which rows have problems, how many products and variants it makes, and whether your plan has room. Changes nothing. Rows from the shop spreadsheet, one per product or variant. Each needs title, wholesale_price (your price to sellers) and photo_url (a public https image). Rows with the same title become variants of one product (give variant_title and optional variant_sku and variant_price). Optional: description, tags, storefront_price, material_label, care_instructions and warnings (at least 40 characters each, printed on the card in the box). Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| rows* | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"rows"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"photo_url"
],
"properties": {
"tags": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
},
"title": {
"type": "string",
"maxLength": 200
},
"warnings": {
"type": "string",
"maxLength": 2000
},
"photo_url": {
"type": "string",
"maxLength": 2048
},
"description": {
"type": "string",
"maxLength": 5000
},
"variant_sku": {
"type": "string",
"maxLength": 64
},
"variant_price": {
"type": [
"number",
"string"
]
},
"variant_title": {
"type": "string",
"maxLength": 200
},
"material_label": {
"type": "string",
"maxLength": 200
},
"wholesale_price": {
"type": [
"number",
"string"
]
},
"storefront_price": {
"type": [
"number",
"string"
]
},
"care_instructions": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
}
},
"additionalProperties": false
}The exact openings Printlooper would cut for a confirmed part at given fit settings, before a design is made around it.
| Argument | Type | Description |
|---|---|---|
| count | integer | How many of this part |
| mount | string | pocket keeps a floor under the part; through passes straight through a panel |
| columns | integer | Parts per row along X. Must divide the count. Default is one row. |
| pitch_mm | number | Centre-to-centre spacing. Required for more than one part. |
| plate_mm | number | Panel thickness for a through cutout. Through only. |
| taper_mm | number | Entry chamfer that helps the part go in. Pockets only. |
| clearance_mm | number | Gap per side around the part |
| floor_hole_mm | number | Round hole through each pocket floor, for a screw or shaft. Pockets only. |
| hardware_revision_id* |
Show a seller product you hid with pause_listing on your Printlooper storefront again. It cannot put a listing on the storefront for the first time; that happens on Printlooper. Showing it again publishes it again, so it takes the designer royalty as it is now (returned as royalty_percent). Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| listing_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"listing_id"
],
"properties": {
"listing_id": {
"type": "string",
"maxLength": 80
}
},
"additionalProperties": false
}Search the public Printlooper marketplace of 3D-printable designs by keyword or category. Returns titles, sizes, images and the page where a buyer can order a print or a seller can add the design to their shop.
| Argument | Type | Description |
|---|---|---|
| sort | string | |
| limit | integer | |
| query | string | Keywords, for example "cable organizer" or "planter" |
| offset | integer | |
| category | string | A marketplace category, if the user named one |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"sort": {
"enum": [
"recommended",
"newest"
],
"type": "string",
"default": "recommended"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 120,
"description": "Keywords, for example \"cable organizer\" or \"planter\""
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 500,
"minimum": 0
},
"category": {
"type": "string",
"maxLength": 60,
"description": "A marketplace category, if the user named one"
}
},
"additionalProperties": false
}Change the prices of one of your materials (price per gram, minimum job, failure surcharge, setup and post-processing fees, lead time). New quotes use them right away. Show the user the change before making it. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| material_id* | string | |
| setup_fee_usd | number | |
| lead_time_days | any | |
| min_job_price_usd | any | |
| price_per_gram_usd | number | For example 0.04 for 4 cents a gram |
| failure_rate_percent | number | |
| post_processing_fee_usd | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"material_id"
],
"properties": {
"material_id": {
"type": "string",
"maxLength": 64
},
"setup_fee_usd": {
"type": "number",
"maximum": 200,
"minimum": 0
},
"lead_time_days": {
"anyOf": [
{
"type": "integer",
"maximum": 30,
"minimum": 1
},
{
"type": "null"
}
]
},
"min_job_price_usd": {
"anyOf": [
{
"type": "number",
"maximum": 500,
"minimum": 0
},
{
"type": "null"
}
]
},
"price_per_gram_usd": {
"type": "number",
"maximum": 2,
"minimum": 0.005,
"description": "For example 0.04 for 4 cents a gram"
},
"failure_rate_percent": {
"type": "number",
"maximum": 50,
"minimum": 0
},
"post_processing_fee_usd": {
"type": "number",
"maximum": 200,
"minimum": 0
}
},
"additionalProperties": false
}Pause new orders (your pending orders are rerouted to other shops and your sellers are told), resume them, or change your daily order cap. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| paused | boolean | |
| daily_order_cap | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"paused": {
"type": "boolean"
},
"daily_order_cap": {
"type": "integer",
"maximum": 10000,
"minimum": 1
}
},
"additionalProperties": false
}Download an STL or 3MF model from a public https link (a direct download, not a web page) and stage it on Printlooper, where its geometry is checked. Works signed in (to list it) or not (to order a print). Files up to 50 MB. Then call get_staged_file until status is ready.
| Argument | Type | Description |
|---|---|---|
| url | string | A public https link that downloads the .stl or .3mf file |
| filename | string | Name to keep, for example "planter.stl" |
| model_file | object | A file the user attached in ChatGPT |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "A public https link that downloads the .stl or .3mf file"
},
"filename": {
"type": "string",
"maxLength": 120,
"description": "Name to keep, for example \"planter.stl\""
},
"model_file": {
"type": "object",
"required": [
"download_url"
],
"properties": {
"file_id": {
"type": "string",
"maxLength": 200
},
"download_url": {
"type": "string",
"format": "uri",
"maxLength": 4096
}
},
"description": "A file the user attached in ChatGPT",
"additionalProperties": false
}
},
"additionalProperties": false
}For agents that can read local files (Claude Code, Cursor): returns a signed URL to PUT an STL or 3MF to, with the exact headers to send. After the upload, call complete_model_upload. Chat apps should use stage_model_from_url instead. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| filename* | string | Must end in .stl or .3mf |
| size_bytes* | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"filename",
"size_bytes"
],
"properties": {
"filename": {
"type": "string",
"maxLength": 120,
"minLength": 5,
"description": "Must end in .stl or .3mf"
},
"size_bytes": {
"type": "integer",
"maximum": 52428800,
"minimum": 1
}
},
"additionalProperties": false
}Change an existing listing's title, description or tags, or a seller product's price and compare-at price. Description is plain text (blank lines start new paragraphs). Only listings from list_my_listings. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| tags | array | |
| title | string | |
| price_usd | number | Seller products with a single price only |
| listing_id* | string | |
| description | string | |
| compare_at_price_usd | any | Strikethrough "was" price; null removes it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"listing_id"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"maxItems": 20
},
"title": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"price_usd": {
"type": "number",
"maximum": 10000,
"minimum": 1,
"description": "Seller products with a single price only"
},
"listing_id": {
"type": "string",
"maxLength": 80
},
"description": {
"type": "string",
"maxLength": 5000
},
"compare_at_price_usd": {
"anyOf": [
{
"type": "number",
"maximum": 10000,
"minimum": 1
},
{
"type": "null"
}
],
"description": "Strikethrough \"was\" price; null removes it"
}
},
"additionalProperties": false
}Change your shop's public description or its default lead time in days. Needs a connected Printlooper account.
| Argument | Type | Description |
|---|---|---|
| description | string | |
| default_lead_time_days | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"description": {
"type": "string",
"maxLength": 2000
},
"default_lead_time_days": {
"type": "integer",
"maximum": 30,
"minimum": 1
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 16, 2026.
| number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"offering_id",
"part_number",
"shape",
"width_mm",
"depth_mm",
"height_mm",
"tolerance_mm",
"evidence"
],
"properties": {
"shape": {
"enum": [
"round",
"rectangular",
"hexagonal"
],
"type": "string"
},
"depth_mm": {
"type": "number",
"maximum": 200,
"minimum": 0.5,
"description": "Same as width for a round or hexagonal part"
},
"evidence": {
"type": "string",
"maxLength": 2000,
"minLength": 12,
"description": "The datasheet lines, or how and with what it was measured"
},
"width_mm": {
"type": "number",
"maximum": 200,
"minimum": 0.5,
"description": "Diameter for a round part, across flats for a hexagonal part"
},
"height_mm": {
"type": "number",
"maximum": 200,
"minimum": 0.5
},
"source_url": {
"type": "string",
"default": "",
"maxLength": 2048
},
"offering_id": {
"type": "string",
"format": "uuid",
"description": "offering_id from list_my_hardware"
},
"part_number": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"tolerance_mm": {
"type": "number",
"maximum": 2,
"minimum": 0
}
},
"additionalProperties": false
}| string |
| revision_id from list_available_hardware |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"hardware_revision_id"
],
"properties": {
"count": {
"type": "integer",
"default": 1,
"maximum": 6,
"minimum": 1,
"description": "How many of this part"
},
"mount": {
"enum": [
"pocket",
"through"
],
"type": "string",
"default": "pocket",
"description": "pocket keeps a floor under the part; through passes straight through a panel"
},
"columns": {
"type": "integer",
"maximum": 6,
"minimum": 1,
"description": "Parts per row along X. Must divide the count. Default is one row."
},
"pitch_mm": {
"type": "number",
"maximum": 450,
"minimum": 1,
"description": "Centre-to-centre spacing. Required for more than one part."
},
"plate_mm": {
"type": "number",
"maximum": 10,
"minimum": 1,
"description": "Panel thickness for a through cutout. Through only."
},
"taper_mm": {
"type": "number",
"default": 0.4,
"maximum": 2,
"minimum": 0.2,
"description": "Entry chamfer that helps the part go in. Pockets only."
},
"clearance_mm": {
"type": "number",
"default": 0.2,
"maximum": 2,
"minimum": 0.1,
"description": "Gap per side around the part"
},
"floor_hole_mm": {
"type": "number",
"maximum": 200,
"minimum": 0.5,
"description": "Round hole through each pocket floor, for a screw or shaft. Pockets only."
},
"hardware_revision_id": {
"type": "string",
"format": "uuid",
"description": "revision_id from list_available_hardware"
}
},
"additionalProperties": false
}