# ecommerce-mcp-server

MCP server for e-commerce data — product search, barcode lookup, cart & wishlist management for AI agents.

[![PyPI](https://img.shields.io/pypi/v/ecommerce-mcp-server)](https://pypi.org/project/ecommerce-mcp-server/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Features

- **Product Search** — Search 100+ products by keyword via DummyJSON (free, no API key)
- **Category Browsing** — List and filter products by category
- **Barcode Lookup** — Look up products by UPC/EAN barcode via UPCitemdb (free, 100 req/day)
- **Cart Management** — Add, remove, view, and clear a local shopping cart
- **Wishlist** — Save and manage a local wishlist
- **Shopping Summary** — Unified overview of cart and wishlist with totals

## Tools

| Tool | Description |
|------|-------------|
| `search_products` | Search products by keyword (e.g. "laptop", "shoes") |
| `get_product_details` | Get full details for a product by ID |
| `list_categories` | List all available product categories |
| `get_products_by_category` | Get products filtered by category |
| `lookup_by_barcode` | Look up a product by UPC or EAN barcode |
| `manage_cart` | Add/remove/view/clear shopping cart (local) |
| `manage_wishlist` | Add/remove/view wishlist (local) |
| `get_shopping_summary` | Overview of cart + wishlist with totals |

## Installation

```bash
pip install ecommerce-mcp-server
```

## Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "ecommerce": {
      "command": "ecommerce-mcp-server"
    }
  }
}
```

## Example Queries

- "Search for laptops under $800"
- "What categories are available?"
- "Look up barcode 4006381333931"
- "Add product 1 to my cart"
- "Show my shopping cart"
- "Add product 5 to my wishlist"

## APIs Used

- **DummyJSON** (dummyjson.com) — Free product catalog, no API key required
- **UPCitemdb** (upcitemdb.com) — Barcode lookup, free trial (100 req/day), no key needed

## Local Storage

Cart and wishlist are stored locally at `~/.ecommerce_mcp_store.json`.

## License

MIT — Built by [AiAgentKarl](https://github.com/AiAgentKarl)