Skip to content
MCP server

Open Shopping Agent

Open-source MCP server that compares shopping offers across major stores and fills carts

Runs locally
Install

Open Shopping Agent is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
CLI, Self-hosted, API
Runs
Locally
Version
0.2.0
Listing updated

Similar MCP servers

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • BROWSA_API_KEYOptional. Run the store browsers on Browsa cloud browsers instead of your own Chrome.
  • OSA_MCP_ALLOW_ORDERSOptional. Set to 1 to let place_order place orders you approve in the chat. Off by default.

About Open Shopping Agent

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.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free and MIT-licensed; optional Browsa cloud browsers use credits, with a free key including 100 credits.

Open Shopping Agent 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.

How AIPoweredBot checks servers