Metadata-Version: 2.4
Name: ecommerce-mcp-server
Version: 0.1.0
Summary: MCP server for e-commerce data: product search, barcode lookup, cart management, category browsing
Project-URL: Homepage, https://github.com/AiAgentKarl/ecommerce-mcp-server
Project-URL: Repository, https://github.com/AiAgentKarl/ecommerce-mcp-server
Author-email: AiAgentKarl <coach1916@gmail.com>
License: MIT
Keywords: ai-agents,barcode,cart,ecommerce,mcp,products,shopping
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: fastmcp>=0.4.0
Requires-Dist: httpx>=0.27.0
Description-Content-Type: text/markdown

# 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)
