Rhine Docs buy-on-rhine.com

Tool reference

The Rhine MCP server offers 18 tools. Each one checks the agent's connection and permission on every call. Prices are in euros, ids come from earlier tool results.

Legend: read tools change nothing and are marked read-only. write tools change your cart or orders; those that cannot be undone are marked destructive, so assistants ask before running them.

Find products

ToolWhat it doesPermissionKind
search_productsSearches all sellers. Every word must match name, brand, tags or description. Filters: category, price range, in stock only; sort by relevance, price or newest; pages of results; optional small preview photos.Searchread
get_productFull details of one product: description, material, fit notes, specs, sizes, colours, stock, delivery time, return policy and up to 3 photos.Searchread
show_productShows a product to you in the chat with large photos, price, delivery, sizes, colours and an add-to-cart button, in assistants that display MCP Apps.Searchread
list_categoriesThe product categories on Rhine, for filtering.Searchread
get_seller_infoWhat a seller tells agents: published knowledge base articles (sizing, care, shipping, returns) and active offers.Searchread

Your profile and permissions

ToolWhat it doesPermissionKind
get_my_permissionsWhat you allowed the agent: permissions, limit per purchase, monthly limit, what it spent this month and when purchases need your approval.anyread
get_shopping_profileYour saved delivery addresses (id, label, city, country) and preferences (shoe size, clothing size, things to avoid, delivery notes). Street and house number are not shared.Buyread

Cart

ToolWhat it doesPermissionKind
get_cartYour cart with current prices, availability, shipping per shop and the total.Buyread
add_to_cartAdds one product (quantity 1 to 20, size and colour if the product has them). Mode increment adds to an existing line, set replaces its quantity.Buywrite
add_items_to_cartAdds several products in one step, all or none.Buywrite
update_cart_itemSets the quantity of one cart line.Buywrite
remove_from_cartRemoves one line from the cart.Buywrite, destructive

Checkout and orders

ToolWhat it doesPermissionKind
checkoutBuys the whole cart to one of your addresses. Within your limits the orders are placed (one per seller); otherwise it returns an approval link or a refusal, see Permissions and limits. With expectedTotal it refuses if the total changed.Buywrite, destructive
get_checkout_statusWhether a checkout waiting for approval was approved, declined or expired.Buyread
list_ordersYour orders, newest first.Buyread
get_orderOne order with its lines and status, by id or order number like RH-7KQ4M2XP.Buyread
cancel_orderCancels an order that has not shipped yet.Start returnswrite, destructive
request_returnStarts a return for a delivered order within 30 days. Reason: too-small, too-large, not-as-described, damaged, late or changed-mind; resolution: refund or exchange; method: drop-off or pickup.Start returnswrite, destructive

Resources

ui://rhine/shop is the product view used by show_product, an MCP App (HTML) that assistants render in the chat. It loads product photos from buy-on-rhine.com only.

Errors

Tools answer with a short message the agent can act on, for example that a product is out of stock, a size is missing, a permission is not granted or an order has already shipped. Nothing is changed when a tool fails.