Structured B2B supply search, quoting, sandbox orders and fulfillment status for agents.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Cancel an order before fulfillment when the state machine permits it. Cancellation is terminal and emits order.cancelled.
Order identifier returned by create_order.
Short human-readable cancellation reason recorded in the order event.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Cancel an order before fulfillment when the state machine permits it. Cancellation is terminal and emits order.cancelled.
| Argument | Type | Description |
|---|---|---|
| reason | string | Short human-readable cancellation reason recorded in the order event. |
| orderId* | string | Order identifier returned by create_order. |
{
"type": "object",
"required": [
"orderId"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 500,
"description": "Short human-readable cancellation reason recorded in the order event."
},
"orderId": {
"type": "string",
"description": "Order identifier returned by create_order."
}
}
}Compare non-binding quote options for approved merchant SKUs by quantity and destination. Returns no options when the catalog is empty.
| Argument | Type | Description |
|---|---|---|
| items* | array | At least one requested line with sku and a positive integer quantity. |
| destination* | object | Buyer delivery destination used for shipping estimates. |
| environment | string | Catalog environment. Only production listings can produce a quote. |
{
"type": "object",
"required": [
"items",
"destination"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"sku",
"quantity"
],
"properties": {
"sku": {
"type": "string",
"description": "Public BuyingMesh SKU."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Requested units; must meet the product MOQ."
}
}
},
"minItems": 1,
"description": "At least one requested line with sku and a positive integer quantity."
},
"destination": {
"type": "object",
"required": [
"country"
],
"properties": {
"city": {
"type": "string",
"description": "Destination city, if known."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code, such as US or GB."
},
"postalCode": {
"type": "string",
"description": "Destination postal code, if known."
}
},
"description": "Buyer delivery destination used for shipping estimates."
},
"environment": {
"enum": [
"production"
],
"type": "string",
"description": "Catalog environment. Only production listings can produce a quote."
}
}
}Compare eligible supplier offers for the same requested SKUs, quantity and destination. This is read-only and returns estimated shipping separately from item subtotal.
| Argument | Type | Description |
|---|---|---|
| items* | array | Requested SKU lines used to compare complete supplier offers. |
| destination* | object | Buyer delivery destination for shipping estimates. |
| environment | string | Catalog environment. Only production listings are public. |
{
"type": "object",
"required": [
"items",
"destination"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"sku",
"quantity"
],
"properties": {
"sku": {
"type": "string",
"description": "Public BuyingMesh SKU."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Requested units."
}
}
},
"minItems": 1,
"description": "Requested SKU lines used to compare complete supplier offers."
},
"destination": {
"type": "object",
"required": [
"country"
],
"properties": {
"city": {
"type": "string",
"description": "Destination city."
},
"country": {
"type": "string",
"description": "ISO country code."
},
"postalCode": {
"type": "string",
"description": "Destination postal code."
}
},
"description": "Buyer delivery destination for shipping estimates."
},
"environment": {
"enum": [
"production"
],
"type": "string",
"description": "Catalog environment. Only production listings are public."
}
}
}Send a support request from an agent to the BuyingMesh operator by email. Never include private keys, passwords or payment secrets.
| Argument | Type | Description |
|---|---|---|
| page | string | Optional page, endpoint or resource where the issue occurred. |
| agentId | string | Stable calling agent identifier for support correlation. |
| context | object | Optional structured diagnostic context. Exclude secrets. |
| message* | string | Clear support question or issue. Do not include passwords, private keys or payment secrets. |
| replyTo | string | Optional email address where the operator can reply. |
| subject | string | Short email subject for the operator. |
| agentName | string | Calling agent or application name. |
{
"type": "object",
"required": [
"message"
],
"properties": {
"page": {
"type": "string",
"maxLength": 240,
"description": "Optional page, endpoint or resource where the issue occurred."
},
"agentId": {
"type": "string",
"maxLength": 180,
"description": "Stable calling agent identifier for support correlation."
},
"context": {
"type": "object",
"description": "Optional structured diagnostic context. Exclude secrets.",
"additionalProperties": true
},
"message": {
"type": "string",
"maxLength": 4000,
"minLength": 5,
"description": "Clear support question or issue. Do not include passwords, private keys or payment secrets."
},
"replyTo": {
"type": "string",
"format": "email",
"description": "Optional email address where the operator can reply."
},
"subject": {
"type": "string",
"maxLength": 180,
"description": "Short email subject for the operator."
},
"agentName": {
"type": "string",
"maxLength": 180,
"description": "Calling agent or application name."
}
}
}Request an order from a buyer-approved production quote. Live order creation is currently closed: this tool returns the stable error code ordering_not_open and recommends submit_inquiry until settlement and fulfillment are enabled. It never charges the buyer while closed.
| Argument | Type | Description |
|---|---|---|
| agent | object | Optional agent identity retained for supplier communication and audit. |
| buyer* | object | Buyer identity used for order records and supplier communication. |
| quoteId* | string | Production quote ID beginning with q_; it must be current and explicitly approved by the buyer. |
| idempotencyKey | string | Client-generated key reused on retries to prevent duplicate order creation. |
| shippingAddress* | object | Complete destination address for fulfillment. |
{
"type": "object",
"required": [
"quoteId",
"buyer",
"shippingAddress"
],
"properties": {
"agent": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable agent identifier."
},
"name": {
"type": "string",
"description": "Agent or application name."
},
"version": {
"type": "string",
"description": "Agent version."
},
"callbackUrl": {
"type": "string",
"format": "uri",
"description": "Optional HTTPS callback URL for fulfillment events."
}
},
"description": "Optional agent identity retained for supplier communication and audit."
},
"buyer": {
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string",
"description": "Buyer contact name."
},
"email": {
"type": "string",
"format": "email",
"description": "Buyer contact email."
},
"company": {
"type": "string",
"description": "Buyer company name, if applicable."
}
},
"description": "Buyer identity used for order records and supplier communication."
},
"quoteId": {
"type": "string",
"pattern": "^q_",
"description": "Production quote ID beginning with q_; it must be current and explicitly approved by the buyer."
},
"idempotencyKey": {
"type": "string",
"maxLength": 200,
"minLength": 8,
"description": "Client-generated key reused on retries to prevent duplicate order creation."
},
"shippingAddress": {
"type": "object",
"required": [
"country"
],
"properties": {
"city": {
"type": "string",
"description": "City."
},
"name": {
"type": "string",
"description": "Recipient name."
},
"line1": {
"type": "string",
"description": "Street address line."
},
"line2": {
"type": "string",
"description": "Optional address line."
},
"region": {
"type": "string",
"description": "State, province or region."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code."
},
"postalCode": {
"type": "string",
"description": "Postal code."
}
},
"description": "Complete destination address for fulfillment."
}
}
}Create a retrievable, non-binding quote snapshot for published merchant SKUs. Real order creation remains disabled until production settlement and fulfillment are ready.
| Argument | Type | Description |
|---|---|---|
| items* | array | At least one requested line with sku and a positive integer quantity. |
| destination* | object | Buyer delivery destination used for the non-binding quote. |
| environment | string | Catalog environment. Only production listings can produce a quote. |
{
"type": "object",
"required": [
"items",
"destination"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"sku",
"quantity"
],
"properties": {
"sku": {
"type": "string",
"description": "Public BuyingMesh SKU."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Requested units; must meet the product MOQ."
}
}
},
"minItems": 1,
"description": "At least one requested line with sku and a positive integer quantity."
},
"destination": {
"type": "object",
"required": [
"country"
],
"properties": {
"city": {
"type": "string",
"description": "Destination city, if known."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code, such as US or GB."
},
"postalCode": {
"type": "string",
"description": "Destination postal code, if known."
}
},
"description": "Buyer delivery destination used for the non-binding quote."
},
"environment": {
"enum": [
"production"
],
"type": "string",
"description": "Catalog environment. Only production listings can produce a quote."
}
}
}Combine product subtotal, estimated shipping and preliminary duty into a destination landed-cost range. The response includes assumptions and must not be treated as a binding quote.
| Argument | Type | Description |
|---|---|---|
| items* | array | Requested SKU lines used to calculate product subtotal. |
| hsCode | string | Optional HS code used for preliminary duty estimation. |
| weightKg | number | Optional packed weight per unit in kilograms. |
| destination* | object | Buyer delivery destination for shipping and duty assumptions. |
| environment | string | Catalog environment. Only production listings are public. |
| dimensionsCm | object | Optional packed shipment dimensions in centimeters. |
{
"type": "object",
"required": [
"items",
"destination"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"sku",
"quantity"
],
"properties": {
"sku": {
"type": "string",
"description": "Public BuyingMesh SKU."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Requested units."
}
}
},
"minItems": 1,
"description": "Requested SKU lines used to calculate product subtotal."
},
"hsCode": {
"type": "string",
"description": "Optional HS code used for preliminary duty estimation."
},
"weightKg": {
"type": "number",
"minimum": 0,
"description": "Optional packed weight per unit in kilograms."
},
"destination": {
"type": "object",
"required": [
"country"
],
"properties": {
"city": {
"type": "string",
"description": "Destination city."
},
"country": {
"type": "string",
"description": "ISO country code."
},
"postalCode": {
"type": "string",
"description": "Destination postal code."
}
},
"description": "Buyer delivery destination for shipping and duty assumptions."
},
"environment": {
"enum": [
"production"
],
"type": "string",
"description": "Catalog environment. Only production listings are public."
},
"dimensionsCm": {
"type": "object",
"properties": {
"width": {
"type": "number",
"minimum": 0,
"description": "Packed width in cm."
},
"height": {
"type": "number",
"minimum": 0,
"description": "Packed height in cm."
},
"length": {
"type": "number",
"minimum": 0,
"description": "Packed length in cm."
}
},
"description": "Optional packed shipment dimensions in centimeters."
}
}
}Read order status, tracking number, ETA, payment mode and fulfillment events.
| Argument | Type | Description |
|---|---|---|
| orderId* | string | Order identifier returned by a successful production order creation. |
{
"type": "object",
"required": [
"orderId"
],
"properties": {
"orderId": {
"type": "string",
"description": "Order identifier returned by a successful production order creation."
}
}
}Retrieve a product as Schema.org JSON-LD from the selected catalog environment.
| Argument | Type | Description |
|---|---|---|
| sku* | string | Exact public SKU returned by search_products or list_supplier_products. |
| environment | string | Catalog environment. Public detail is available only for production listings. |
{
"type": "object",
"required": [
"sku"
],
"properties": {
"sku": {
"type": "string",
"description": "Exact public SKU returned by search_products or list_supplier_products."
},
"environment": {
"enum": [
"production"
],
"type": "string",
"description": "Catalog environment. Public detail is available only for production listings."
}
}
}Retrieve a previously created quote by quoteId and inspect its expiry, line items, destination and supplier options.
| Argument | Type | Description |
|---|---|---|
| quoteId* | string | Quote identifier beginning with q_, returned by create_quote or compare_quotes. |
{
"type": "object",
"required": [
"quoteId"
],
"properties": {
"quoteId": {
"type": "string",
"pattern": "^q_",
"description": "Quote identifier beginning with q_, returned by create_quote or compare_quotes."
}
}
}Retrieve a public supplier storefront by stable supplier ID or public slug.
| Argument | Type | Description |
|---|---|---|
| supplierId* | string | Stable supplier ID or public supplier slug returned by search_suppliers. |
{
"type": "object",
"required": [
"supplierId"
],
"properties": {
"supplierId": {
"type": "string",
"description": "Stable supplier ID or public supplier slug returned by search_suppliers."
}
}
}Retrieve platform-observed supplier fulfillment metrics, order sample size and as-of timestamp. Self-reported claims are not substituted for observed data.
| Argument | Type | Description |
|---|---|---|
| supplierId* | string | Stable supplier ID returned by search_suppliers or a supplier product. |
{
"type": "object",
"required": [
"supplierId"
],
"properties": {
"supplierId": {
"type": "string",
"description": "Stable supplier ID returned by search_suppliers or a supplier product."
}
}
}List precisely filtered, approved catalog products for a public supplier storefront.
| Argument | Type | Description |
|---|---|---|
| q | string | Free-text filter across the selected supplier product fields. |
| sku | string | Exact SKU filter within the selected supplier storefront. |
| gtin | string | Exact GTIN, UPC or EAN filter within the selected supplier storefront. |
| size | string | Case-insensitive size or dimension filter. |
| limit | integer | Number of products to return; server clamps this to 100. |
| cursor | string | Opaque pagination cursor returned by a previous product list. |
| maxMoq | integer | Maximum acceptable order quantity in whole units. |
| minMoq | integer | Minimum acceptable order quantity in whole units. |
| category | string | Exact normalized category filter. |
Return a preliminary HS-code and destination tariff estimate. Customs classification and the final duty remain subject to broker confirmation.
| Argument | Type | Description |
|---|---|---|
| hsCode* | string | HS code supplied by the merchant or customs broker, without spaces where possible. |
| currency | string | ISO 4217 currency code for customsValue. |
| customsValue | number | Declared customs value of the goods in the supplied currency. |
| destinationCountry* | string | Destination ISO country code used for the indicative duty range. |
{
"type": "object",
"required": [
"hsCode",
"destinationCountry"
],
"properties": {
"hsCode": {
"type": "string",
"description": "HS code supplied by the merchant or customs broker, without spaces where possible."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code for customsValue."
},
"customsValue": {
"type": "number",
"minimum": 0,
"description": "Declared customs value of the goods in the supplied currency."
},
"destinationCountry": {
"type": "string",
"description": "Destination ISO country code used for the indicative duty range."
}
}
}Create a short-lived explicit confirmation request for a quote before any order mutation. This tool has no payment or order side effect.
| Argument | Type | Description |
|---|---|---|
| quoteId* | string | Quote identifier beginning with q_, returned by create_quote. |
| buyerNote | string | Optional buyer instruction shown with the confirmation request. |
{
"type": "object",
"required": [
"quoteId"
],
"properties": {
"quoteId": {
"type": "string",
"pattern": "^q_",
"description": "Quote identifier beginning with q_, returned by create_quote."
},
"buyerNote": {
"type": "string",
"maxLength": 500,
"description": "Optional buyer instruction shown with the confirmation request."
}
}
}Search structured products using exact SKU or GTIN, supplier, material, dimensions, MOQ, price, inventory state, lead time and qualification filters. Returns approved merchant listings; inventory may be unknown and must be freshly confirmed before quote or order.
| Argument | Type | Description |
|---|---|---|
| q | string | Free-text search across SKU, product name, material, size, category and supplier name. |
| sku | string | Exact public SKU identifier; use this for a single known product. |
| gtin | string | Exact GTIN, UPC or EAN identifier when supplied by the merchant. |
| size | string | Case-insensitive size or dimension filter using the merchant value. |
| limit | integer | Number of results to return; server clamps this to a safe maximum of 100. |
| cursor | string | Opaque pagination cursor returned by a previous search response. |
| maxMoq | integer | Maximum acceptable order quantity in whole units. |
| minMoq | integer | Minimum acceptable order quantity in whole units. |
Return non-binding shipping estimates from an origin to a destination. Carrier confirmation is required before any transaction.
| Argument | Type | Description |
|---|---|---|
| origin | object | Optional shipment origin used to refine the estimate. |
| quantity | integer | Number of units in the shipment. |
| weightKg | number | Packed weight per unit in kilograms; a default assumption is used when omitted. |
| destination* | object | Delivery destination; country is required for zone estimation. |
| dimensionsCm | object | Packed shipment dimensions in centimeters. |
{
"type": "object",
"required": [
"destination"
],
"properties": {
"origin": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "Origin city."
},
"country": {
"type": "string",
"description": "Origin country code."
}
},
"description": "Optional shipment origin used to refine the estimate."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Number of units in the shipment."
},
"weightKg": {
"type": "number",
"minimum": 0,
"description": "Packed weight per unit in kilograms; a default assumption is used when omitted."
},
"destination": {
"type": "object",
"required": [
"country"
],
"properties": {
"city": {
"type": "string",
"description": "Destination city."
},
"country": {
"type": "string",
"description": "ISO country code."
},
"postalCode": {
"type": "string",
"description": "Destination postal code."
}
},
"description": "Delivery destination; country is required for zone estimation."
},
"dimensionsCm": {
"type": "object",
"properties": {
"width": {
"type": "number",
"minimum": 0,
"description": "Packed width in cm."
},
"height": {
"type": "number",
"minimum": 0,
"description": "Packed height in cm."
},
"length": {
"type": "number",
"minimum": 0,
"description": "Packed length in cm."
}
},
"description": "Packed shipment dimensions in centimeters."
}
}
}Find approved public supplier storefronts and inspect reviewed credentials and platform-observed performance.
| Argument | Type | Description |
|---|---|---|
| q | string | Free-text search across public supplier name, legal name, description and slug. |
| limit | integer | Number of suppliers to return; server clamps this to 100. |
| cursor | string | Opaque pagination cursor returned by a previous supplier search. |
| category | string | Supplier category to match against the reviewed catalog. |
| verified | boolean | Filter by platform-reviewed verification state. |
| minProducts | integer | Minimum number of approved public SKUs in the supplier storefront. |
| supplierType | string | Supplier profile type, such as manufacturer, wholesaler or brand. |
| countryRegion | string | Exact country or region code/name used by the supplier profile. |
Send a structured, non-binding product inquiry to the responsible merchant. Use this when inventory is unknown, a buyer needs a supplier answer, or a quote cannot yet be issued. The inquiry stores SKU, quantity, destination, buyer and agent identity and does not create an order or payment.
| Argument | Type | Description |
|---|---|---|
| agent | object | Optional calling-agent identity included in the inquiry audit record. |
| buyer* | object | Buyer contact details required for supplier follow-up. |
| items* | array | One to 50 SKU lines. Use this when inventory is unknown or a supplier answer is needed. |
| message | string | Additional non-sensitive instructions or questions for the supplier. |
| destination* | object | Buyer delivery destination. |
| idempotencyKey | string | Client-generated key reused on retries so the same inquiry is not duplicated. |
{
"type": "object",
"required": [
"items",
"destination",
"buyer"
],
"properties": {
"agent": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable agent identifier."
},
"name": {
"type": "string",
"description": "Agent or application name."
},
"version": {
"type": "string",
"description": "Agent version."
}
},
"description": "Optional calling-agent identity included in the inquiry audit record."
},
"buyer": {
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string",
"description": "Buyer contact name."
},
"email": {
"type": "string",
"format": "email",
"description": "Buyer contact email."
},
"company": {
"type": "string",
"description": "Buyer company name."
}
},
"description": "Buyer contact details required for supplier follow-up."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"sku",
"quantity"
],
"properties": {
"sku": {
"type": "string",
"description": "Published BuyingMesh SKU."
},
"note": {
"type": "string",
"maxLength": 300,
"description": "Optional SKU-specific question for the supplier."
},
"quantity": {
"type": "integer",
"maximum": 1000000000,
"minimum": 1,
"description": "Requested units; must meet the product MOQ."
}
}
},
"maxItems": 50,
"minItems": 1,
"description": "One to 50 SKU lines. Use this when inventory is unknown or a supplier answer is needed."
},
"message": {
"type": "string",
"maxLength": 2000,
"description": "Additional non-sensitive instructions or questions for the supplier."
},
"destination": {
"type": "object",
"required": [
"country"
],
"properties": {
"city": {
"type": "string",
"description": "Destination city."
},
"region": {
"type": "string",
"description": "State, province or region."
},
"country": {
"type": "string",
"description": "ISO country code."
},
"postalCode": {
"type": "string",
"description": "Destination postal code."
}
},
"description": "Buyer delivery destination."
},
"idempotencyKey": {
"type": "string",
"maxLength": 200,
"description": "Client-generated key reused on retries so the same inquiry is not duplicated."
}
}
}Advance an enabled order through an allowed fulfillment state transition and emit its webhook event. Use only when the responsible fulfillment party has supplied evidence.
| Argument | Type | Description |
|---|---|---|
| data | object | Evidence for the transition, such as trackingNumber, carrier, eta or dispute reason. |
| status* | string | Next allowed fulfillment state supported by the order state machine. |
| orderId* | string | Order identifier returned by create_order. |
{
"type": "object",
"required": [
"orderId",
"status"
],
"properties": {
"data": {
"type": "object",
"description": "Evidence for the transition, such as trackingNumber, carrier, eta or dispute reason.",
"additionalProperties": true
},
"status": {
"enum": [
"shipped",
"tracking_updated",
"eta_updated",
"delivered",
"accepted",
"released",
"disputed"
],
"type": "string",
"description": "Next allowed fulfillment state supported by the order state machine."
},
"orderId": {
"type": "string",
"description": "Order identifier returned by create_order."
}
}
}| material |
| string |
| Case-insensitive material filter. |
| maxPrice | number | Maximum unit price in the listing currency. |
| minPrice | number | Minimum unit price in the listing currency. |
| supplierId* | string | Stable supplier ID returned by search_suppliers; this scopes every result to one storefront. |
| minInventory | integer | Minimum supplier-confirmed sellable inventory in whole units. |
| verifiedOnly | boolean | When true, return only products with the supplier verification signal. |
| maxLeadTimeDays | integer | Maximum stated lead time in calendar days. |
{
"type": "object",
"required": [
"supplierId"
],
"properties": {
"q": {
"type": "string",
"description": "Free-text filter across the selected supplier product fields."
},
"sku": {
"type": "string",
"description": "Exact SKU filter within the selected supplier storefront."
},
"gtin": {
"type": "string",
"description": "Exact GTIN, UPC or EAN filter within the selected supplier storefront."
},
"size": {
"type": "string",
"description": "Case-insensitive size or dimension filter."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of products to return; server clamps this to 100."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor returned by a previous product list."
},
"maxMoq": {
"type": "integer",
"minimum": 1,
"description": "Maximum acceptable order quantity in whole units."
},
"minMoq": {
"type": "integer",
"minimum": 1,
"description": "Minimum acceptable order quantity in whole units."
},
"category": {
"type": "string",
"description": "Exact normalized category filter."
},
"material": {
"type": "string",
"description": "Case-insensitive material filter."
},
"maxPrice": {
"type": "number",
"minimum": 0,
"description": "Maximum unit price in the listing currency."
},
"minPrice": {
"type": "number",
"minimum": 0,
"description": "Minimum unit price in the listing currency."
},
"supplierId": {
"type": "string",
"description": "Stable supplier ID returned by search_suppliers; this scopes every result to one storefront."
},
"minInventory": {
"type": "integer",
"minimum": 0,
"description": "Minimum supplier-confirmed sellable inventory in whole units."
},
"verifiedOnly": {
"type": "boolean",
"description": "When true, return only products with the supplier verification signal."
},
"maxLeadTimeDays": {
"type": "integer",
"minimum": 0,
"description": "Maximum stated lead time in calendar days."
}
}
}| category | string | Exact normalized product category, for example jewelry or hair-accessories. |
| currency | string | ISO 4217 currency code for price filtering, normally USD. |
| material | string | Case-insensitive material filter, such as stainless steel or acetate. |
| maxPrice | number | Maximum unit price in the requested currency. |
| minPrice | number | Minimum unit price in the requested currency. |
| supplierId | string | Stable BuyingMesh supplier ID returned by search_suppliers or get_supplier. |
| environment | string | Catalog environment. Only production reviewed listings are publicly available. |
| minInventory | integer | Minimum currently sellable inventory in whole units; unknown inventory is not counted. |
| supplierSlug | string | Public supplier slug from the supplier storefront URL. |
| verifiedOnly | boolean | When true, return only listings with a verified supplier or qualification signal. |
| inventoryStatus | string | Inventory evidence filter. confirmed means supplier-confirmed sellable units; unknown means a fresh confirmation is required. |
| maxLeadTimeDays | integer | Maximum stated supplier lead time in calendar days. |
| qualificationStatus | string | Merchant qualification text to match, such as verified or reviewed. |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Free-text search across SKU, product name, material, size, category and supplier name."
},
"sku": {
"type": "string",
"description": "Exact public SKU identifier; use this for a single known product."
},
"gtin": {
"type": "string",
"description": "Exact GTIN, UPC or EAN identifier when supplied by the merchant."
},
"size": {
"type": "string",
"description": "Case-insensitive size or dimension filter using the merchant value."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of results to return; server clamps this to a safe maximum of 100."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor returned by a previous search response."
},
"maxMoq": {
"type": "integer",
"minimum": 1,
"description": "Maximum acceptable order quantity in whole units."
},
"minMoq": {
"type": "integer",
"minimum": 1,
"description": "Minimum acceptable order quantity in whole units."
},
"category": {
"type": "string",
"description": "Exact normalized product category, for example jewelry or hair-accessories."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code for price filtering, normally USD."
},
"material": {
"type": "string",
"description": "Case-insensitive material filter, such as stainless steel or acetate."
},
"maxPrice": {
"type": "number",
"minimum": 0,
"description": "Maximum unit price in the requested currency."
},
"minPrice": {
"type": "number",
"minimum": 0,
"description": "Minimum unit price in the requested currency."
},
"supplierId": {
"type": "string",
"description": "Stable BuyingMesh supplier ID returned by search_suppliers or get_supplier."
},
"environment": {
"enum": [
"production"
],
"type": "string",
"description": "Catalog environment. Only production reviewed listings are publicly available."
},
"minInventory": {
"type": "integer",
"minimum": 0,
"description": "Minimum currently sellable inventory in whole units; unknown inventory is not counted."
},
"supplierSlug": {
"type": "string",
"description": "Public supplier slug from the supplier storefront URL."
},
"verifiedOnly": {
"type": "boolean",
"description": "When true, return only listings with a verified supplier or qualification signal."
},
"inventoryStatus": {
"enum": [
"confirmed",
"unknown"
],
"type": "string",
"description": "Inventory evidence filter. confirmed means supplier-confirmed sellable units; unknown means a fresh confirmation is required."
},
"maxLeadTimeDays": {
"type": "integer",
"minimum": 0,
"description": "Maximum stated supplier lead time in calendar days."
},
"qualificationStatus": {
"type": "string",
"description": "Merchant qualification text to match, such as verified or reviewed."
}
}
}{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Free-text search across public supplier name, legal name, description and slug."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of suppliers to return; server clamps this to 100."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor returned by a previous supplier search."
},
"category": {
"type": "string",
"description": "Supplier category to match against the reviewed catalog."
},
"verified": {
"type": "boolean",
"description": "Filter by platform-reviewed verification state."
},
"minProducts": {
"type": "integer",
"minimum": 0,
"description": "Minimum number of approved public SKUs in the supplier storefront."
},
"supplierType": {
"type": "string",
"description": "Supplier profile type, such as manufacturer, wholesaler or brand."
},
"countryRegion": {
"type": "string",
"description": "Exact country or region code/name used by the supplier profile."
}
}
}