{
  "mcpServers": {
    "traderjoes": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-traderjoes"]
    }
  }
}

Available Tools

traderjoes.search_products

Search Trader Joe's product catalog.

Input Schema:

{
  "query": "string",
  "category": "frozen | fresh | snacks | beverages | wine | dairy (optional)",
  "dietary": ["vegan", "gluten-free", "organic"]
}

Output:

{
  "products": [{
    "sku": "tj123456",
    "name": "Everything But the Bagel Seasoning",
    "price": 2.49,
    "category": "pantry",
    "seasonal": false,
    "rating": 4.9,
    "description": "Sesame, poppy, and garlic seasoning blend"
  }]
}

traderjoes.find_stores

Find nearby Trader Joe's locations.

Input Schema:

{
  "address": "string",
  "radius_miles": "number (optional)"
}

traderjoes.get_product_details

Get detailed product info.

Input Schema:

{
  "sku": "string"
}

traderjoes.get_seasonal_items

List current seasonal and limited items.

traderjoes.check_store_inventory

Check if product is in stock at a store.

Input Schema:

{
  "sku": "string",
  "store_id": "string"
}

Authentication

First use triggers OAuth authorization:

User logs in with Trader Joe's account
Tokens stored encrypted per-user
Favorites synced automatically

No API key required — connector manages OAuth flow.

Usage Examples

Search products:

Find vegan snacks at Trader Joe's

Seasonal items:

What seasonal items does Trader Joe's have right now?

Check inventory:

Is the Everything Bagel Seasoning in stock at my local TJ's?

Find stores:

Where's the nearest Trader Joe's?

Error Handling

Code	Meaning	Action
AUTH_EXPIRED	Session expired	Re-authenticate
PRODUCT_NOT_FOUND	Item doesn't exist	Search again
STORE_NOT_FOUND	Invalid store ID	Find stores first
SEASONAL_ENDED	Item no longer available	Check next season

Use Cases

Product search: find TJ's specialty items
Seasonal hunting: track limited-time products
Shopping planning: check inventory before visiting
Store locator: find nearby locations and hours
Dietary filtering: find vegan, GF, or organic options

Available Tools

traderjoes.search_products

traderjoes.find_stores

traderjoes.get_product_details

traderjoes.get_seasonal_items

traderjoes.check_store_inventory

Authentication

Usage Examples

Error Handling

Use Cases

Links

strider-traderjoes

Strider Trader Joe's Connector

Installation

MCP Configuration