# BopMarketplace

BopMarket MCP server gives AI agents full marketplace access: search products across 5 platforms, view details, manage carts, checkout with payments, track orders, create listings, monitor prices, an…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add bopmarket/marketplace

# Browse available tools
npx -y @smithery/cli@latest tool list bopmarket/marketplace

# Get full schema for a tool
npx -y @smithery/cli@latest tool get bopmarket/marketplace get_cart

# Call a tool
npx -y @smithery/cli@latest tool call bopmarket/marketplace get_cart '{}'
```

## Direct MCP Connection

Endpoint: `https://marketplace--bopmarket.run.tools`

## Tools (20)

- `get_cart` — View cart contents, item totals, and checkout_method per item.
- `get_categories` — Browse the full product category tree. No auth required.
- `add_to_cart` — Add a product to an existing cart. Validates product availability.
- `get_product_offers` — Get all cross-platform offers for a product. Shows the same product available from different platforms with prices.
- `search_products` — Search the product catalog. Returns canonical products with cross-platform offers where available.
- `delete_price_watch` — Delete a price watch by ID.
- `batch_compare` — Compare up to 50 products in a single request. Returns structured comparison data sorted by price.
- `create_cart` — Create a new empty cart. Returns cart_id for subsequent add/remove/checkout operations.
- `checkout` — Initiate checkout for a cart. Requires idempotency key to prevent duplicate purchases. Returns payment_intent for nativ…
- `get_order` — Get full details of a specific order including items, status, tracking, and fulfillment info.
- `list_webhooks` — List all active webhook subscriptions for the current agent.
- `list_orders` — List orders for the current agent with pagination and optional status filter.
- `delete_webhook` — Unsubscribe from webhook events by webhook ID.
- `cancel_order` — Request cancellation of an order. Only valid for orders in cancellable states (pending, confirmed).
- `get_product` — Get full details for a single product.
- `register_webhook` — Subscribe to platform events via webhook. Events are delivered as HTTP POST to your callback URL. Available events: ord…
- `remove_from_cart` — Remove an item from a cart.
- `create_price_watch` — Set a price alert on a product. Get notified via webhook when the price drops below your target.
- `get_agent_info` — View your agent's identity, spending limits, remaining daily/weekly budget, approved categories, and merchant rating mi…
- `list_price_watches` — List all active price watches for the current agent.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get bopmarket/marketplace <tool-name>
```

## Resources

- `bopmarket://about`
- `bopmarket://categories`

## Prompts (4)

- `shopping_assistant` — Start an interactive shopping session.
- `price_monitor` (product, targetPrice) — Set up price monitoring for a product.
- `market_research` (category) — Research products and pricing in a category.
- `find_best_deal` (product) — Find the best deal across all platforms for a product.