ecommerce-mcp-server

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

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

pip install ecommerce-mcp-server

Usage with Claude Desktop

Add to your claude_desktop_config.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