MCP tools
Tools overview
The tools a buyer's assistant uses over MCP, grouped by what they do.
XEKTA is one remote MCP server. Once it is connected, an assistant can search nearby shops, build a cart, ask the buyer to approve it, place the order and follow it until it is collected.
#Endpoint
https://mcp.xekta.com/mcpStreamable HTTP, signed in with OAuth. See Connect a client.
#Tool groups
product_search, price_compare, substitution_suggest.CartBuild and edit a cart at one shop: cart_build, cart_create, cart_add, cart_set_quantity, cart_set_shipping, cart_get.Approve and orderAsk the buyer, then place the order: checkout_prepare, cart_approve, checkout_create.After the orderFollow, change and close an order: user.orders.status, user.order.confirm_partial, user.order.cancel, user_pickup_confirm, user.delivery.confirm, user.delivery.contest.AccountCard setup and feedback: user.payment_method.setup, feedback_submit.#Every tool
| Tool | What it does | Type |
|---|---|---|
product_search | Search the catalogs of approved shops for products, dishes or whole menus. | Read |
price_compare | Compare the price of one product across shops, cheapest first. | Read |
substitution_suggest | Suggest alternatives for an item that is unavailable. | Read |
cart_build | Turn a shopping list in plain words into a cart at one shop. | Write |
cart_create | Open an empty cart at one shop. | Write |
cart_add | Add one item to an open cart. | Write |
cart_set_quantity | Lower the quantity of a cart line or remove it. | Write |
cart_set_shipping | Set the delivery address and shipping option for a cart from a shop that ships. | Write |
cart_get | Read a cart back with its items, frozen prices and total. | Read |
checkout_prepare | Preview the total, tax and pickup details without placing an order. | Read |
cart_approve | Ask the buyer to approve the cart at its current total. | Write |
checkout_create | Place the order for a cart the buyer has approved. | Write |
user.orders.status | Report what changed in the buyer's orders and where each open order is. | Read |
user.order.confirm_partial | Record the buyer's decision when a shop can fill only part of an order. | Write |
user.order.cancel | Cancel the buyer's own order while the shop has not started preparing it. | Write |
user_pickup_confirm | Record the buyer's own word about an order that is ready for pickup. | Write |
user.delivery.confirm | Confirm the buyer received what they ordered. | Write |
user.delivery.contest | Report a problem with a collected order, such as wrong or missing items. | Write |
user.payment_method.setup | Check whether a card is on file, and get the link to add or replace one. | Write |
feedback_submit | Tell XEKTA that a tool or an error message was wrong or unhelpful. | Write |
#Read and write
"Read" tools only look things up. "Write" tools change a cart or an order. Only checkout_create creates an order, and it refuses any cart the buyer has not approved.
#Who is asking
No tool takes a user_id. The signed-in session decides who the buyer is, and an assistant can reach only that buyer's own carts and orders.
#Tool names
Some clients show the dots in a tool name as underscores, for example user_orders_status for user.orders.status. It is the same tool.
#Tools that are not for assistants
| Tool | Who calls it |
|---|---|
cart_approve_confirm | The confirmation box itself, when the buyer answers. |
cart_confirm | Only assistants such as Meta Muse and device-link connections, with the 4-digit code the buyer received by text. See Approval. |
merchant.* | Switched off. Shops use the web account, Telegram or WhatsApp. |