MCPTools
search_marketplace
Search current public Product and Service listings with typed Category and Seller context.
Use search_marketplace first for most buyer discovery requests.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
query | string | No | Buyer phrase, Product, Service, identifier, SKU, or problem text. |
country | string | No | ISO 3166-1 alpha-2 Seller-country filter, such as DK. |
kind | string | No | product or service. |
categoryRoot | string | No | product or service; required with category. |
category | string | No | Typed public Category slug. |
facets | string[] | No | Reviewed tokens such as body-material:316l. |
limit | integer | No | 1 to 50. Defaults to 20. |
offset | integer | No | Stable result offset. Defaults to 0. |
Example
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "search_marketplace",
"arguments": {
"query": "316L valve body",
"kind": "product",
"limit": 10
}
}
}Returns
The structured result includes:
resultType: "marketplace_listing_search"querymoderesolvedCategorycategoryDirectionssellerMatchresultsfilterGroupsappliedFacetspaginationnextActions
Each result is a Product or Service listing with a canonical Tradebird URL, public Seller, selected source-backed facts, and truthful public commercial fields when available. The tool does not expose ranking scores, claim state, seller-agent mode, tenant identifiers, private Knowledge, or agent reasoning.