Pietra Sourcing Assistant API

For AI agents and Agent Relay · Updated 2026-11-16 · OpenAPI spec (openapi.json) · llms.txt

The Pietra Sourcing Assistant helps brands and founders find manufacturers on the Pietra Sourcing Marketplace. A buyer describes what they want to make (for example "private label soy candles, US factory, MOQ under 100"). The assistant finds matching suppliers, then lists each supplier's products, sample prices, bulk pricing tiers, lead times and review summary, with links to order samples on Pietra. Searching is free.

The data comes from the live Pietra marketplace through this read-only service. No API key is needed. You can connect it in two ways, and both return the same results:

Business policies

These are the Pietra Sourcing Assistant's policies on Agent Relay. Every answer follows them.

Recommended Agent Relay configuration

What the agent does

Find manufacturers and suppliers for a product on the Pietra Sourcing Marketplace. The buyer describes the product, plus an optional country or region, MOQ, budget, timeline and attributes. The agent returns a shortlist of real suppliers with location, MOQ, sample cost, lead times and rating, then shows each supplier's products, bulk pricing and review summary, with links to order samples on Pietra.

Offer and charging

Workflow steps

  1. Ask what the buyer wants to make, unless they already said. Also ask, optionally, for country or region, maximum MOQ, sample budget, timeline, must-have attributes (for example female owned, organic, private label) and how many suppliers they want (default 5, max 20).
  2. Call search_suppliers with the product as keyword and only the filters the buyer gave. Set limit to the number of suppliers wanted. If fewer rows come back than wanted and hasMore is true, call it again with the next page, up to 3 pages. If nothing matches, retry once with a broader keyword or without the strictest filter, and say which filter you dropped.
  3. Show the shortlist as a table: name, country or city, minMOQ, sample cost range, sample/production/shipping days, rating (out of 5, with review count) and url. Mention any note the tool returned.
  4. For the 1-3 suppliers the buyer picks (or the top 3 if they ask you to choose), call get_supplier. Present its customizations, categories, review summary with 1-2 short review quotes, and products with sample price, sample MOQ and bulk pricing tiers.
  5. If the buyer wants more products from one supplier, call search_products with supplierId. For one product in depth, call get_product. For more reviews, call get_supplier_reviews.
  6. To order a sample, get a quote or contact a supplier, give the supplier or product url and explain that this happens on Pietra. Never claim that an order, quote or message was sent.
  7. If a tool returns an error, wait about 30 seconds and retry once. If it fails again, say the Pietra marketplace is temporarily unavailable.

Tools / endpoints

MCP toolRESTPurpose
search_suppliersGET /api/suppliersFind suppliers by keyword and filters (page, limit ≤ 20)
get_supplierGET /api/suppliers/{supplier}Profile, categories, review summary, recent reviews, first products
search_productsGET /api/productsProducts by keyword or supplierId (page, limit ≤ 20)
get_productGET /api/products/{product}Full product: description, images, sample details, bulk tiers
get_supplier_reviewsGET /api/suppliers/{supplierId}/reviewsReview summary and reviews (no reviewer identity)

Example

curl 'https://pietra-sourcing.pages.dev/api/suppliers?keyword=candle&countryCode=US&maxMOQ=100&limit=3'
curl 'https://pietra-sourcing.pages.dev/api/suppliers/laguna-candles?productsLimit=3'

Response fields are listed in openapi.json. Ratings are out of 5. Lead times are in days. Pages are 1-based, and hasMore says whether another page exists.