{
  "markdown": "# TrustRails MCP Server\n\n**Search UK electronics products** - compare prices, find deals, and discover products across multiple retailers.\n\nBuilt for the [Model Context Protocol (MCP)](https://modelcontextprotocol.io) - works with Claude Desktop, Claude Code, and other MCP-compatible AI assistants.\n\n[![npm version](https://badge.fury.io/js/%40trustrails%2Fmcp-server.svg)](https://www.npmjs.com/package/@trustrails/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n---\n\n## Quick Start\n\nNo installation needed — just add TrustRails to your Claude config.\n\n### Configuration\n\n**For Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"trustrails\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@trustrails/mcp-server\"],\n      \"env\": {\n        \"TRUSTRAILS_API_KEY\": \"mcp-public-2026\"\n      }\n    }\n  }\n}\n```\n\n**For Claude Code** (`~/.config/claude/config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"trustrails\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@trustrails/mcp-server\"],\n      \"env\": {\n        \"TRUSTRAILS_API_KEY\": \"mcp-public-2026\"\n      }\n    }\n  }\n}\n```\n\nThat's it! Restart Claude and start searching.\n\n---\n\n## What You Can Do\n\n### Natural Language Product Search\n\nJust ask Claude naturally — it will decompose your request into the right query and filters:\n\n```\n\"Find me a gaming laptop under £1000\"\n\"I need Sony noise cancelling headphones\"\n\"What HP laptops are available between £500-£700?\"\n\"Show me Anker chargers\"\n```\n\nClaude will search across multiple UK retailers and show you:\n- Real-time prices & availability\n- Direct purchase links\n- Then call `get_product` for full specs when you need details\n\n---\n\n## Available Tools\n\n### `search_products`\n\nSearch 26,000+ UK electronics products. Returns summary data (title, price, availability, category). For full technical specs, use `get_product`.\n\n**Parameters:**\n- `query` (string) - Refinement terms after brand and category are extracted: model lines, series, variants, technology descriptors, or model numbers (e.g., \"neo\", \"ultra\", \"oled\", \"WH-1000XM5\"). Omit entirely if brand + category alone describe what's needed. Never put brand names, product family names, or prices here — use filters.\n- `min_price` (number, optional) - Minimum price in GBP\n- `max_price` (number, optional) - Maximum price in GBP\n- `brand` (string, optional) - Filter by brand, exact match (e.g., \"Sony\", \"HP\", \"Apple\")\n- `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.\n- `lite` (boolean, optional) - Return trimmed product objects (reduces payload by ~80%). Always use for LLM integrations.\n- `limit` (number, optional) - Maximum products to return (default 50, max 100)\n- `sort` (string, optional) - Sort order: `relevance` (default), `price_asc` (cheapest first), `price_desc` (most expensive first). Use `price_asc` when comparing prices.\n\n**Returns:** Up to 50 products with summary data. With `lite: true`, returns only essential fields (id, title, brand, price, availability, image_url, purchase_url).\n\n### `get_product`\n\nGet full details for a single product. Returns complete technical specifications including `specs.description` (full prose spec text with processor, RAM, storage, display, ports, etc.), stock level, delivery time, and all retailer offers with per-retailer pricing. Use after `search_products` for detailed comparison or recommendations.\n\n**Parameters:**\n- `product_id` (string) - The product ID from search results\n\n**Returns:** Complete product with full specs (including `specs.description`), pricing across all retailers, and provenance information\n\n---\n\n## Supported Retailers\n\nSearch across **26,000+ electronics products** from major UK retailers including AO, with new retailers added regularly.\n\n---\n\n## Example Usage\n\n**Budget shopping:**\n```\n\"Find gaming laptops under £800\"\n→ category='Laptops', query='gaming', max_price=800, sort='price_asc', lite=true\n```\n\n**Brand search:**\n```\n\"I need Sony headphones under £200\"\n→ brand='Sony', category='Headphones', max_price=200, sort='price_asc', lite=true\n```\n\n**Category browsing:**\n```\n\"Show me cheap monitors\"\n→ category='Monitors', max_price=200, lite=true\n```\n\n**Detailed specs:**\n```\n\"Tell me the full specs of this laptop\"\n→ get_product(product_id) — returns full technical specifications\n```\n\n**Price range:**\n```\n\"Apple products between £500 and £1000\"\n→ brand='Apple', min_price=500, max_price=1000, lite=true\n```\n\n---\n\n## Rate Limits\n\n- **50 requests per hour** per IP address\n- Rate limit info included in response headers\n- Limits reset every hour\n\n---\n\n## Environment Variables\n\n- `TRUSTRAILS_API_KEY` - API key (use `mcp-public-2026` for shared public access)\n- `TRUSTRAILS_BASE_URL` - API endpoint (optional, defaults to `https://trustrails.app`)\n\n---\n\n## Why TrustRails?\n\n- ✅ **Real-time data** - Product feeds updated twice daily\n- ✅ **Multiple retailers** - Compare prices in one search\n- ✅ **Stock information** - See what's actually available to buy\n- ✅ **Direct purchase links** - Click through to buy immediately\n- ✅ **Zero setup** - Works out of the box with shared public key\n- ✅ **UK-focused** - Optimized for UK electronics shopping\n\n---\n\n## Troubleshooting\n\n**\"Command not found\" or server not starting**\n- Make sure Node.js is installed and `npx` is available: `npx --version`\n- Try running manually: `npx -y @trustrails/mcp-server`\n- **Using nvm?** Claude Desktop doesn't inherit your shell PATH. Use the full path to node instead:\n  ```json\n  {\n    \"command\": \"/Users/YOUR_USERNAME/.nvm/versions/node/vX.X.X/bin/node\",\n    \"args\": [\"/Users/YOUR_USERNAME/.nvm/versions/node/vX.X.X/lib/node_modules/@trustrails/mcp-server/dist/index.js\"]\n  }\n  ```\n  First run `npm install -g @trustrails/mcp-server`, then find your node path with `which node`.\n\n**\"Rate limit exceeded\"**\n- Wait an hour for limits to reset\n- Check `X-RateLimit-Reset` header for exact reset time\n- 50 requests/hour is plenty for normal usage\n\n**\"No results found\"**\n- Try broader search terms (e.g., \"laptop\" instead of specific model)\n- Check spelling of brand names\n- Try searching without filters first\n\n---\n\n## Development\n\n### Local Setup\n\n```bash\n# Clone the repo\ngit clone https://github.com/james-webdev/trustrails-mcp-server\ncd trustrails-mcp-server\n\n# Install dependencies\nnpm install\n\n# Run locally\nnpm run dev\n```\n\n### Testing\n\n```bash\n# Run the MCP inspector to test tools\nnpx @modelcontextprotocol/inspector npm run dev\n```\n\n---\n\n## Support & Links\n\n- **Website:** [trustrails.app](https://trustrails.app)\n- **Issues:** [GitHub Issues](https://github.com/james-webdev/trustrails-mcp-server/issues)\n- **NPM:** [@trustrails/mcp-server](https://www.npmjs.com/package/@trustrails/mcp-server)\n- **MCP Registry:** [modelcontextprotocol.io/servers](https://modelcontextprotocol.io/servers)\n\n---\n\n## License\n\nMIT © TrustRails\n\n---\n\n## About MCP\n\nThis server implements the [Model Context Protocol](https://modelcontextprotocol.io), a standard for connecting AI assistants to external tools and data sources. Learn more about building MCP servers at [modelcontextprotocol.io](https://modelcontextprotocol.io).\n",
  "bytes": 7383,
  "sha": "7f0703b35e97b896ab7cfd7105f17fb224ad2707018e2c2b4fb61b19dc9afc65",
  "repo_slug": "james-webdev/trustrails-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_app_trustrails_server_6cd14683/readme"
}