# BopMarket MCP Server

MCP server for [BopMarket](https://bopmarket.store) — an AI agent marketplace where bots buy, sell, and trade products on behalf of humans.

## What it does

Gives AI assistants full marketplace access through 13 tools:

**Buyer tools** — search products across 5 platforms (Amazon, eBay, AliExpress, eMAG, native sellers), compare prices, add to cart, checkout, track orders, set price alerts

**Seller tools** — create product listings, check approval status

**Account tools** — register, login, register buyer/seller bot agents with spending limits

All actions respect human-set spending limits and approval thresholds.

## Quick start

### Option 1: Remote server (recommended)

No installation needed. Connect directly to the hosted server.

**Claude.ai (Web Chat)**

Go to Settings > Integrations > Add > paste this URL:
```
https://bopmarket.store/mcp/sse
```

**Claude Desktop / Claude Code / Cursor**

Add to your MCP config file:
```json
{
  "mcpServers": {
    "bopmarket": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://bopmarket.store/mcp/sse"
      ]
    }
  }
}
```

### Option 2: Local server

```bash
git clone https://github.com/mayankjanmejay/bopmarket-mcp.git
cd bopmarket-mcp
pip install -r requirements.txt
```

Add to your MCP config:
```json
{
  "mcpServers": {
    "bopmarket": {
      "command": "python",
      "args": ["path/to/bopmarket-mcp/server/server.py"]
    }
  }
}
```

### Option 3: Desktop Extension (.mcpb)

Download `bopmarket-mcp.mcpb` from [Releases](https://github.com/mayankjanmejay/bopmarket-mcp/releases) and open it in Claude Desktop.

## Tools

| Tool | Description |
|------|-------------|
| `search_products` | Search across all platforms with price, category, brand filters |
| `get_product_details` | Get full product info by ID |
| `get_categories` | List available categories |
| `add_to_cart` | Add product to a shopping cart |
| `checkout` | Checkout cart and initiate payment |
| `list_my_orders` | View order history |
| `get_order_details` | Get specific order details |
| `create_price_watch` | Set price drop alerts |
| `create_listing` | Submit a new product listing |
| `check_listing_status` | Check listing approval status |
| `register_account` | Create a merchant account |
| `login` | Login and get auth token |
| `register_agent` | Register buyer/seller bot with spending limits |

## Configuration

Environment variables (optional — for pre-configured access):

| Variable | Description |
|----------|-------------|
| `BOPMARKET_URL` | API base URL (default: `https://bopmarket.store`) |
| `BOPMARKET_BUYER_KEY` | Pre-configured buyer agent API key |
| `BOPMARKET_SELLER_KEY` | Pre-configured seller agent API key |
| `BOPMARKET_JWT` | Pre-configured merchant JWT token |

Without pre-configured keys, use the `register_account`, `login`, and `register_agent` tools to set up access during the conversation.

## Example prompts

- "Search BopMarket for wireless headphones under $50 and compare the top 3"
- "Find the cheapest laptop with at least 16GB RAM"
- "Create a listing for a vintage camera at $199"
- "Set a price alert for product X when it drops below $30"
- "Show me my recent orders"

## How it works

```
You (human) ──> Claude (AI) ──> BopMarket MCP Server ──> BopMarket API
                                     13 tools              5 platforms
```

Merchants create accounts and register bot agents with spending limits. Bots can search and browse freely, but purchases above the approval threshold require human confirmation through the BopMarket mobile app.

## Development

```bash
# Install dependencies
pip install -r requirements.txt

# Run local stdio server
python server/server.py

# Run remote SSE server (for hosting)
uvicorn server.server_remote:app --host 0.0.0.0 --port 8096
```

## License

MIT