Tool catalog
Every tool the Ryde MCP server exposes, with the scope and entitlement each requires.
Generated from the operation registry, so a tool cannot appear here without a real operation behind it. "Confirmation" marks the tools that require a fresh quote the customer was shown, plus an idempotency key.
| Tool | Description | Scope | Ryde One | Confirmation | Status |
|---|---|---|---|---|---|
get_membership_status | Whether this customer holds an active Ryde One membership. Call it before offering to transact, so the agent can explain the requirement rather than hit a 403 mid-sentence. | profile.read | No | No | Beta |
search_restaurants | Find open restaurants, grocery stores and shops near a point. | food.read | No | No | Beta |
get_restaurant_menu | The public catalogue for one merchant. Cost, stock, barcodes and supplier ids are the merchant's own business and are never returned here. | food.read | No | No | Beta |
quote_food_order | Price a basket exactly as checkout would: items, fees, taxes, any member discount, and the total. Returns the quote_id place_food_order requires. | food.read | No | No | Beta |
place_food_order | Place the order the customer confirmed, from a quote_id they were shown. | food.order | Required | Required | Beta |
get_food_order | Live state of one order, including courier progress. Deliberately NOT membership-gated: an order that exists stays trackable whatever happens to the membership. | food.read | No | No | Beta |
list_food_orders | The customer's own order history, newest first. | food.read | No | No | Beta |
cancel_food_order | Cancel an order, where its current state still allows it. Never membership-gated — getting OUT of a transaction must not require an entitlement. | food.read | No | No | Beta |
search_ride_options | The vehicle tiers that can be requested, with each tier's base fare. | rides.read | No | No | Beta |
quote_ride | Road distance, driving time and the final fare per vehicle tier, tax included. Returns the quote_id request_ride requires. | rides.read | No | No | Beta |
request_ride | Request the ride the customer confirmed, from a quote_id they were shown. | rides.request | Required | Required | Beta |
get_ride | Live state of one ride: dispatch progress, the assigned driver and vehicle, and the pickup ETA. Never membership-gated — a ride in progress stays trackable. | rides.read | No | No | Beta |
list_rides | The customer's own ride history, newest first. | rides.read | No | No | Beta |
cancel_ride | Cancel a ride that has not started. Never membership-gated, for the same reason as cancelling an order. | rides.read | No | No | Beta |
quote_delivery | Price a courier run between two points. Runs the same pricing path the request does, so the quote is the charge. | delivery.read | No | No | Beta |
request_delivery | Dispatch a courier to move a package, from a quote_id the customer was shown. | delivery.request | Required | Required | Beta |
get_delivery | Live state of one delivery, including courier progress and proof of delivery once collected. | delivery.read | No | No | Beta |
check_coverage | Ask whether Ryde delivers to a postcode or a point, and at which service levels. | coverage.read | No | No | Beta |
quote_rates | Price one parcel to one address from your contracted rate card, per service level. Creates nothing. | coverage.read | No | No | Beta |
create_shipment | Hand Ryde one parcel to deliver. Returns its Ryde tracking number. | shipments.create | No | No | Beta |
create_shipments_batch | Hand Ryde a manifest of up to 500 parcels in one request. Every row reports created, duplicate or rejected with a reason. | shipments.create | No | No | Beta |
get_shipment | The current state of one parcel, with its scan history and proof of delivery once delivered. | shipments.read | No | No | Beta |
list_shipments | Your parcels, newest first, filterable by status and date. | shipments.read | No | No | Beta |
cancel_shipment | Cancel a parcel you have given Ryde, at any point before it is delivered or returned. | shipments.manage | No | No | Beta |
list_shipment_events | Every recorded event for one parcel, oldest first: where it was scanned, when, and why an attempt failed. | shipments.read | No | No | Beta |
list_hubs | The depots your parcels are collected from. | coverage.read | No | No | Beta |
search_service_providers | Find providers who travel to the customer, with their live availability. Availability is derived per request and is never cached by the client. | services.read | No | No | Beta |
get_provider_availability | Open appointment slots on a date, for a job of a given duration. A long job is only offered a start whose consecutive slots are all free. | services.read | No | No | Beta |
quote_service | Price a service booking before committing to a slot. | services.read | No | No | Beta |
book_service | Book a provider, optionally into a specific slot. Slot contention is settled by the platform: a losing booking is refused, never double-booked. | services.book | Required | Required | Beta |
get_service_booking | Live state of one booking, through arrival, start and completion. | services.read | No | No | Beta |
list_task_types | The task types this market can actually execute, with the evidence each one collects. Only types Ryde can staff are listed. | tasks.read | No | No | Beta |
quote_task | Price a task and confirm a qualified provider could be found for it before committing. | tasks.read | No | No | Beta |
create_task | Dispatch real-world work with structured requirements and evidence rules. | tasks.create | Required | Required | Beta |
get_task | Task state, the assigned provider, and the evidence collected so far. | tasks.read | No | No | Beta |
get_task_evidence | The evidence collected against a task: photos with their content hashes, capture GPS and device timestamps, and any checklist answers. | tasks.read | No | No | Beta |
cancel_task | Cancel a task that has not started. | tasks.read | No | No | Beta |
list_business_orders | List the store's orders, newest first. Filter by status or fulfillment, or ask only for active work. | orders.read | No | No | Beta |
get_business_order | Read one of the store's orders in full, including its line items and status history. | orders.read | No | No | Beta |
accept_business_order | Accept an incoming order. Refused with 402 if a card or wallet order has not been paid yet. | orders.manage | No | No | Beta |
reject_business_order | Reject an order. A paid order is refunded to the customer's Ryde wallet — or, when the store collected it on its own Stripe account, to the customer's card by the store — and any booked slot is released. | orders.manage | No | No | Beta |
start_business_order_prep | Mark an accepted order as being prepared, so the customer's tracking reflects the kitchen. | orders.manage | No | No | Beta |
mark_business_order_ready | Mark an order ready for collection. For a delivery order this is what dispatches a Ryde courier. | orders.manage | No | No | Beta |
complete_business_order | Complete a pickup or dine-in order. Refused with 409 while a table check is still open. | orders.manage | No | No | Beta |
list_catalog_items | List the store's catalogue items with their prices, modifiers and availability. | menu.read | No | No | Beta |
create_catalog_item | Create a catalogue item. It appears immediately in the store's POS and on its Ryde storefront. | menu.manage | No | No | Beta |
update_catalog_item | Update a catalogue item's name, description, price, category or modifier groups. | menu.manage | No | No | Beta |
set_catalog_item_availability | Take an item off sale or put it back on, without deleting it. The reversible way to 86 something. | menu.manage | No | No | Beta |
delete_catalog_item | Remove a catalogue item. There is no undo through the API — to take something off sale temporarily, set its availability instead. | menu.manage | No | No | Beta |
import_catalog_items | Create many catalogue items at once, with their categories. Creates only — it never reprices an existing item. | menu.manage | No | No | Beta |