###### Version française [ici](https://github.com/johan-perso/mcp-shop-server/blob/main/README.fr.md).

# MCP Shop Server

An MCP server to help you shop online by letting your AI model find the best deals for you. It can browse multiple compatible websites across multiple regions using [Playwright](https://playwright.dev/) to interact with them.

<img width="1390" height="969" alt="image" src="https://github.com/user-attachments/assets/46d5ae39-6a44-48a2-bdfb-d75851af1600" />


## Compatible websites

- [Amazon.com](https://www.amazon.com/), [Amazon.fr](https://www.amazon.fr/), [Amazon.de](https://www.amazon.de/), [Amazon.co.uk](https://www.amazon.co.uk/), [Amazon.it](https://www.amazon.it/), [Amazon.es](https://www.amazon.es/), [Amazon.com.be](https://www.amazon.com.be/)
- [eBay.com](https://www.ebay.com/), [eBay.fr](https://www.ebay.fr/)
- [Dealabs](https://dealabs.com/), [hotukdeals](https://hotukdeals.com), [Chollometro](https://chollometro.com), [mydealz](https://mydealz.de/), [pepper.pl](https://pepper.pl/), [pepper.it](https://pepper.it/), [Pepperdeals (US)](https://www.pepperdeals.com/)

## Configuration

You can use this standard configuration example that should work for most MCP clients:

```json
{
  "mcpServers": {
	"mcp-shop-server": {
	  "command": "npx",
	  "args": [
		"mcp-shop-server@latest"
	  ]
	}
  }
}
```

## Development

```bash
git clone https://github.com/johan-perso/mcp-shop-server
cd mcp-shop-server

npm install
npx @modelcontextprotocol/inspector node index.js
```

## License

MIT © [Johan](https://johanstick.fr/). [Support this project](https://johanstick.fr/#donate) if you want to help me 💙