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
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)
| File | Size | Uploaded | |
|---|---|---|---|
| ecommerce_mcp_server-0.1.0.tar.gz | 5.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|