# ProvenMetal MCP ordering ProvenMetal's hosted HTTP MCP connection returns a tax-inclusive instant price, including parts ProvenMetal buys and ships to JLCPCB. Boards it can't build instantly get a custom-quote link with the files and details carried over. Earlier local Python MCP setup instructions are obsolete. ## JLCPCB quote and checkout — no sign-in to start MCP URL: https://mcp.provenmetal.com - Codex desktop: Settings > MCP servers > Add server. Choose Streamable HTTP, name it provenmetal-mcp, paste the URL above, save and restart. Type /mcp in the composer to check the connection. - Codex: `codex mcp add provenmetal-mcp --url https://mcp.provenmetal.com` - Claude Code: `claude mcp add --transport http provenmetal-mcp https://mcp.provenmetal.com` - Other MCP clients: add that URL as a remote HTTP MCP server. No API key or OAuth sign-in is needed for the quote. Reconnect or start a new agent chat if the five tools do not appear. 1. Ask the customer for a KiCad board/project (.kicad_pcb, optional .kicad_sch, or a zipped project) or Gerber zip; an ODB++ export helps. For assembly, include a BOM CSV with LCSC or manufacturer part numbers and the pick-and-place file. Confirm the chosen files. 2. Call upload. Run its returned curl command from the customer's computer with one -F files=@... per chosen file. The hosted MCP cannot read local paths itself. If the agent cannot run a shell, give the command to the customer to run. Keep the returned upload_id. 3. Ask for board quantity and whether the boards need assembly. Don't ask where to ship: without an address the price is for US delivery and tax is finalised for the address the customer enters at checkout. If they already gave shipping or contact details, pass them as ship_to_* so checkout is prefilled. Ask once for the board options the files may not state: thickness_mm, surface_finish, copper_oz, solder_mask, material, and special_requirements (true for controlled impedance, filled or plugged vias, flex, a non-FR-4 material or a matte mask; describe it in special_notes). If the customer accepts JLCPCB's standard for the rest, pass standard_for_unstated=true. Call quote with upload_id and those details. Options the files state are read from them; a needs_details reply lists the only questions left, each with its choices, so ask them together with your multiple-choice question tool (Claude Code's AskUserQuestion, or Codex's equivalent) and call again. A needs_part_numbers reply lists BOM lines that name no exact part (a value or symbol such as LED_Red, or a part number without its variant): find each exact manufacturer part number in the design or ask the customer, never guess a variant or package, add them to the BOM, upload again and quote. If the customer wants ProvenMetal to choose them, call again with staff_picks_parts=true. The tool converts KiCad files to Gerbers, drill, BOM and placement as needed and returns a live JLCPCB price in USD, including shipping, import duty and applicable sales tax, plus lead time, delivery estimate and the Central link. It prices JLCPCB public stock; ProvenMetal buys any other part from authorized distributors and ships it to JLCPCB in one box, including the added assembly cost. Never search for replacement parts yourself: the MCP searches JLCPCB, Digi-Key, Mouser, LCSC and Octopart and runs ProvenMetal's AI sourcing; each unpriced part's reason says what was searched, and an in-stock part with matching specs comes back as similar_part for the customer to approve. Parts we can't buy return a link for ProvenMetal's team to quote. A board the instant path can't build or price returns mode review with custom_quote_reasons and a link where the customer requests the quote. When only the assembly can't be priced but the boards can, the reply also has fabrication_quote: an instant bare-board price and its own checkout link. Offer it alongside the assembly request. Pick-and-place positions with no part (test points, fiducials, mounting holes) are skipped and named in the notes. A price_unavailable reply is temporary: try again in a few minutes. Preserve every required placement; pass customer_supplied_refs only for parts the customer says they will send (to ProvenMetal, 1230 Howard Street, San Francisco). Never mark parts do-not-populate just to get an instant price. 4. Give the checkout_url to the customer. They confirm their recipient and address in Central (prefilled with anything they told you), create an account or sign in, then pay an instant quote or request a custom or reviewed quote. Their files and board details are already there. The MCP never collects these details or pays. Call checkout with quote_id to get the link again. 5. Call order_status with quote_id for the actual state: quote ready, waiting for payment, ordered, in production or shipped with tracking. Do not describe an unpaid checkout as a placed order. JLCPCB quoting refuses ITAR-controlled designs; direct those customers to https://central.provenmetal.com/order?step=upload. Unsupported builds and unpriced components take the custom or reviewed quote route instead. KiCad boards with unrouted connections or shorts are refused, listing each problem, unless skip_board_checks=true; ask the customer before bypassing checks. An upload link lasts two hours; uploaded files remain on the API server at most six hours. Limits are 50 MB per file and 100 MB total. buy_link makes a permanent buy link for a partner site's Buy button. ## Links - Agent launch page: https://provenmetal.com/mcp - Customer browser ordering: https://central.provenmetal.com/order?step=upload - Terms of Sale: https://provenmetal.com/terms - Help: founders@provenmetal.com