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
| Tool | What it does | Permission | Kind |
|---|---|---|---|
search_products | Searches 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. | Search | read |
get_product | Full details of one product: description, material, fit notes, specs, sizes, colours, stock, delivery time, return policy and up to 3 photos. | Search | read |
show_product | Shows 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. | Search | read |
list_categories | The product categories on Rhine, for filtering. | Search | read |
get_seller_info | What a seller tells agents: published knowledge base articles (sizing, care, shipping, returns) and active offers. | Search | read |
Your profile and permissions
| Tool | What it does | Permission | Kind |
|---|---|---|---|
get_my_permissions | What you allowed the agent: permissions, limit per purchase, monthly limit, what it spent this month and when purchases need your approval. | any | read |
get_shopping_profile | Your 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. | Buy | read |
Cart
| Tool | What it does | Permission | Kind |
|---|---|---|---|
get_cart | Your cart with current prices, availability, shipping per shop and the total. | Buy | read |
add_to_cart | Adds 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. | Buy | write |
add_items_to_cart | Adds several products in one step, all or none. | Buy | write |
update_cart_item | Sets the quantity of one cart line. | Buy | write |
remove_from_cart | Removes one line from the cart. | Buy | write, destructive |
Checkout and orders
| Tool | What it does | Permission | Kind |
|---|---|---|---|
checkout | Buys 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. | Buy | write, destructive |
get_checkout_status | Whether a checkout waiting for approval was approved, declined or expired. | Buy | read |
list_orders | Your orders, newest first. | Buy | read |
get_order | One order with its lines and status, by id or order number like RH-7KQ4M2XP. | Buy | read |
cancel_order | Cancels an order that has not shipped yet. | Start returns | write, destructive |
request_return | Starts 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 returns | write, 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.