AI assistants (MCP)

Connect Claude, ChatGPT or a coding agent to Printlooper

Printlooper has a server that speaks the Model Context Protocol (MCP), the standard ChatGPT, Claude and other assistants use to call tools. It lets someone work on their Printlooper account from a chat.

The server is open to every designer, seller and print shop account. They can find Claude, ChatGPT and Coding agents under Settings, Integrations. Each one shows whether it is connected, with the address to paste, a setup prompt or install buttons.

You do not need an API key or a partner account for this. The person using the assistant signs in and approves it.

Server address

https://api.printlooper.com/mcp

Connecting

The server address is https://api.printlooper.com/mcp.

Coding agents (Claude Code, Codex, Cursor, VS Code, Windsurf): paste one prompt. Settings, Integrations, Coding agents has a Copy prompt button. The prompt gives the agent the exact command or config line for each tool, has it open the Printlooper sign-in page in your browser, and ends by checking which account is connected. Cursor and VS Code also have Add to Cursor and Add to VS Code buttons that open the editor with the server filled in. The commands, if you would rather type them:

  • Claude Code: claude mcp add --transport http printlooper https://api.printlooper.com/mcp
  • Codex: codex mcp add printlooper --url https://api.printlooper.com/mcp, then codex mcp login printlooper
  • Cursor: "printlooper": { "url": "https://api.printlooper.com/mcp" } under mcpServers in ~/.cursor/mcp.json
  • VS Code: "printlooper": { "type": "http", "url": "https://api.printlooper.com/mcp" } under servers in your mcp.json

Claude and ChatGPT apps: add it in their settings. A chat cannot add a server to itself, so a pasted prompt does not work here.

  • Claude: Customize, then Connectors, then Add custom connector. Paste the address and click Connect.
  • ChatGPT: Plugins, then Add, then Add custom MCP server. Paste the address, set Authentication to OAuth or no authentication, and create it. Sign in from the plugin's settings with Connect another account.

The user sees a Printlooper consent screen naming the assistant and what it may do, and can disconnect it any time under Settings, Integrations, Connected apps. It stops working on its next request.

Example prompts

Type one of these into a chat once Printlooper is connected.

  • Search public designs without signing in

    Find 3D printable planter designs on Printlooper.

  • Compare print shops and materials without signing in

    Which Printlooper print shops print in PETG, and what colors do they offer?

  • Explain how to order a print of your own model

    I have an STL file of a phone stand. How do I get it printed through Printlooper?

  • Read the connected seller's listings and orders

    Show my Printlooper listings and how my latest orders are going.

  • Write a marketing post from a listing's real facts

    Write an Instagram caption for my first Printlooper listing.

Tools

Without signing in: search_designs, get_design, list_print_shops, get_print_shop, list_materials, how_to_order_a_print, stage_model_from_url, get_staged_file, create_print_checkout, list_available_hardware, preview_hardware_pocket.

Any connected account: get_my_account.

Designers and sellers: list_my_listings, list_my_orders, get_my_earnings, get_my_store, start_model_upload, complete_model_upload, get_listing_options, create_listing_draft, update_listing, pause_listing, resume_listing, get_marketing_kit, get_ai_model_credits, get_ai_model, list_my_ai_models, generate_3d_model, choose_concept, design_with_hardware.

Print shops: get_my_shop, update_shop_profile, set_shop_capacity, set_material_prices, add_material, add_material_colors, get_pricing_benchmarks, estimate_job_price, preview_catalog_import, import_catalog, list_open_jobs, list_my_hardware, draft_hardware_from_datasheet, confirm_hardware_dimensions.

Prompts for marketing work: write_social_post, write_ad_variants, write_launch_email, plan_week_of_posts.

Every input, limit and permission for each tool is in the MCP tool reference.

