# Open Shopping Agent

> Open Shopping Agent is an open-source MCP server for e-commerce. Open-source MCP server that compares shopping offers across major stores and fills carts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Self-hosted, API, Web, macOS, Windows, Linux
- **Repository:** https://github.com/browsa-io/open-shopping-agent
- **MCP Registry name:** io.browsa/open-shopping-agent
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-19

## About

The README says it searches Amazon, Walmart, eBay, Best Buy, Target and any Shopify store in one request, then compares delivered totals, shipping, delivery dates and sellers side by side. It can fill carts at each store and read them back to check the result.

As an MCP server, it exposes tools such as find_and_compare, fill_carts, review_checkout and place_order to an AI assistant. Placing orders is off by default and must be switched on through the server's environment, and even then each order needs approval of the exact total shown in the chat. Browsing can run in your own Chrome or on Browsa cloud browsers with an optional API key.

The project is aimed at people who want an assistant to do price comparison and cart preparation while keeping checkout under their own control. The README is candid that real end-to-end purchases have not yet been tested.

## Features

- **Multi-store search:** Searches several retailers and any Shopify store at once from a single plain-language request.
- **Real total comparison:** Compares price, shipping, delivery date, rating and seller to rank offers by delivered cost.
- **Cart filling and read-back:** Adds items to carts at each store and reads the cart back to verify contents.
- **Approval before purchase:** Stops at the order review page and places orders only after approval of the exact total.
- **Price and stock watches:** Sets target-price or back-in-stock alerts with terminal, email, Slack or webhook output.

## Good for

- Comparing the delivered price of a product across several online stores
- Letting an AI assistant prepare carts while you approve the final checkout
- Setting a price alert for an item you want to buy later
- Checking which stores have an item in stock and at what total

## Install

### Claude Code (Terminal)

```sh
claude mcp add open-shopping-agent --env BROWSA_API_KEY='<BROWSA_API_KEY>' -- npx -y open-shopping-agent
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "open-shopping-agent": {
      "command": "npx",
      "args": [
        "-y",
        "open-shopping-agent"
      ],
      "env": {
        "BROWSA_API_KEY": "<BROWSA_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "open-shopping-agent": {
      "command": "npx",
      "args": [
        "-y",
        "open-shopping-agent"
      ],
      "env": {
        "BROWSA_API_KEY": "<BROWSA_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "open-shopping-agent": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "open-shopping-agent"
      ],
      "env": {
        "BROWSA_API_KEY": "<BROWSA_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "open-shopping-agent": {
      "command": "npx",
      "args": [
        "-y",
        "open-shopping-agent"
      ],
      "env": {
        "BROWSA_API_KEY": "<BROWSA_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "open-shopping-agent": {
      "command": "npx",
      "args": [
        "-y",
        "open-shopping-agent"
      ],
      "env": {
        "BROWSA_API_KEY": "<BROWSA_API_KEY>"
      }
    }
  }
}
```

## Tools

- `find_and_compare`: Searches stores and compares offers.
- `fill_carts`: Fills carts at stores, with a dry-run option.
- `review_checkout`: Reviews checkout without placing an order.
- `place_order`: Places an order only when enabled and approved.
- `watch_price`: Sets a price or stock watch.
- `list_runs`: Lists past runs.
- `list_orders`: Lists placed orders.

## FAQ

### Does Open Shopping Agent place orders by default?

No. Over MCP it does not place orders unless OSA_MCP_ALLOW_ORDERS is set to 1 in the server's environment, and each order then needs approval of the exact total.

### Do I need a Browsa account?

No. Without a key it uses your own Chrome or Edge. A Browsa API key is optional and enables cloud browsers.

### Which stores are supported?

Amazon, Walmart, eBay, Best Buy, Target and any Shopify store, in the US for now, according to the README.

### What does the MCP server need to run?

The README gives the install as npx -y open-shopping-agent mcp, with Node 20 or later.

### Is Open Shopping Agent free?

Yes. Open Shopping Agent is open source, so you can use and self-host it for free.

### How do I add Open Shopping Agent to Claude Code?

Run this command in your terminal: claude mcp add open-shopping-agent --env BROWSA_API_KEY='<BROWSA_API_KEY>' -- npx -y open-shopping-agent

### What are the best alternatives to Open Shopping Agent?

The closest alternatives to Open Shopping Agent are CartScout, Shopify Store Intel, Klack Europe Shopping, Clishop and AgentDiet Shopify & DTC E-Commerce Store Competitive Intelligence.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [CartScout](https://ai-powered.com/mcp/cartscout): CartScout is a freemium MCP server for e-commerce.
- [Shopify Store Intel](https://ai-powered.com/mcp/shopify-store-intel): Shopify Store Intel is a paid MCP server for e-commerce.
- [Klack Europe Shopping](https://ai-powered.com/mcp/klack-europe-shopping): Klack Europe Shopping is an MCP server for e-commerce.
- [Clishop](https://ai-powered.com/mcp/clishop): Clishop is an open-source MCP server for e-commerce.
- [AgentDiet Shopify & DTC E-Commerce Store Competitive Intelligence](https://ai-powered.com/mcp/agentdiet-shopify-and-dtc-e-commerce-store-competitive-intel): AgentDiet Shopify & DTC E-Commerce Store Competitive Intelligence is a paid MCP server for e-commerce.
- [Commerce](https://ai-powered.com/mcp/commerce): Commerce is a free MCP server for e-commerce.
- [ShopSavvy](https://ai-powered.com/mcp/shopsavvy): ShopSavvy is a freemium MCP server for e-commerce.
- [WebMCP Demo Store](https://ai-powered.com/mcp/webmcp-demo-store): WebMCP Demo Store is an open-source MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/open-shopping-agent
