Cursor
Grok Bot
Grok
MuseTitle97/100
Search B2B suppliers
The title clearly communicates the tool’s action and subject. Keep it concise.
Description90/100
Find independent B2B suppliers (wholesalers, distributors, manufacturers) in the Requstory Index to buy goods for a business: catering disposables and packaging, café and coffee supplies, cleaning and janitorial, packaging, fasteners, industrial and growing supplies, in the UK and US. Each result has dated trade facts: prices shown or quote on request (trade login), minimum order (with amount), payment terms, delivery and returns policies, trade account link, and whether an agent could order online. Verified suppliers confirmed their facts and rank first. Then use get_supplier for one supplier's full facts, or request_quote to ask a supplier for a price, stock or a delivery date.
The description explains the capability, when to use it, and what to expect.
Inputs96/100
Input documentation gives an agent enough context to populate the arguments.
query
Product type or supplier name, e.g. "compostable cups", "coffee", "M8 bolts", "janitorial".
Clear enough to supply this argument.
country
Keeps suppliers based in this country. Leave it out to include suppliers from every country in the Index.
Clear enough to supply this argument.
prices
Filters by how suppliers publish prices: shown finds suppliers whose prices are on their website, so an agent can compare them; quote finds suppliers who price on request or behind a trade login.
Clear enough to supply this argument.
maxMinimumOrder
The order size the buyer plans, to leave out suppliers whose stated minimum order is higher. Compared in the supplier's own currency, with no conversion. Suppliers that state no minimum order are kept.
Clear enough to supply this argument.
payOnAccount
When true, only suppliers that state payment terms (for example 30 days on account). Left out or false, payment terms do not filter the results.
Clear enough to supply this argument.
verifiedOnly
Only suppliers whose owner confirmed the listing.
Clear enough to supply this argument.
limit
How many suppliers to return. Verified suppliers come first, then the best matches for the query.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "Search B2B suppliers",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Output schema89/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"required": [
"suppliers",
"count",
"note",
"categories"
],
"properties": {
"note": {
"type": "string",
"description": "How to read the facts, or what to try when nothing matched."
},
"count": {
"type": "integer",
"description": "Number of suppliers returned."
},
"suppliers": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplier",
"name",
"website",
"verified",
"prices",
"canOrderOnline",
"facts"
],
"properties": {
"name": {
"type": "string",
"description": "Company name."
},
"facts": {
"type": "object",
"properties": {
"source": {
"type": [
"string",
"null"
],
"description": "website (read from its site) or owner (confirmed by the supplier)."
},
"checkedAt": {
"type": [
"string",
"null"
],
"description": "When the facts were last read (YYYY-MM-DD)."
},
"confirmedByOwnerAt": {
"type": [
"string",
"null"
],
"description": "When the owner confirmed them (YYYY-MM-DD); null if not verified."
}
},
"description": "Where the facts above come from and how old they are."
},
"track": {
"type": [
"object",
"null"
],
"properties": {
"since": {
"type": [
"string",
"null"
],
"description": "Date of the first request (YYYY-MM-DD)."
},
"source": {
"type": "string",
"description": "Where the record comes from."
},
"ordersLate": {
"type": "integer",
"description": "Orders buyers said arrived late."
},
"ordersArrived": {
"type": "integer",
"description": "Orders buyers said arrived."
},
"ordersNotArrived": {
"type": "integer",
"description": "Orders buyers said did not arrive."
},
"requestsAnswered": {
"type": "string",
"description": "Requests answered out of requests sent, for example \"3 of 4\"."
},
"usualAnswerHours": {
"type": [
"integer",
"null"
],
"description": "Typical hours to answer (the median); null before the first answer."
}
},
"description": "Its record with buyer requests sent through Requstory; null before the first one."
},
"prices": {
"type": "object",
"properties": {
"mode": {
"type": [
"string",
"null"
],
"description": "How it shows prices: shown (on the website), quote (on request), trade_login (behind a trade login) or unknown."
},
"example": {
"type": [
"string",
"null"
],
"description": "A price read on its site, as written there."
}
},
"description": "Whether a buyer can see prices."
},
"quotes": {
"type": "boolean",
"description": "request_quote can reach this supplier."
},
"country": {
"type": [
"string",
"null"
],
"description": "Two-letter code of the country it is based in, for example GB."
},
"profile": {
"type": [
"string",
"null"
],
"description": "Requstory company page, when one is published."
},
"website": {
"type": "string",
"description": "Home page address."
},
"category": {
"type": [
"string",
"null"
],
"description": "What it supplies, for example \"Compostable packaging\"."
},
"supplier": {
"type": "string",
"description": "The supplier's website domain, its id in the Index; pass it to get_supplier or request_quote."
},
"verified": {
"type": "boolean",
"description": "The owner confirmed the listing and its facts."
},
"deliveryArea": {
"type": [
"string",
"null"
],
"description": "Where it delivers, as stated."
},
"minimumOrder": {
"type": [
"object",
"null"
],
"properties": {
"text": {
"type": "string",
"description": "The minimum order as the supplier states it."
},
"amount": {
"type": [
"number",
"null"
],
"description": "The amount read from that text."
},
"currency": {
"type": [
"string",
"null"
],
"description": "Currency of the amount: GBP, USD or EUR."
}
},
"description": "Its stated minimum order; null when none was found."
},
"paymentTerms": {
"type": [
"string",
"null"
],
"description": "Payment terms as stated, for example \"30 days on account\"."
},
"recentPrices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "When it was read or quoted (YYYY-MM-DD)."
},
"item": {
"type": [
"string",
"null"
],
"description": "The product."
},
"price": {
"type": [
"string",
"null"
],
"description": "The price as read or quoted."
},
"source": {
"type": "string",
"description": "website (read on its site) or owner (quoted by the supplier)."
}
}
},
"description": "Prices read on its site or quoted to buyers in the last 60 days, newest first."
},
"tradeAccount": {
"type": [
"string",
"null"
],
"description": "Link to open a trade account."
},
"returnsPolicy": {
"type": [
"string",
"null"
],
"description": "Link to the returns policy."
},
"canOrderOnline": {
"type": "boolean",
"description": "Our AI buyer found a way to order on its website."
},
"deliveryPolicy": {
"type": [
"string",
"null"
],
"description": "Link to the delivery policy."
}
}
},
"description": "Matching suppliers, verified first."
},
"categories": {
"type": "array",
"items": {
"type": "string"
},
"description": "Categories in the Index, to try in \"query\"."
}
}
}