Some tools apply to only one kind of account or are not open yet:

  • get_my_store, pause_listing and resume_listing work for seller products only. update_listing changes prices on seller products only, and a product priced per variant has its prices changed on Printlooper. Designers change a design's visibility in the design editor.
  • A seller whose plan is not active cannot edit, pause or resume listings. The tools say so and do not link to plans.
  • create_print_checkout is not open in production yet, so it is left out of the tool list there. A call to it answers that ordering through an assistant is not open and gives the link to the order page on Printlooper, where the buyer uploads the model, picks a print shop and pays.
  • The AI model generator tools (get_ai_model_credits, get_ai_model, list_my_ai_models, generate_3d_model, choose_concept and design_with_hardware) are listed once the assistant is connected to an account, not before. They are not offered in Claude (claude.ai, Claude Desktop, Claude on a phone or Claude Code), because Anthropic's directory restricts connectors that generate images with AI and the generator makes concept images. ChatGPT, Cursor and other assistants have them, and the generator is always on printlooper.com.
  • ChatGPT is listed the tools for both kinds of account, because it keeps one tool list for all its users. A tool for the other kind of account answers that it is for designers and sellers, or for print shops.
  • The generator tools report how many AI credits an account has and what a model costs. They do not sell credits or show credit packs: those are bought on Printlooper.
  • design_with_hardware answers that precision design is not open until the precision engine is on. list_available_hardware stays empty until a print shop has confirmed a part's dimensions.

What each tool does

Every tool, in the words the server gives the assistant.

Tools for anyone

These work without a Printlooper account. An assistant can search the marketplace, find print shops, stage a model and hand its user a checkout link.

Search 3D designs

search_designs. Who: Anyone, signed in or not. Read-only.

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.

Get a 3D design

get_design. Who: Anyone, signed in or not. Read-only.

Details of one public design from search_designs: description, size, tags, whether it needs hardware, and its page.

Find print shops

list_print_shops. Who: Anyone, signed in or not. Read-only.

Search Printlooper print shops (the makers who print and ship orders) by location, material, lead time and multicolor capability.

Get a print shop

get_print_shop. Who: Anyone, signed in or not. Read-only.

One print shop with its printers, materials and colors, and recent reviews.

List materials and colors

list_materials. Who: Anyone, signed in or not. Read-only.

Materials, finishes, strengths and colors the Printlooper print shops offer, with how many shops offer each. Filter colors by material, finish or color family.

Order a 3D print

how_to_order_a_print. Who: Anyone, signed in or not. Read-only.

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.

Bring in a 3D model from a link

stage_model_from_url. Who: Anyone, signed in or not. Creates or changes something on Printlooper.

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.

Check a staged model

get_staged_file. Who: Anyone, signed in or not. Read-only.

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).

Order a print of a model

create_print_checkout. Who: Anyone, signed in or not. Creates or changes something on Printlooper.

For a ready staged model, returns a one-time link where the buyer picks a print shop, material, color and quantity, sees the price and pays on Printlooper. Prices, tax and shipping are shown there; the assistant never handles payment.

Hardware you can design around

list_available_hardware. Who: Anyone, signed in or not. Read-only.

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.

Pocket size for a part

preview_hardware_pocket. Who: Anyone, signed in or not. Read-only.

The exact openings Printlooper would cut for a confirmed part at given fit settings, before a design is made around it.

Tools for any connected account

These need a signed-in user of any account type.

My Printlooper account

get_my_account. Who: Any connected account. Read-only.

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.

Tools for designers and sellers

These need a connected designer or seller account that granted the named user: permission. Print shop accounts never see them.

Upload a 3D model from this computer

start_model_upload. Who: A connected designer or seller that granted user:files:write (upload 3d models into your account). Creates or changes something on Printlooper.

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.

Finish a model upload

complete_model_upload. Who: A connected designer or seller that granted user:files:write (upload 3d models into your account). Creates or changes something on Printlooper.

Tell Printlooper the file from start_model_upload has been uploaded, so it starts checking it.

My listings

list_my_listings. Who: A connected designer or seller that granted user:listings:read (see your listings). Read-only.

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.

My orders

list_my_orders. Who: A connected designer or seller that granted user:orders:read (see orders for your listings). Read-only.

Orders that earned this account money (sales, royalties, design work), newest first, with order status and earnings. No buyer details.

My earnings

get_my_earnings. Who: A connected designer or seller that granted user:earnings:read (see your earnings and payouts). Read-only.

Paid, pending and reversed earnings in US dollars (cents), and when the last payout was made.

My storefront

get_my_store. Who: A connected designer or seller that granted user:listings:read (see your listings). Read-only.

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.

Price a design for my shop

get_listing_options. Who: A connected designer or seller that granted user:listings:read (see your listings). Read-only.

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.

Start a listing

create_listing_draft. Who: A connected designer or seller that granted user:listings:write (start listing drafts for you to finish and publish). Creates or changes something on Printlooper.

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.

Edit a listing

