@trustrails/mcp-server 1.0.2 → 1.0.5
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 -8
- 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
|
```
|
|
@@ -84,8 +84,10 @@ Search UK electronics across major UK retailers including AO.
|
|
|
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
|
|
|
@@ -108,7 +110,7 @@ Search across **26,000+ electronics products** from major UK retailers including
|
|
|
108
110
|
|
|
109
111
|
**Price comparison:**
|
|
110
112
|
```
|
|
111
|
-
"Compare prices for
|
|
113
|
+
"Compare prices for gaming laptops across all retailers"
|
|
112
114
|
```
|
|
113
115
|
|
|
114
116
|
**Budget shopping:**
|
|
@@ -138,14 +140,13 @@ Search across **26,000+ electronics products** from major UK retailers including
|
|
|
138
140
|
- **20 requests per hour** per IP address
|
|
139
141
|
- Rate limit info included in response headers
|
|
140
142
|
- Limits reset every hour
|
|
141
|
-
- Plenty for normal shopping research - just prevents abuse
|
|
142
143
|
|
|
143
144
|
---
|
|
144
145
|
|
|
145
146
|
## Environment Variables
|
|
146
147
|
|
|
147
148
|
- `TRUSTRAILS_API_KEY` - API key (use `mcp-public-2026` for shared public access)
|
|
148
|
-
- `TRUSTRAILS_BASE_URL` - API endpoint (optional, defaults to `https://
|
|
149
|
+
- `TRUSTRAILS_BASE_URL` - API endpoint (optional, defaults to `https://trustrails.app`)
|
|
149
150
|
|
|
150
151
|
---
|
|
151
152
|
|
|
@@ -184,7 +185,7 @@ Search across **26,000+ electronics products** from major UK retailers including
|
|
|
184
185
|
|
|
185
186
|
```bash
|
|
186
187
|
# Clone the repo
|
|
187
|
-
git clone https://github.com/
|
|
188
|
+
git clone https://github.com/james-webdev/trustrails-mcp-server
|
|
188
189
|
cd trustrails-mcp-server
|
|
189
190
|
|
|
190
191
|
# Install dependencies
|
|
@@ -205,8 +206,8 @@ npx @modelcontextprotocol/inspector npm run dev
|
|
|
205
206
|
|
|
206
207
|
## Support & Links
|
|
207
208
|
|
|
208
|
-
- **Website:** [trustrails.app](https://
|
|
209
|
-
- **Issues:** [GitHub Issues](https://github.com/
|
|
209
|
+
- **Website:** [trustrails.app](https://trustrails.app)
|
|
210
|
+
- **Issues:** [GitHub Issues](https://github.com/james-webdev/trustrails-mcp-server/issues)
|
|
210
211
|
- **NPM:** [@trustrails/mcp-server](https://www.npmjs.com/package/@trustrails/mcp-server)
|
|
211
212
|
- **MCP Registry:** [modelcontextprotocol.io/servers](https://modelcontextprotocol.io/servers)
|
|
212
213
|
|
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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"}
|