batch_compare
Compare up to 50 products side-by-side by their IDs. No authentication required.
create_cart
Create a new empty shopping cart. Requires authentication — call 'authenticate' with your sk_buy_* key first.
checkout
Checkout a cart. Creates orders, processes payments, and returns checkout status. Requires authentication — call 'authenticate' with your sk_buy_* key first.
get_listing_status
Get the current status and details of a listing. Requires merchant authentication — call 'authenticate' with your sk_sell_* key first.
signup_with_email
Create a new BopMarket account and authenticate this session in one step. Ideal for users who want to set up price alerts, carts, checkouts, or listings without visiting a website. Creates a merchant account + agent (buyer or seller), emails the user their login details, and activates the session. After this runs successfully, all auth-required tools for the chosen role will work.
agent_type='buyer' (default) -> sk_buy_* key, enables price watches / cart / checkout / orders.
agent_type='seller' -> sk_sell_* key, enables listings / approvals / seller dashboard.
get_order
Get detailed information about a specific order. Requires authentication — call 'authenticate' with your sk_buy_* key first.
create_listing
Create a new product listing on BopMarket. Requires merchant authentication — call 'authenticate' with your sk_sell_* key first. Listings enter moderation (auto-publish for trusted sellers, human review otherwise).
authenticate
Authenticate this MCP session with your BopMarket API key. Call this once before using cart, checkout, price watch, order, or listing tools. Read-only tools (search, get_product, batch_compare, get_categories) work without auth. Buyer keys: sk_buy_*. Seller keys: sk_sell_*.
list_webhooks
List all registered webhooks for the authenticated agent. Requires authentication — call 'authenticate' with your sk_buy_* key first.
list_listings
List all listings for the authenticated seller, optionally filtered by status. Requires merchant authentication — call 'authenticate' with your sk_sell_* key first.
list_orders
List orders for the authenticated agent, optionally filtered by status. Requires authentication — call 'authenticate' with your sk_buy_* key first.
delete_webhook
Delete a registered webhook by its ID. Requires authentication — call 'authenticate' with your sk_buy_* key first.
cancel_order
Cancel an order if it is still in a cancellable state (pending or confirmed). Requires authentication — call 'authenticate' with your sk_buy_* key first.
get_product
Get detailed information about a specific product by its ID. No authentication required.
register_webhook
Register a webhook to receive event notifications at an HTTPS callback URL. Requires authentication — call 'authenticate' with your sk_buy_* key first.
remove_from_cart
Remove an item from a cart by its item ID. Requires authentication — call 'authenticate' with your sk_buy_* key first.
create_price_watch
Create a price watch to be notified when a product drops below a target price. Requires authentication — call 'authenticate' with your sk_buy_* key first.
get_agent_info
Get information about the authenticated agent, including type, spending limits, approved categories, and configuration. Requires authentication — call 'authenticate' with your sk_buy_* key first.
update_listing
Update an existing listing's price, inventory, description, images, or tags. Requires merchant authentication — call 'authenticate' with your sk_sell_* key first.
list_price_watches
List all active price watches for the authenticated agent. Requires authentication — call 'authenticate' with your sk_buy_* key first.