This tool is no longer present in the server's latest manifest. Showing the last observed version (server version 1.0.0).
catalog_search_grouped
InactiveTool of ComOS Federation Gateway
declared in 1.0.0
Search for products grouped by family. Returns one row per product (e.g. 'VnM Cooling Vest') with its variants nested. Prefer this for browsing/discovery; use catalog_search for SKU-level actions. (Federated: requires tenant_id. For cart/orders, pass auth_token from POST /v1/auth/login. Product IDs are MongoDB ObjectIds from catalog_search.) FRESHNESS: Response includes a _meta block with catalog_version and fetched_at. This data is a snapshot — call federation_catalog_version before acting (cart_add_item, etc.) and re-fetch if the version has changed.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tenant_id"
],
"properties": {
"limit": {
"type": "number",
"description": "Maximum number of variants to fetch before grouping (1-250, default 50). The family count returned will usually be smaller."
},
"query": {
"type": "string",
"description": "Search query (product name, description, etc.). Leave empty to browse all."
},
"category": {
"type": "string",
"description": "Filter by category (e.g., 'Electronics', 'Clothing')"
},
"maxPrice": {
"type": "number",
"description": "Maximum price filter"
},
"minPrice": {
"type": "number",
"description": "Minimum price filter"
},
"tenant_id": {
"type": "string",
"description": "Target tenant ID (required). Use federation_list_tenants() to see available tenants."
},
"auth_token": {
"type": "string",
"description": "JWT auth token for authenticated operations (cart, orders). Get from api_call POST /v1/auth/login."
}
},
"additionalProperties": false
}Parent server
ComOS Federation Gateway
https://github.com/ronrey/comos-federation
2/7 registries