update_listing. Who: A connected designer or seller that granted user:listings:manage (edit, pause and resume your existing listings). Changes live data right away: have the user agree first.

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.

Pause a listing

pause_listing. Who: A connected designer or seller that granted user:listings:manage (edit, pause and resume your existing listings). Changes live data right away: have the user agree first.

Hide a seller product from your Printlooper storefront. Nothing is deleted; resume_listing shows it again. Shopify listings are not changed.

Resume a listing

resume_listing. Who: A connected designer or seller that granted user:listings:manage (edit, pause and resume your existing listings). Changes live data right away: have the user agree first.

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).

Facts and links for a post or ad

get_marketing_kit. Who: A connected designer or seller that granted user:listings:read (see your listings). Read-only.

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.

AI model credits

get_ai_model_credits. Who: A connected designer or seller that granted user:ai:spend (see your ai 3d models and use your ai credits to make more). Read-only. Not offered in Claude.

Whether the AI 3D model generator is available to this account, how many AI credits it has, and what one model costs.

Generate a 3D model with AI

generate_3d_model. Who: A connected designer or seller that granted user:ai:spend (see your ai 3d models and use your ai credits to make more). Spends AI credits: have the user agree first. Not offered in Claude.

Starts Printlooper's AI 3D model generator from a description, on the user's AI credits (check get_ai_model_credits first and tell the user the cost). It first makes concept images to choose from (see get_ai_model), then builds the printable model. Describe one object: what it is, its style and roughly how big. Weapons and other restricted items are refused.

Check an AI model

get_ai_model. Who: A connected designer or seller that granted user:ai:spend (see your ai 3d models and use your ai credits to make more). Read-only. Not offered in Claude.

Progress of a model from generate_3d_model or design_with_hardware: concept images to choose from, then a 3D preview link when ready.

Choose a concept

choose_concept. Who: A connected designer or seller that granted user:ai:spend (see your ai 3d models and use your ai credits to make more). Creates or changes something on Printlooper. Not offered in Claude.

Pick which concept image to build into a 3D model (option 1 is the first image), or ask for new concepts when none fit.

My AI models

list_my_ai_models. Who: A connected designer or seller that granted user:ai:spend (see your ai 3d models and use your ai credits to make more). Read-only. Not offered in Claude.

Models this account made with the AI generator, newest first.

Design a part around stocked hardware

design_with_hardware. Who: A connected designer or seller that granted user:ai:spend (see your ai 3d models and use your ai credits to make more). Spends AI credits: have the user agree first. Not offered in Claude.

Uses Printlooper's precision CAD (exact millimeters, not a sculpted mesh) to design a printable part around a stocked hardware part from list_available_hardware, for example a magnetic phone mount around four 10x3 mm magnets, or a bracket with an M5 nut trap. Costs AI credits: tell the user the cost from get_ai_model_credits and get their agreement. Also show them this and get their agreement before building: "I reviewed the part, clearance and layout. Supplier data, the AI design and printed sizes can all contain errors, and Printlooper does not guarantee this model will fit the part. I will print and test one before relying on it." Confirmed measurements of other objects it must fit can be given as dimensions.

Tools for print shops

These need a connected print shop account that granted the named supplier: permission. Designer and seller accounts never see them.

My print shop

get_my_shop. Who: A connected print shop that granted supplier:read (see your print shop profile, materials and prices). Read-only.

Your print shop: name, approval, capacity, daily order cap, lead time, and every material with its prices and colors.

Edit my shop profile

update_shop_profile. Who: A connected print shop that granted supplier:catalog:write (add and update products, materials and colours in your shop). Changes live data right away: have the user agree first.

Change your shop's public description or its default lead time in days.

Pause or limit new orders

set_shop_capacity. Who: A connected print shop that granted supplier:capacity:write (pause new orders or change your daily order cap). Changes live data right away: have the user agree first.

Pause new orders (your pending orders are rerouted to other shops and your sellers are told), resume them, or change your daily order cap.

Change material prices

set_material_prices. Who: A connected print shop that granted supplier:pricing:write (change your material prices and fees). Changes live data right away: have the user agree first.

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.

Add a material

add_material. Who: A connected print shop that granted supplier:catalog:write (add and update products, materials and colours in your shop). Creates or changes something on Printlooper.

Add a material your shop prints (PLA, PETG, ABS, TPU, ASA, RESIN or NYLON) with its prices. Then add colors with add_material_colors.

