Quote and order 3D printed parts from your own software

Quickstart

Four calls from a model to an order. Every call sends the key as a bearer token. A test key (pg_test_...) does everything except make a real order.

1. 1. Send the model

   curl https://hskihhpzveqtassiijkt.supabase.co/functions/v1/partguys-api/v1/files \
     -H "Authorization: Bearer pg_test_..." \
     -F "file=@bracket.stl"

   Returns an id, its size and volume. If the part looks too small, it warns you to check the units; send units=inches to fix it.

2. 2. Get a price

   curl https://hskihhpzveqtassiijkt.supabase.co/functions/v1/partguys-api/v1/quotes \
     -H "Authorization: Bearer pg_test_..." -H "Content-Type: application/json" \
     -d '{"lines":[{"file_id":"FILE_ID","quantity":10,"technology":"SLS","material":"PA12",
          "black_dye":true,"finishes":["Polish"],"speed":"priority"}]}'

   The price per part already includes quantity pricing; group and volume discounts come back as their own lines. Split parts that are too big for one build are priced with their bonding. Every line has a ship-by date.

3. 3. See shipping

   curl https://hskihhpzveqtassiijkt.supabase.co/functions/v1/partguys-api/v1/quotes/QUOTE_ID/shipping \
     -H "Authorization: Bearer pg_test_..." -H "Content-Type: application/json" \
     -d '{"ship_to":{"name":"Jane Buyer","street1":"200 S Biscayne Blvd","city":"Miami","state":"FL","zip":"33131"}}'

4. 4. Order it

   curl https://hskihhpzveqtassiijkt.supabase.co/functions/v1/partguys-api/v1/orders \
     -H "Authorization: Bearer pg_test_..." -H "Content-Type: application/json" \
     -d '{"quote_id":"QUOTE_ID","ship_to":{...},"shipping_option":"UPS:Ground","reference":"PO-1042"}'

   Returns the order with items, shipping, tax and total. With a live key and a card on file it is charged at once (status paid); otherwise it has a checkout_url for the buyer to pay, and the order starts as soon as it is paid. Then follow it with GET /v1/orders/ORDER_ID.

Try it live

This panel calls the real API from your browser with a public test key. Upload a part, price it, pick shipping, place a test order and pay on Stripe's test checkout with the card 4242 4242 4242 4242. Nothing is charged and nothing is made.

Keys and test mode

Keep live keys on your server or in your AI app's settings, never in a web page. Send X-PartGuys-Source: mcp on calls made by an MCP server.

Ordering and payment

• Card on file: add a card in Profile, API access and live orders are charged to it the moment they are placed, then go straight into production (status paid). No payment page, so an app or AI agent can order on its own. Send "payment": "checkout" to get a payment link instead.
• Payment link: without a card on file, an order comes back with a Stripe checkout_url for the buyer to pay. Give success_url and cancel_url to bring them back to your site; ?order_id= is added.
• If a saved card is declined or the bank asks the cardholder to confirm, the order comes back with payment_error and a checkout_url, and nothing is charged.
• Ordering the same quote again returns the order already waiting for payment, so a retried request never makes two.
• Statuses: awaiting_payment, paid, in_production, ready_to_ship, shipped, delivered, on_hold, cancelled, refunded. Once shipped, the order carries the tracking number and link.
• Tax is added for the ship-to state where it applies. An approved tax exemption on your account is honoured.
• Shipping is within the US. Your account may have a per-order and a monthly spending limit; ask PartGuys to change them.

Endpoints

Full request and response shapes are in the OpenAPI spec.

Errors

Every error has the same shape: a stable code to branch on and a message a person can act on. Codes are never renamed. Quote the request_id if you contact us.

{ "error": { "code": "invalid_option", "message": "lines[0]: colour \"Black\" is not available in ASA.", "line": 0, "colors": ["White", "Gray"] },
  "request_id": "6f1c..." }

MCP and AI agents

PartGuys runs a hosted MCP server, so Claude, ChatGPT, Cursor and other AI apps can quote and order parts with nothing to install. Step-by-step setup for Claude and ChatGPT: Use PartGuys in Claude and ChatGPT. Connect it by signing in with your PartGuys account (or with a key) and ask in plain words, for example "price 10 of this bracket in black nylon and ship it to our Miami office".

claude mcp add --transport http partguys https://hskihhpzveqtassiijkt.supabase.co/functions/v1/partguys-api/mcp --header "Authorization: Bearer pg_test_..."

https://partguys.io/mcp

https://hskihhpzveqtassiijkt.supabase.co/functions/v1/partguys-api/mcp

{
  "mcpServers": {
    "partguys": {
      "url": "https://hskihhpzveqtassiijkt.supabase.co/functions/v1/partguys-api/mcp",
      "headers": { "Authorization": "Bearer pg_test_..." }
    }
  }
}

Start with a test key: the agent can run the whole flow, including a Stripe test payment, and nothing is made. Large files: when a model is too big to pass through the chat, the agent gives you a private upload link instead of guessing at the shape, and prices your exact file once you drop it there. With a live key and a card on file, the agent can place the order on its own once you confirm the total. Connected by signing in instead, every order comes back with a checkout page for you to pay.

The tools:

• partguys_get_catalog
• partguys_upload_model
• partguys_create_upload_link
• partguys_get_upload
• partguys_get_quote
• partguys_get_shipping_options
• partguys_place_order
• partguys_get_order
• partguys_list_orders
• partguys_cancel_order

Running your own MCP server instead? mcp-tools.json has the same tools (name, description, input schema and the HTTP call behind each) to expose from it. Send X-PartGuys-Source: mcp on its calls.