MCP Tools
How do agents interact with stores? Tools are discovered via MCP tools/list and define the operations an agent can invoke. Looking for UCP Checker's own MCP server — the one that finds and shops these stores for you? That's in the API & MCP docs.
Tools are the agent-facing API surface of the Universal Commerce Protocol. Each tool maps to one or more capabilities and is delivered over a transport like MCP. When an agent connects to a store's MCP endpoint, it calls tools/list to discover available operations — from catalog search to cart management to checkout.
search-catalog
Search for products on any UCP-enabled Shopify store. Searches the store's live product cat...
lookup_catalog
Retrieve catalog products by identifier (batch lookup by product or variant IDs). Returns full produ...
get_product
Retrieve a single product by ID with full detail. Supports compound variant IDs (productId:variantId...
create_checkout
Start a new checkout session. Returns a session object with an "id" field — store this ID and use up...
update_checkout
Update an existing checkout session. Pass only the items you want to add or change — they are MERGED...
complete_checkout
Finalize checkout and create WooCommerce order with payment credentials
cancel_checkout
Cancel a checkout session
get_checkout
Get the current state of an existing checkout session. Use this to check totals, prices, messages, o...
create_cart
Create a new cart (checkout session). Returns the full cart state including the checkout_session_id...
update_cart
Perform updates to a cart, including adding/removing/updating line items, buyer information, shippin...
get_cart
Get the cart including items, shipping options, discount info, and checkout url for a given cart id
cancel_cart
Cancel and discard a cart session.
get_order
Retrieve order details
catalog_lookup
Alias for lookup_catalog.
catalog_search
Alias for search_catalog.
get_product_details
Look up a product by ID and optionally specify variant options to select a specific variant.
list-categories
List all available store categories with store counts. Use to discover what kinds of stores...
check-domain
Check if a domain supports Universal Commerce Protocol (UCP). Returns the UCP status, manif...
discover-store
Discover available shopping tools on a UCP-enabled store. Connects to the store's MCP endpo...
list-stores
List verified UCP stores, optionally filtered by category and minimum score. Use when the u...
search-all
Search for products across all verified UCP stores at once. Fans out the query to multiple...
search-policies
Search store policies on any UCP-enabled Shopify store. Query return policies, shipping pol...
search_shop_catalog
Search for products from the online store, hosted on Shopify. This tool can be used to search for p...
add-to-cart
Add a product to cart on any UCP-enabled Shopify store and get a checkout URL. Requires a v...
get_categories
List all menu categories (e.g., APPETIZERS, SOUPS, ENTREES, SALADS) with their sort order and descri...
get_modifier_groups
List all available modifier groups for menu customization. Shows what types of customizations are av...
get_modifier_options
Get all available options for a specific modifier group (e.g., Spice Levels: Mild/Medium/Hot, Extras...
list_all_items
Get the complete menu with all items including images, prices, descriptions, and categories. Returns...
lookup_locations
Look up the property as a location: address, geo, hours, amenities.
search_products
Search products in an Artos store. Returns a list of variants with their variantId and price — use t...
track_order
Track order by order id, order number, or cart id in this Virto Commerce storefront.
cancel_booking
Store extension: cancel a confirmed booking with its cancellation policy applied (free before the de...
cancel_booking_session
Cancel a booking session before it is completed.
caty_affiliate_catalog
Search a verified product index for Romania: 1.7M+ products from 45+ vetted merchant stores, with re...
caty_render_product_cards
Search products matching the user query and render them as an interactive carousel in the chat widge...
checkout_and_handoff
Create checkout and immediately create a hosted checkout handoff URL. For physical goods, do not cal...
complete_booking_session
Confirm the reservation under the selected payment term. The session must be ready_for_complete. Ask...
create_booking_session
Create a booking session for a room at the property. Returns prices (totals), payment terms (pay now...
find_venues
List this brand’s venues, optionally filtered by name, town or postcode. Call it first: every other...
get_available_fulfillment
Get how this venue can be ordered from (delivery, collection or in-store), the minimum spend for eac...
get_available_slots
Get the delivery or collection time slots this venue still has for a given day. Slots run out, so qu...
get_booking
Retrieve booking status and details including all carrier booking references.
get_booking_session
Get the current state of a booking session; prices and the cancellation policy reflect now.
get_item
Get one item in full: description, price, dietary tags, the allergens it contains and may contain (n...
get_menu
Get this venue's menu. With no arguments it returns every category with all of its items — name, pri...
get_payment_handlers
Get payment handlers for a checkout in this Virto Commerce storefront.
get_store_capabilities
Discover UCP capabilities for this Virto Commerce storefront.
get_venue_info
Get the venue itself: name, address, phone number, website, description, whether it is open right no...
handoff_checkout
Create a hosted checkout handoff URL. For physical goods, do not call until shipping_address.first_n...
list_carts
List buyer-scoped carts in this Virto Commerce storefront. An explicit buyer_id is required; global...
list_countries
List or search countries in this Virto Commerce storefront.
list_orders
List closed orders. Returns {orders[], pagination: {has_next_page, cursor, total_count}}. Default pe...
list_regions
List regions for a country in this Virto Commerce storefront.
remove_cart_item
Remove a line item (and its children) from a cart by item id. Returns the updated cart state.
resolve_country
Resolve country text to a Virto Commerce platform country id in this storefront.
search_menu
Search this menu by dish name, category or description — the way a customer would ask for it ("hallo...
search_properties
NOT part of UCP (lodging discovery is out of scope of dev.ucp.lodging.booking). Lists this property'...
ucp_get_product
Get full details for a product, including variations and stock levels. Pass the "id" value exactly a...
ucp_list_products
Search and browse the product catalog. ALWAYS include a search term when the user names a product, b...
update_booking_session
Replace a booking session's request: room, dates, occupancy, booker, guests, chosen payment term. Ac...
apply_discount
Apply a discount/coupon code to a checkout session.
apply_voucher
Apply a voucher code to a cart. The voucher value is in öre (e.g. 10000 = 100 kr). Returns the updat...
cart_update
Alias for update_cart (full replacement): sets the cart to exactly the provided line_items, creating...
catalog_slice
A chosen slice of the catalogue for writing about: filter by category, brand, price band (USD) and m...
check_availability
Returns Hugo Catarino's available 1-hour slots for the given inclusive date range. Dates are ISO yyy...
clear_cart
Remove all items and vouchers from a cart, resetting it to an empty state. The cart id, user id, and...
convert_cart
Convert an existing cart into a checkout session. Preserves all cart-level state including discounts...
create_booking
Create appointment booking. [model-only guidance] Free 1-hour session with Hugo Catarino; the user m...
find_pickup_points
Find parcel pickup points near a Greek postal code: ACS Smartpoint lockers/shops and BOX NOW lockers...
get_api_endpoint_schema
Get the schema for an endpoint in the Telnyx TypeScript API. You can use the schema returned by this...
get_cart_items
List all items in a cart with their SKU, name, quantity, unit price, total price, stock, tax rate, m...
get_cart_promotions
Get all applied and pending promotions on a cart, including discount amounts and progress nudges (e....
get_cart_totals
Get price breakdown for a cart: total incVat, total exVat, VAT breakdown by rate, total discount (vo...
get_cart_vouchers
List all vouchers applied to a cart with their codes, values, rules, and whether they are currently...
get_checkout_link
Get the URL where the shopper completes checkout in their browser — reviewing the cart, choosing del...
get_company_info
Return canonical public information about Dellasale.
get_compatible_parts
Find the replacement parts (domes, wax filters, wireless accessories, chargers) that fit a hearing-a...
get_context
Returns the current server UTC time. Call this at the start of a session to establish an accurate ti...
get_deal
One deal by id, in the same shape search_deals returns. Use it to re-check a price before recommendi...
get_payment_methods
Payment methods this store accepts (e.g. card via Viva/Stripe, cash on delivery), with any extra cos...
get_price_history
Is this a good price? One deal with what its price has done, from Fazy's own price record: the lowes...
get_product_reviews
Customer reviews for a product: overall rating and recent verified-purchase comments.
get_shipping_options
Available delivery methods for a destination country with prices and free-shipping thresholds. Kinds...
get_shipping_profile
Recupera l'indirizzo di spedizione salvato del cliente identificato (identity_linking), da chiamare...
get_store_info
Shop name, currency, language, countries it ships to, contact details, and the return, shipping, war...
get_trending_searches
Popular search queries in this store over the last 24 hours — useful to discover what shoppers are l...
get_ucp_profile
Fetch one registered UCP profile by namespace and agent_id.
get_user_profile
Recupera il profilo salvato del cliente identificato (identity_linking): nome, cognome, email, telef...
intent_get
Returns the current lifecycle state of a registered Intent and the orders (units of fulfilment) unde...
intent_register
Records a Consumer-approved Intent with the Intent Service and returns a stable reference usable acr...
intent_revoke
Revokes a registered Intent and its still-open orders. Orders that already completed or failed are l...
invoke_api_endpoint
Invoke an endpoint in the Telnyx TypeScript API. Note: use the `list_api_endpoints` tool to get the...
keepcard_accept_keep_offer
Accept the keep offer. Call this when the customer replies with acceptance language such as yes, acc...
keepcard_check_return_eligibility
Check whether a customer order is eligible for a return. If the customer only says they want to retu...
keepcard_decline_keep_offer
Decline the keep offer or close a return session that has no offer. Call this when the customer repl...
keepcard_select_return_items
Tell Keepcard which items the customer wants to return. Only call this when keepcard_check_return_el...
keepcard_submit_return_reason
Submit the return reason for an eligible return session. The store decision engine evaluates the rea...
link_buyer_identity
REQUIRED first step for an authenticated buyer request. Call this before search_products, get_produc...
list_api_endpoints
List or search for all endpoints in the Telnyx TypeScript API
list_products
List the appointment types Hugo Catarino offers. All offerings are free 1-hour sessions.
list_services
List canonical Dellasale services, optionally filtered by text and country.
logout_buyer
Sign out the current buyer from this MCP OAuth application. Call when the user asks to log out. Revo...
lookup_shop_catalog
Look up specific products or variants by their IDs. Returns a UCP catalog response with a products a...
my_favourites
The linked shopper's favourite products — the basis for personalised recommendations (requires a con...
my_loyalty_points
The linked shopper's loyalty summary — spendable points, level and tier (requires a connected accoun...
my_orders
The linked shopper's recent orders (requires a connected account with the orders:read scope). Return...
open_number_intelligence
Open the Telnyx Number Intelligence MCP App for phone number lookup, validation, and enrichment work...
open_usage_cost_explorer
Open the Telnyx Usage & Cost Explorer MCP App for usage and cost analysis.
open_voice_monitor
Open the Telnyx Voice Monitor MCP App for observing and troubleshooting voice traffic.
post_brief
Today's creative brief: the four products the daily Reel was cut from, the saving, the caption that...
register_ucp_profile
Register a public hosted UCP agent profile and receive agent_id/profile_url. Default path: send agen...
remove_voucher
Remove a voucher from a cart by its voucher id. Returns the updated cart.
request_return_or_refund
Opens a return or refund case on an order, on behalf of the consumer. Input: orderId (the identifier...
search_deals
Search Fazy's price-checked deals catalogue (US retailers; home, wellness, apparel, footwear, electr...
search_locations
Search pickup locations (click-and-collect stores and carrier pickup points).
search_shop_policies_and_faqs
Used to get facts about the stores policies, products, or services. Some examples of questions you c...
select_shipping
Select a shipping method: shipping_standard ($5.99), shipping_express ($12.99), shipping_next_day ($...
set_cart_user
Set or update the user ID on a cart, linking it to a customer account. Returns the updated cart.
shopping_cart_cancel
Cancel a merchant cart using an idempotency key.
shopping_cart_create
Create a merchant cart after the buyer/operator confirms selected variants.
shopping_cart_get
Refresh a merchant cart state.
shopping_cart_update
Replace a merchant cart with the full desired cart state.
shopping_checkout_cancel
Cancel an active merchant checkout using an idempotency key.
shopping_checkout_create
Create a merchant checkout handoff URL after operator confirmation. Does not accept payment credenti...
shopping_checkout_get
Refresh merchant checkout state.
shopping_checkout_update
Update checkout with a typed buyer (recommended for address/phone corrections) and/or a full checkou...
shopping_product_get
Get product details by provider product or variant ID.
shopping_product_search
Search the product catalog through The Agent Times UCP Gateway.
similar_deals
Deals like this one (nearest by product, not just category), in the same shape search_deals returns....
subscribe_product_alert
Subscribe an email address to a product alert: restock (back in stock) or price_drop (price falls to...
ucp_describe
Returns the UCP business profile describing capabilities, services, and payment handlers.
ucp.create_checkout
Create a checkout cart from storefront line items and return payment requirements. When the order is...
ucp.search_products
Search published storefront products.
ucp.update_checkout
Apply payment and address details to an existing checkout cart and complete offline/COD orders. On s...
update_cart_item
Change a cart line's quantity.
update_item_quantity
Change the quantity of a line item in a cart. Use quantity=0 to remove the item. Returns the updated...
add_item
Add an item to the shopping cart
build-bundle
Build a multi-store shopping cart in one call. Pass an array of items (each with domain + v...
checkout_create
Create a stateless checkout session for one or more products and return a continue_url to redirect t...
complete_checkout_session
Place the order. Must provide valid AP2 mandate.
create_checkout_session
Create a checkout session for a product. Returns session ID, totals, shipping options, payment handl...
find_store
Find an Artos store by name, slug, or UUID. Use this first to get the storeId needed for search_prod...
get_linked_identities
Get all linked identities for a profile
get_offer_ancillaries
Load live ancillary services for one selected flight offer, including extra baggage and seat options...
link_identity
Link an identity to a profile
receive_order_event
Receive an order event notification
remove_item
Remove an item from the shopping cart
resolve_identity
Resolve an identity across platforms
search_flights
Search for available flights. Returns offers with TTL, pricing, and itinerary details.
ucp_get_order
Retrieve order details and status (requires authentication)
ucp_list_orders
List orders for authenticated user with optional filtering
ucp_payment_handler_complete_session
Completa una sessione payment handler UCP sottomettendo una credential tokenizzata (MIT). Usa questo...
ucp_payment_handler_create_session
Crea una nuova sessione payment handler UCP per Click to Pay, Google Pay, Apple Pay, PayPal. Restitu...
ucp_payment_handler_get_session
Recupera lo stato di una sessione payment handler UCP esistente.
ucp_register_webhook
Register webhook for order lifecycle events (order.created, order.status_changed)
unlink_identity
Unlink an identity from a profile
update_checkout_session
Update shipping or apply discount to a checkout session.
update_item
Update an item in the shopping cart
Frequently Asked Questions
What are MCP tools in UCP?
tools/list method and define the input schema, description, and behavior for each action — like searching a catalog, managing a cart, or completing a purchase.How do tools relate to capabilities?
get_cart, update_cart, and get_product_details.How does an agent discover available tools?
tools/list to enumerate available operations. Each tool returns its name, description, and JSON Schema for its input parameters.Explore Protocol Data
Get the agentic commerce digest every Monday
Real adoption data, ecosystem trends, new spec versions, and the stores that broke or recovered this week. Read by founders and engineers building the next generation of commerce.