Add colors to a material

add_material_colors. Who: A connected print shop that granted supplier:catalog:write (add and update products, materials and colours in your shop). Creates or changes something on Printlooper.

Add the colors (filaments) you stock for one of your materials, each with a name, a hex color and a finish.

Compare my prices

get_pricing_benchmarks. Who: A connected print shop that granted supplier:read (see your print shop profile, materials and prices). Read-only.

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.

What a job would cost at my prices

estimate_job_price. Who: A connected print shop that granted supplier:read (see your print shop profile, materials and prices). Read-only.

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.

Check a product import

preview_catalog_import. Who: A connected print shop that granted supplier:catalog:write (add and update products, materials and colours in your shop). Read-only.

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).

Import products

import_catalog. Who: A connected print shop that granted supplier:catalog:write (add and update products, materials and colours in your shop). Changes live data right away: have the user agree first.

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).

My open jobs

list_open_jobs. Who: A connected print shop that granted supplier:jobs:read (see your open print jobs). Read-only.

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.

My hardware

list_my_hardware. Who: A connected print shop that granted supplier:read (see your print shop profile, materials and prices). Read-only.

Hardware your shop stocks (magnets, inserts, screws and more), with stock, price and whether you confirmed exact dimensions for designers.

Read a hardware datasheet

draft_hardware_from_datasheet. Who: A connected print shop that granted supplier:catalog:write (add and update products, materials and colours in your shop). Creates or changes something on Printlooper.

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.

Confirm a part’s exact dimensions

confirm_hardware_dimensions. Who: A connected print shop that granted supplier:catalog:write (add and update products, materials and colours in your shop). Creates or changes something on Printlooper.

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.

Ready-made prompts

  • write_social_post. Write a social post for a listing. Three post options for one listing on the chosen channel, with hashtags and the tracked link.
  • write_ad_variants. Write ad variants for a listing. Headlines and primary text for testing paid ads on one listing.
  • write_launch_email. Write a launch email for a listing. A short email announcing a new listing to existing customers or followers.
  • plan_week_of_posts. Plan a week of posts. A seven day posting plan across your listings, ready to paste into a scheduler.

What stays on Printlooper

No tool takes payment or moves money, confirms the rights to a design, or publishes a designer's or seller's listing for the first time. Tools return the link where the user does that. Accepting and shipping print jobs, plans and payouts are also not available.

The links are where the user finishes the job:

  • A checkout_url from create_print_checkout works for 7 days and for one order.
  • A complete_url from create_listing_draft works for 30 days.
  • Generated models are finished, printed or sold from the My 3D Models page that the generator tools link to.
  • get_my_account returns the dashboard and the page where the connection is managed.

Some tools change live data right away: update_listing, pause_listing, resume_listing, update_shop_profile, set_material_prices, set_shop_capacity, and import_catalog, which publishes a print shop's products to sellers. Have the user agree first. These tools, and the two that spend AI credits (generate_3d_model and design_with_hardware), are marked destructive, so an assistant asks before each call.

Two inputs guard this. Tools that spend AI credits need confirm_spend: true, and import_catalog needs confirm: true. Each must be literally true, and only after the user agreed. import_catalog imports nothing if any row has a problem, and skips rows whose title is already a product in the shop, so a retried call never publishes twice.

Permissions

ScopeWhat the user sees
user:readSee your first name, your account type and your plan limits
user:files:writeUpload 3D models into your account
user:listings:writeStart listing drafts for you to finish and publish
user:listings:readSee your listings
user:listings:manageEdit, pause and resume your existing listings
user:orders:readSee orders for your listings
user:earnings:readSee your earnings and payouts
user:ai:spendSee your AI 3D models and use your AI credits to make more
supplier:readSee your print shop profile, materials and prices
supplier:catalog:writeAdd and update products, materials and colours in your shop
supplier:pricing:writeChange your material prices and fees
supplier:capacity:writePause new orders or change your daily order cap
supplier:jobs:readSee your open print jobs

Designers and sellers get the user: scopes, print shops the supplier: scopes. Tools for the other kind of account are hidden. If one is called anyway, it returns a tool error rather than a sign-in challenge.

Trying it

You can list the tools without signing in:

curl -s https://api.printlooper.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

To walk through sign-in by hand, run the MCP Inspector (npx @modelcontextprotocol/inspector) and point it at the same address with the Streamable HTTP transport.

More