Shopping

You run a Shopping MCP Server that bridges Amazon and Target shopping actions with AI assistants. It lets you search products, view details, manage carts, place orders, and retrieve order histories from both platforms, all through a unified MCP interface.

How to use

You interact with the Shopping MCP Server through an MCP client. The server exposes operations for product search, product details, cart management, and order retrieval. You can request Amazon product data, add items to an Amazon cart, place demo orders, and fetch Amazon or Target order histories filtered by year. Use the client’s commands to navigate between searching products, viewing details, and reviewing orders. The server is designed to respond quickly and reliably to your shopping-related queries and actions.

To get started, ensure your MCP client is connected to the Shopping MCP Server. The server supports two platforms: Amazon and Target. Use the Amazon-specific actions to search and inspect products, manage the cart, and place demo orders. Use the Target actions to fetch order histories. For fast data access, the server optimizes API interception to deliver results efficiently.

How to install

Install dependencies

npm install -D

Build the project

npm run build

The server is configured for local runtime via a standard Node.js command. You can point your MCP client to run the server using a local node process that executes the built entry file.

Additional sections

Claude Desktop Integration: You need to create or update a Claude desktop configuration file to register the Shopping MCP Server for quick access. The configuration should reference the built entry file that the MCP server provides after building.

{
  "mcpServers": {
    "shopping": {
      "command": "node",
      "args": ["/path/to/mcp-server-shopping/build/index.js"]
    }
  }
}

Restart the Claude Desktop app after updating the config so the Shopping MCP Server appears in the interface. You should now see the Amazon MCP server listed for use with Claude Desktop.

Troubleshooting: The MCP server writes its logs to a file. If you run into issues, check the log file for details.

Logs: You can locate the logs in these locations:

• Windows: %APPDATA%\Claude\logs\mcp-server-shopping.log
• Mac: ~/Library/Logs/Claude/mcp-server-shopping.log

Notes on installation and configuration

Prerequisites include having Node.js installed and the ability to run npm commands. The implementation uses npm to install dependencies and build the server, after which you run the server locally with Node.js.

Available tools

search_amazon

Search for products on Amazon using the Shopping MCP Server and return a list of matching items with basic details.

product_details_amazon

Retrieve detailed information for a specific Amazon product, including price, ratings, and availability.

cart_add_amazon

Add a specified item to your Amazon cart via the Shopping MCP Server.

cart_clear_amazon

Clear items from your Amazon cart to start fresh.

place_order_amazon

Place a (demo) order on Amazon through the Shopping MCP Server.

orders_amazon_history

Retrieve the Amazon orders history with optional year filtering and return status.

orders_target_history

Retrieve Target orders history (online and in-store) with optional year filtering.