Skip to main content
Glama
ecommerce-mcp-server

ecommerce-mcp-server

by AiAgentKarl

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

Related MCP server: Shopping MCP Server (Amazon + Target)

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

Available Tools

8 tools
get_product_detailsB

Details zu einem bestimmten Produkt abrufen.

Inputs: product_id (required). Returns: object

get_products_by_categoryB

Produkte einer Kategorie abrufen.

Inputs: category (required), limit. Returns: object

get_shopping_summaryA

Gesamtuebersicht: Warenkorb und Wunschliste zusammengefasst. Zeigt Gesamtkosten, Anzahl Artikel und Spar-Tipps.

Inputs: no named parameters. Returns: object

list_categoriesA

Alle verfuegbaren Produktkategorien auflisten.

Inputs: no named parameters. Returns: object

lookup_by_barcodeB

Produkt per UPC/EAN-Barcode nachschlagen (UPCitemdb, kostenlos).

Inputs: upc_code (required). Returns: object

manage_cartB

Einkaufswagen verwalten (hinzufuegen, entfernen, anzeigen, leeren).

Inputs: action (required), product_id, quantity, product_title, +1 more. Returns: object

manage_wishlistC

Wunschliste verwalten (hinzufuegen, entfernen, anzeigen).

Inputs: action (required), product_id, product_title, price. Returns: object

search_productsC

Produkte nach Suchbegriff durchsuchen.

Inputs: query (required), limit. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: product details, category browsing, barcode lookup, cart and wishlist management, search, and a combined summary. No two tools perform the same function.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., get_product_details, manage_cart) using underscores. Verbs are descriptive and nouns are specific, with no mixing of conventions.

    Tool Count5/5

    8 tools is well-scoped for an e-commerce assistant. It covers product discovery, cart and wishlist operations, and a summary without being overwhelming or too sparse.

    Completeness4/5

    Core functions (browse, search, cart, wishlist, summary) are covered. Missing checkout or order management, but the tool set seems intentionally focused on pre-purchase activities, so only minor gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers