Trader Joe's MCP Server
# @striderlabs/mcp-traderjoes
MCP (Model Context Protocol) connector for Trader Joe's grocery. Enables AI assistants to search products, look up nutrition info, and find store locations.
## Installation
```bash
npm install -g @striderlabs/mcp-traderjoes
```
## Usage
Add to your MCP client config (e.g. Claude Desktop `claude_desktop_config.json`):
```json
{
"mcpServers": {
"traderjoes": {
"command": "mcp-traderjoes"
}
}
}
```
## Tools
### `search_products`
Search for Trader Joe's products by keyword.
**Parameters:**
- `query` (required): Search term (e.g. "cauliflower", "frozen pizza", "wine")
- `page_size` (optional): Number of results (default: 10)
### `get_product_details`
Get detailed product info including ingredients, nutrition facts, and allergens.
**Parameters:**
- `sku` (required): Product SKU from search results
### `find_stores`
Find Trader Joe's locations near a ZIP code.
**Parameters:**
- `zip` (required): US ZIP code
- `radius` (optional): Search radius in miles (default: 25)
### `get_new_products`
List new and featured products currently available at Trader Joe's.
**Parameters:**
- `category` (optional): Category filter (e.g. "produce", "frozen", "snacks")
## Development
```bash
npm install
npm run build
```
## License
MIT
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: find_stores handles location queries, get_new_products lists featured items, get_product_details provides specifics for a known SKU, and search_products enables keyword-based product discovery. There is no overlap in functionality, making tool selection straightforward.
All tool names follow a consistent verb_noun pattern with snake_case (e.g., find_stores, get_new_products, get_product_details, search_products). The verbs (find, get, search) are appropriate and predictable, ensuring readability and uniformity across the set.
With 4 tools, the server is well-scoped for its domain of store and product information, but it feels slightly thin. While core functions are covered, additional tools like checking store inventory or product availability could enhance completeness without overloading.
The toolset covers key aspects of the Trader Joe's domain: store location lookup, product discovery, and detailed product information. Minor gaps exist, such as the inability to check product availability at specific stores or access broader categories, but agents can work effectively with the provided tools.