Skip to main content

ecommerce-mcp-server

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

PyPI License: 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

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

Metadata

Release files for ecommerce-mcp-server 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ecommerce-mcp-server 0.1.0
File Size Uploaded
ecommerce_mcp_server-0.1.0.tar.gz 5.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ecommerce-mcp-server 0.1.0
File Interpreter ABI Platform
ecommerce_mcp_server-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 13.3 kB

Release files / ecommerce_mcp_server-0.1.0.tar.gz

Download URL ecommerce_mcp_server-0.1.0.tar.gz
Size 5.6 kB
Tags Source
SHA-256 checksum
How to use checksums
66ac2e3739533032b201cee659087e81d224e11eaec5f22861dd7ae1bd2ebb49
BLAKE2b-256 checksum
How to use checksums
c53a339ad47809fa7b4b02c0fbf97eab970a52b6cc158674cdcaa238070c9153
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release files / ecommerce_mcp_server-0.1.0-py3-none-any.whl

Download URL ecommerce_mcp_server-0.1.0-py3-none-any.whl
Size 7.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e0f2c976a6810c88a07e82c351742ad4ae43586eb28c334d5234ffd6a9127526
BLAKE2b-256 checksum
How to use checksums
25067d5e742006abf8b4283340ed8d4a8a5d748d4ee20f88689083eae17b89e8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page