Pietra Sourcing Assistant API
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:
- MCP (Streamable HTTP, stateless):
https://pietra-sourcing.pages.dev/mcp. Tools:search_suppliers,get_supplier,search_products,get_product,get_supplier_reviews. - REST: base URL
https://pietra-sourcing.pages.dev, described in openapi.json. Five GET endpoints mirror the MCP tools.
Business policies
These are the Pietra Sourcing Assistant's policies on Agent Relay. Every answer follows them.
- Free search. Finding suppliers and products costs the buyer nothing. Samples, production orders and quotes are bought on pietrastudio.com, through the supplier or product link.
- Real marketplace data only. Every supplier, product, price, MOQ, lead time and rating must come from a tool result in this conversation. Nothing is invented or estimated. If nothing matches, the assistant says so and suggests a broader keyword or fewer filters.
- Read-only. The assistant cannot order samples, place production orders, request quotes, negotiate prices or message suppliers. For any of those it gives the supplier or product url, where the buyer can do it with a free Pietra account.
- No contact details. Supplier emails, phone numbers, street addresses and reviewer identities are not provided. Suppliers are contacted through Pietra.
- Prices. All prices are in USD. The sample price is the price shown on Pietra and includes Pietra's service fee. Bulk pricing tiers are the per-unit prices the supplier lists. The final production quote can differ with customization, materials and shipping. A null sample price means "quote on request".
- Available filters: keyword, country, region, marketplace attributes (Low MOQs, Female Owned, BIPOC Owned, Private Label Products, Contract Manufacturer, Certified Organic, Sustainable Materials, 10+ Years in Business, FDA Approved, Capacity for 25k+ Units, Packaging Options Available, Vegan), MOQ range, maximum sample cost, minimum rating and maximum production days. For certifications, materials or capabilities with no tag, the assistant searches by keyword and says it is a keyword match, not a verified certification.
- Not available: shipping quotes, tariff or duty calculations, factory audits, live stock levels, and suppliers outside the Pietra marketplace.
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
- Charging: No agent fee (searching is free). How the agent starts: Don't collect data, ask in the conversation.
- Customer gets: a supplier shortlist table (name, location, MOQ, sample cost, lead times, rating, link) plus product details and review summaries for the suppliers the buyer picks.
- Tools: either the MCP server above, or API access by importing openapi.json with no auth. Model: Standard AI.
Workflow steps
- 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).
- 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.
- 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.
- 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.
- 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.
- 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.
- 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 tool | REST | Purpose |
|---|---|---|
search_suppliers | GET /api/suppliers | Find suppliers by keyword and filters (page, limit ≤ 20) |
get_supplier | GET /api/suppliers/{supplier} | Profile, categories, review summary, recent reviews, first products |
search_products | GET /api/products | Products by keyword or supplierId (page, limit ≤ 20) |
get_product | GET /api/products/{product} | Full product: description, images, sample details, bulk tiers |
get_supplier_reviews | GET /api/suppliers/{supplierId}/reviews | Review 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.