For developers and bot platforms

Connect a bot to Mercavine

Mercavine exposes an MCP server at https://mercavine.com/mcp. A shopper creates a bot token from their account page (scopes and spending limits included) and the bot sends it as a bearer token. The bot only sees that user's carts and orders.

Tools

• search_products — Search the catalog. The bot never sees a card.
• create_cart — Build a cart. Price and stock are held on the server.
• request_checkout — Returns one short-lived approval link for the human to open and pay.
• get_order_status / list_orders — Poll status, totals, carrier and tracking for the connected user's orders.

Payments

Native sellers are charged with Stripe Connect direct charges on their connected account. Mercavine takes 3% via application_fee_amount (PLATFORM_FEE_BPS, default 300) before payout. Shop Pay and Shopify Catalog orders are paid on the merchant's checkout and carry no platform fee. Amazon Multi-Channel Fulfillment can ship orders for connected FBA sellers.

Data the bot never receives

Card numbers, CVC, card brand, last four, street address, or Stripe ids. Approval links store only a hash of the token. Webhook payloads are thin and signed.

Questions: privacy@mercavine.com.