@trustrails/mcp-server 1.0.1 → 1.0.4
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 +7 -13
- package/dist/index.js +15 -1
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -59,7 +59,7 @@ That's it! Restart Claude and start searching.
|
|
|
59
59
|
|
|
60
60
|
```
|
|
61
61
|
"Find me a gaming laptop under £1000"
|
|
62
|
-
"Compare prices for
|
|
62
|
+
"Compare prices for gaming laptops across retailers"
|
|
63
63
|
"Show me the cheapest 4K monitors over 27 inches"
|
|
64
64
|
"What HP laptops are in stock right now between £500-£700?"
|
|
65
65
|
```
|
|
@@ -76,7 +76,7 @@ Claude will search across multiple UK retailers and show you:
|
|
|
76
76
|
|
|
77
77
|
### `search_products`
|
|
78
78
|
|
|
79
|
-
Search UK electronics across
|
|
79
|
+
Search UK electronics across major UK retailers including AO.
|
|
80
80
|
|
|
81
81
|
**Parameters:**
|
|
82
82
|
- `query` (string) - Search term (e.g., "laptop", "USB-C charger")
|
|
@@ -84,8 +84,10 @@ Search UK electronics across multiple retailers (AO, Boxed2Me, In Stock UK, Back
|
|
|
84
84
|
- `max_price` (number, optional) - Maximum price in GBP
|
|
85
85
|
- `brand` (string, optional) - Filter by brand (e.g., "Sony", "HP", "Apple")
|
|
86
86
|
- `category` (string, optional) - Filter by category (e.g., "Laptops", "Headphones")
|
|
87
|
+
- `lite` (boolean, optional) - Return trimmed product objects (reduces payload by ~80%). Recommended for ChatGPT and other LLMs.
|
|
88
|
+
- `limit` (number, optional) - Maximum products to return (default 20, max 100)
|
|
87
89
|
|
|
88
|
-
**Returns:** Up to 20 products with full details (title, price, specs, availability, purchase links)
|
|
90
|
+
**Returns:** Up to 20 products (or `limit`) with full details (title, price, specs, availability, purchase links). With `lite: true`, returns only essential fields.
|
|
89
91
|
|
|
90
92
|
### `get_product`
|
|
91
93
|
|
|
@@ -100,14 +102,7 @@ Get detailed information about a specific product by ID.
|
|
|
100
102
|
|
|
101
103
|
## Supported Retailers
|
|
102
104
|
|
|
103
|
-
Search across **26,000+ electronics products** from
|
|
104
|
-
|
|
105
|
-
- **AO** - Major UK electronics & appliances retailer
|
|
106
|
-
- **Boxed2Me** - Computing & electronics specialist
|
|
107
|
-
- **In Stock UK** - Tech and office equipment
|
|
108
|
-
- **Back to the Office** - Office technology & supplies
|
|
109
|
-
|
|
110
|
-
*More retailers being added regularly*
|
|
105
|
+
Search across **26,000+ electronics products** from major UK retailers including **AO**, with new retailers added regularly.
|
|
111
106
|
|
|
112
107
|
---
|
|
113
108
|
|
|
@@ -115,7 +110,7 @@ Search across **26,000+ electronics products** from:
|
|
|
115
110
|
|
|
116
111
|
**Price comparison:**
|
|
117
112
|
```
|
|
118
|
-
"Compare prices for
|
|
113
|
+
"Compare prices for gaming laptops across all retailers"
|
|
119
114
|
```
|
|
120
115
|
|
|
121
116
|
**Budget shopping:**
|
|
@@ -145,7 +140,6 @@ Search across **26,000+ electronics products** from:
|
|
|
145
140
|
- **20 requests per hour** per IP address
|
|
146
141
|
- Rate limit info included in response headers
|
|
147
142
|
- Limits reset every hour
|
|
148
|
-
- Plenty for normal shopping research - just prevents abuse
|
|
149
143
|
|
|
150
144
|
---
|
|
151
145
|
|
package/dist/index.js
CHANGED
|
@@ -4,7 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
|
|
|
4
4
|
import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
|
|
5
5
|
// TrustRails API configuration
|
|
6
6
|
const API_KEY = process.env.TRUSTRAILS_API_KEY || "mcp-public-2026";
|
|
7
|
-
const BASE_URL = process.env.TRUSTRAILS_BASE_URL || "https://
|
|
7
|
+
const BASE_URL = process.env.TRUSTRAILS_BASE_URL || "https://trustrails.app";
|
|
8
8
|
// Create server instance
|
|
9
9
|
const server = new Server({
|
|
10
10
|
name: "trustrails",
|
|
@@ -34,6 +34,12 @@ async function searchProducts(params) {
|
|
|
34
34
|
if (params.category) {
|
|
35
35
|
searchParams.append("category", params.category);
|
|
36
36
|
}
|
|
37
|
+
if (params.lite) {
|
|
38
|
+
searchParams.append("lite", "true");
|
|
39
|
+
}
|
|
40
|
+
if (params.limit && params.limit > 0) {
|
|
41
|
+
searchParams.append("limit", params.limit.toString());
|
|
42
|
+
}
|
|
37
43
|
const url = `${BASE_URL}/api/search?${searchParams.toString()}`;
|
|
38
44
|
const response = await fetch(url, {
|
|
39
45
|
headers: {
|
|
@@ -95,6 +101,14 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
|
|
|
95
101
|
type: "string",
|
|
96
102
|
description: "Filter by product category (e.g., 'Laptops', 'Headphones', 'Monitors')",
|
|
97
103
|
},
|
|
104
|
+
lite: {
|
|
105
|
+
type: "boolean",
|
|
106
|
+
description: "Return trimmed product objects with only essential fields (id, title, brand, price, availability, image_url, purchase_url). Reduces payload size by ~80%. Recommended for ChatGPT and other LLMs to avoid parsing timeouts.",
|
|
107
|
+
},
|
|
108
|
+
limit: {
|
|
109
|
+
type: "number",
|
|
110
|
+
description: "Maximum number of products to return (default 20, max 100)",
|
|
111
|
+
},
|
|
98
112
|
},
|
|
99
113
|
},
|
|
100
114
|
},
|
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,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|