@trustrails/mcp-server 1.0.8 → 1.0.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +9 -9
- package/dist/index.js +17 -10
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -76,33 +76,33 @@ Claude will search across multiple UK retailers and show you:
|
|
|
76
76
|
|
|
77
77
|
### `search_products`
|
|
78
78
|
|
|
79
|
-
Search UK electronics
|
|
79
|
+
Search 26,000+ UK electronics products. Returns summary data (title, price, availability, category). For full technical specs, use `get_product`.
|
|
80
80
|
|
|
81
81
|
**Parameters:**
|
|
82
|
-
- `query` (string) - Search term (e.g., "laptop", "
|
|
82
|
+
- `query` (string) - Search term (e.g., "laptop", "Sony headphones")
|
|
83
83
|
- `min_price` (number, optional) - Minimum price in GBP
|
|
84
84
|
- `max_price` (number, optional) - Maximum price in GBP
|
|
85
|
-
- `brand` (string, optional) - Filter by brand (e.g., "Sony", "HP", "Apple")
|
|
86
|
-
- `category` (string, optional) - Filter by category (e.g.,
|
|
87
|
-
- `lite` (boolean, optional) - Return trimmed product objects (reduces payload by ~80%). Recommended for
|
|
85
|
+
- `brand` (string, optional) - Filter by brand, exact match (e.g., "Sony", "HP", "Apple")
|
|
86
|
+
- `category` (string, optional) - Filter by category: Laptops, Desktops, Tablets, Phones, TVs, Monitors, Headphones, Speakers, Cameras, Keyboards, Mice, Printers, Networking, Storage, Gaming, Wearables, Drones, Audio, Cables & Chargers. Synonyms accepted (e.g., Smartphones, Earbuds, Notebooks).
|
|
87
|
+
- `lite` (boolean, optional) - Return trimmed product objects (reduces payload by ~80%). Recommended for LLMs.
|
|
88
88
|
- `limit` (number, optional) - Maximum products to return (default 20, max 100)
|
|
89
89
|
|
|
90
|
-
**Returns:** Up to 20 products
|
|
90
|
+
**Returns:** Up to 20 products with summary data. With `lite: true`, returns only essential fields (id, title, brand, price, availability, image_url, purchase_url).
|
|
91
91
|
|
|
92
92
|
### `get_product`
|
|
93
93
|
|
|
94
|
-
Get
|
|
94
|
+
Get full details for a single product. Returns complete technical specifications, full description, stock level, delivery time, and retailer source. Use after `search_products` for detailed comparison or recommendations.
|
|
95
95
|
|
|
96
96
|
**Parameters:**
|
|
97
97
|
- `product_id` (string) - The product ID from search results
|
|
98
98
|
|
|
99
|
-
**Returns:** Complete product
|
|
99
|
+
**Returns:** Complete product with all specs, description, and retailer information
|
|
100
100
|
|
|
101
101
|
---
|
|
102
102
|
|
|
103
103
|
## Supported Retailers
|
|
104
104
|
|
|
105
|
-
Search across **
|
|
105
|
+
Search across **26,000+ electronics products** from major UK retailers including AO, with new retailers added regularly.
|
|
106
106
|
|
|
107
107
|
---
|
|
108
108
|
|
package/dist/index.js
CHANGED
|
@@ -75,9 +75,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
|
|
|
75
75
|
tools: [
|
|
76
76
|
{
|
|
77
77
|
name: "search_products",
|
|
78
|
-
description: "Search
|
|
79
|
-
"
|
|
80
|
-
"
|
|
78
|
+
description: "Search 26,000+ UK electronics products across multiple retailers. " +
|
|
79
|
+
"Returns summary data: title, brand, price, availability, category, and purchase link. " +
|
|
80
|
+
"Specs are minimal — for full technical specifications, call get_product with the product ID. " +
|
|
81
|
+
"Covers: Laptops, Phones, Tablets, Headphones, Monitors, TVs, Cameras, Keyboards, Mice, Speakers, Gaming, " +
|
|
82
|
+
"Wearables, Printers, Networking, Storage, Audio, Drones, Cables & Chargers. " +
|
|
83
|
+
"All prices in GBP. " +
|
|
81
84
|
"Tips: use short queries (under 6 words), use price filters instead of including prices in the query. " +
|
|
82
85
|
"If results are too broad, refine using brand and category filters before expanding the query.",
|
|
83
86
|
inputSchema: {
|
|
@@ -101,15 +104,16 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
|
|
|
101
104
|
},
|
|
102
105
|
brand: {
|
|
103
106
|
type: "string",
|
|
104
|
-
description: "Filter by brand name (
|
|
107
|
+
description: "Filter by brand name (exact match, case-insensitive). " +
|
|
105
108
|
"Examples: Apple, Samsung, Sony, HP, Dell, Lenovo, Anker, Bose, LG",
|
|
106
109
|
},
|
|
107
110
|
category: {
|
|
108
111
|
type: "string",
|
|
109
|
-
description: "Filter by product category
|
|
110
|
-
"Available categories: Laptops,
|
|
111
|
-
"
|
|
112
|
-
"
|
|
112
|
+
description: "Filter by product category. " +
|
|
113
|
+
"Available categories: Laptops, Desktops, Tablets, Phones, TVs, Monitors, " +
|
|
114
|
+
"Headphones, Speakers, Cameras, Keyboards, Mice, Printers, Networking, " +
|
|
115
|
+
"Storage, Gaming, Wearables, Drones, Audio, Cables & Chargers. " +
|
|
116
|
+
"Common synonyms also accepted (e.g. Smartphones, Televisions, Earbuds, Notebooks, Routers, Hard Drives).",
|
|
113
117
|
},
|
|
114
118
|
lite: {
|
|
115
119
|
type: "boolean",
|
|
@@ -126,8 +130,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
|
|
|
126
130
|
},
|
|
127
131
|
{
|
|
128
132
|
name: "get_product",
|
|
129
|
-
description: "Get
|
|
130
|
-
"Returns complete
|
|
133
|
+
description: "Get full details for a single product by ID. " +
|
|
134
|
+
"Returns complete technical specifications (model number, dimensions, raw category, and all available attributes), " +
|
|
135
|
+
"full description, pricing, stock level, delivery time, and retailer source. " +
|
|
136
|
+
"Use this after search_products to get detailed specs for comparison or recommendations. " +
|
|
137
|
+
"Always call this when a user needs precise product attributes, compatibility info, or side-by-side comparisons.",
|
|
131
138
|
inputSchema: {
|
|
132
139
|
type: "object",
|
|
133
140
|
properties: {
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,+BAA+B;AAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,iBAAiB,CAAC;AACpE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|