UCP Checker
Protocol

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...

18355 stores

lookup_catalog

Retrieve catalog products by identifier (batch lookup by product or variant IDs). Returns full produ...

18347 stores

get_product

Retrieve a single product by ID with full detail. Supports compound variant IDs (productId:variantId...

18297 stores

create_checkout

Start a new checkout session. Returns a session object with an "id" field — store this ID and use up...

18280 stores

update_checkout

Update an existing checkout session. Pass only the items you want to add or change — they are MERGED...

18279 stores

complete_checkout

Finalize checkout and create WooCommerce order with payment credentials

18277 stores

cancel_checkout

Cancel a checkout session

18274 stores

get_checkout

Get the current state of an existing checkout session. Use this to check totals, prices, messages, o...

18274 stores

create_cart

Create a new cart (checkout session). Returns the full cart state including the checkout_session_id...

10890 stores

update_cart

Perform updates to a cart, including adding/removing/updating line items, buyer information, shippin...

10890 stores

get_cart

Get the cart including items, shipping options, discount info, and checkout url for a given cart id

10863 stores

cancel_cart

Cancel and discard a cart session.

10857 stores

get_order

Retrieve order details

10771 stores

catalog_lookup

Alias for lookup_catalog.

69 stores

catalog_search

Alias for search_catalog.

69 stores

get_product_details

Look up a product by ID and optionally specify variant options to select a specific variant.

9 stores

list-categories

List all available store categories with store counts. Use to discover what kinds of stores...

8 stores

check-domain

Check if a domain supports Universal Commerce Protocol (UCP). Returns the UCP status, manif...

5 stores

discover-store

Discover available shopping tools on a UCP-enabled store. Connects to the store's MCP endpo...

5 stores

list-stores

List verified UCP stores, optionally filtered by category and minimum score. Use when the u...

5 stores

search-all

Search for products across all verified UCP stores at once. Fans out the query to multiple...

5 stores

search-policies

Search store policies on any UCP-enabled Shopify store. Query return policies, shipping pol...

5 stores

search_shop_catalog

Search for products from the online store, hosted on Shopify. This tool can be used to search for p...

4 stores

add-to-cart

Add a product to cart on any UCP-enabled Shopify store and get a checkout URL. Requires a v...

3 stores

get_categories

List all menu categories (e.g., APPETIZERS, SOUPS, ENTREES, SALADS) with their sort order and descri...

3 stores

get_modifier_groups

List all available modifier groups for menu customization. Shows what types of customizations are av...

3 stores

get_modifier_options

Get all available options for a specific modifier group (e.g., Spice Levels: Mild/Medium/Hot, Extras...

3 stores

list_all_items

Get the complete menu with all items including images, prices, descriptions, and categories. Returns...

3 stores

lookup_locations

Look up the property as a location: address, geo, hours, amenities.

3 stores

search_products

Search products in an Artos store. Returns a list of variants with their variantId and price — use t...

3 stores

track_order

Track order by order id, order number, or cart id in this Virto Commerce storefront.

3 stores

cancel_booking

Store extension: cancel a confirmed booking with its cancellation policy applied (free before the de...

2 stores

cancel_booking_session

Cancel a booking session before it is completed.

2 stores

caty_affiliate_catalog

Search a verified product index for Romania: 1.7M+ products from 45+ vetted merchant stores, with re...

2 stores

caty_render_product_cards

Search products matching the user query and render them as an interactive carousel in the chat widge...

2 stores

checkout_and_handoff

Create checkout and immediately create a hosted checkout handoff URL. For physical goods, do not cal...

2 stores

complete_booking_session

Confirm the reservation under the selected payment term. The session must be ready_for_complete. Ask...

2 stores

create_booking_session

Create a booking session for a room at the property. Returns prices (totals), payment terms (pay now...

2 stores

find_venues

List this brand’s venues, optionally filtered by name, town or postcode. Call it first: every other...

2 stores

get_available_fulfillment

Get how this venue can be ordered from (delivery, collection or in-store), the minimum spend for eac...

2 stores

get_available_slots

Get the delivery or collection time slots this venue still has for a given day. Slots run out, so qu...

2 stores

get_booking

Retrieve booking status and details including all carrier booking references.

2 stores

get_booking_session

Get the current state of a booking session; prices and the cancellation policy reflect now.

2 stores

get_item

Get one item in full: description, price, dietary tags, the allergens it contains and may contain (n...

2 stores

get_menu

Get this venue's menu. With no arguments it returns every category with all of its items — name, pri...

2 stores

get_payment_handlers

Get payment handlers for a checkout in this Virto Commerce storefront.

2 stores

get_store_capabilities

Discover UCP capabilities for this Virto Commerce storefront.

2 stores

get_venue_info

Get the venue itself: name, address, phone number, website, description, whether it is open right no...

2 stores

handoff_checkout

Create a hosted checkout handoff URL. For physical goods, do not call until shipping_address.first_n...

2 stores

list_carts

List buyer-scoped carts in this Virto Commerce storefront. An explicit buyer_id is required; global...

2 stores

list_countries

List or search countries in this Virto Commerce storefront.

2 stores

list_orders

List closed orders. Returns {orders[], pagination: {has_next_page, cursor, total_count}}. Default pe...

2 stores

list_regions

List regions for a country in this Virto Commerce storefront.

2 stores

remove_cart_item

Remove a line item (and its children) from a cart by item id. Returns the updated cart state.

2 stores

resolve_country

Resolve country text to a Virto Commerce platform country id in this storefront.

2 stores

search_menu

Search this menu by dish name, category or description — the way a customer would ask for it ("hallo...

2 stores

search_properties

NOT part of UCP (lodging discovery is out of scope of dev.ucp.lodging.booking). Lists this property'...

2 stores

ucp_get_product

Get full details for a product, including variations and stock levels. Pass the "id" value exactly a...

2 stores

ucp_list_products

Search and browse the product catalog. ALWAYS include a search term when the user names a product, b...

2 stores

update_booking_session

Replace a booking session's request: room, dates, occupancy, booker, guests, chosen payment term. Ac...

2 stores

apply_discount

Apply a discount/coupon code to a checkout session.

1 store

apply_voucher

Apply a voucher code to a cart. The voucher value is in öre (e.g. 10000 = 100 kr). Returns the updat...

1 store

cart_update

Alias for update_cart (full replacement): sets the cart to exactly the provided line_items, creating...

1 store

catalog_slice

A chosen slice of the catalogue for writing about: filter by category, brand, price band (USD) and m...

1 store

check_availability

Returns Hugo Catarino's available 1-hour slots for the given inclusive date range. Dates are ISO yyy...

1 store

clear_cart

Remove all items and vouchers from a cart, resetting it to an empty state. The cart id, user id, and...

1 store

convert_cart

Convert an existing cart into a checkout session. Preserves all cart-level state including discounts...

1 store

create_booking

Create appointment booking. [model-only guidance] Free 1-hour session with Hugo Catarino; the user m...

1 store

find_pickup_points

Find parcel pickup points near a Greek postal code: ACS Smartpoint lockers/shops and BOX NOW lockers...

1 store

get_api_endpoint_schema

Get the schema for an endpoint in the Telnyx TypeScript API. You can use the schema returned by this...

1 store

get_cart_items

List all items in a cart with their SKU, name, quantity, unit price, total price, stock, tax rate, m...

1 store

get_cart_promotions

Get all applied and pending promotions on a cart, including discount amounts and progress nudges (e....

1 store

get_cart_totals

Get price breakdown for a cart: total incVat, total exVat, VAT breakdown by rate, total discount (vo...

1 store

get_cart_vouchers

List all vouchers applied to a cart with their codes, values, rules, and whether they are currently...

1 store

get_checkout_link

Get the URL where the shopper completes checkout in their browser — reviewing the cart, choosing del...

1 store

get_company_info

Return canonical public information about Dellasale.

1 store

get_compatible_parts

Find the replacement parts (domes, wax filters, wireless accessories, chargers) that fit a hearing-a...

1 store

get_context

Returns the current server UTC time. Call this at the start of a session to establish an accurate ti...

1 store

get_deal

One deal by id, in the same shape search_deals returns. Use it to re-check a price before recommendi...

1 store

get_payment_methods

Payment methods this store accepts (e.g. card via Viva/Stripe, cash on delivery), with any extra cos...

1 store

get_price_history

Is this a good price? One deal with what its price has done, from Fazy's own price record: the lowes...

1 store

get_product_reviews

Customer reviews for a product: overall rating and recent verified-purchase comments.

1 store

get_shipping_options

Available delivery methods for a destination country with prices and free-shipping thresholds. Kinds...

1 store

get_shipping_profile

Recupera l'indirizzo di spedizione salvato del cliente identificato (identity_linking), da chiamare...

1 store

get_store_info

Shop name, currency, language, countries it ships to, contact details, and the return, shipping, war...

1 store

get_trending_searches

Popular search queries in this store over the last 24 hours — useful to discover what shoppers are l...

1 store

get_ucp_profile

Fetch one registered UCP profile by namespace and agent_id.

1 store

get_user_profile

Recupera il profilo salvato del cliente identificato (identity_linking): nome, cognome, email, telef...

1 store

intent_get

Returns the current lifecycle state of a registered Intent and the orders (units of fulfilment) unde...

1 store

intent_register

Records a Consumer-approved Intent with the Intent Service and returns a stable reference usable acr...

1 store

intent_revoke

Revokes a registered Intent and its still-open orders. Orders that already completed or failed are l...

1 store

invoke_api_endpoint

Invoke an endpoint in the Telnyx TypeScript API. Note: use the `list_api_endpoints` tool to get the...

1 store

keepcard_accept_keep_offer

Accept the keep offer. Call this when the customer replies with acceptance language such as yes, acc...

1 store

keepcard_check_return_eligibility

Check whether a customer order is eligible for a return. If the customer only says they want to retu...

1 store

keepcard_decline_keep_offer

Decline the keep offer or close a return session that has no offer. Call this when the customer repl...

1 store

keepcard_select_return_items

Tell Keepcard which items the customer wants to return. Only call this when keepcard_check_return_el...

1 store

keepcard_submit_return_reason

Submit the return reason for an eligible return session. The store decision engine evaluates the rea...

1 store

link_buyer_identity

REQUIRED first step for an authenticated buyer request. Call this before search_products, get_produc...

1 store

list_api_endpoints

List or search for all endpoints in the Telnyx TypeScript API

1 store

list_products

List the appointment types Hugo Catarino offers. All offerings are free 1-hour sessions.

1 store

list_services

List canonical Dellasale services, optionally filtered by text and country.

1 store

logout_buyer

Sign out the current buyer from this MCP OAuth application. Call when the user asks to log out. Revo...

1 store

lookup_shop_catalog

Look up specific products or variants by their IDs. Returns a UCP catalog response with a products a...

1 store

my_favourites

The linked shopper's favourite products — the basis for personalised recommendations (requires a con...

1 store

my_loyalty_points

The linked shopper's loyalty summary — spendable points, level and tier (requires a connected accoun...

1 store

my_orders

The linked shopper's recent orders (requires a connected account with the orders:read scope). Return...

1 store

open_number_intelligence

Open the Telnyx Number Intelligence MCP App for phone number lookup, validation, and enrichment work...

1 store

open_usage_cost_explorer

Open the Telnyx Usage & Cost Explorer MCP App for usage and cost analysis.

1 store

open_voice_monitor

Open the Telnyx Voice Monitor MCP App for observing and troubleshooting voice traffic.

1 store

post_brief

Today's creative brief: the four products the daily Reel was cut from, the saving, the caption that...

1 store

register_ucp_profile

Register a public hosted UCP agent profile and receive agent_id/profile_url. Default path: send agen...

1 store

remove_voucher

Remove a voucher from a cart by its voucher id. Returns the updated cart.

1 store

request_return_or_refund

Opens a return or refund case on an order, on behalf of the consumer. Input: orderId (the identifier...

1 store

search_deals

Search Fazy's price-checked deals catalogue (US retailers; home, wellness, apparel, footwear, electr...

1 store

search_locations

Search pickup locations (click-and-collect stores and carrier pickup points).

1 store

search_shop_policies_and_faqs

Used to get facts about the stores policies, products, or services. Some examples of questions you c...

1 store

select_shipping

Select a shipping method: shipping_standard ($5.99), shipping_express ($12.99), shipping_next_day ($...

1 store

set_cart_user

Set or update the user ID on a cart, linking it to a customer account. Returns the updated cart.

1 store

shopping_cart_cancel

Cancel a merchant cart using an idempotency key.

1 store

shopping_cart_create

Create a merchant cart after the buyer/operator confirms selected variants.

1 store

shopping_cart_get

Refresh a merchant cart state.

1 store

shopping_cart_update

Replace a merchant cart with the full desired cart state.

1 store

shopping_checkout_cancel

Cancel an active merchant checkout using an idempotency key.

1 store

shopping_checkout_create

Create a merchant checkout handoff URL after operator confirmation. Does not accept payment credenti...

1 store

shopping_checkout_get

Refresh merchant checkout state.

1 store

shopping_checkout_update

Update checkout with a typed buyer (recommended for address/phone corrections) and/or a full checkou...

1 store

shopping_product_get

Get product details by provider product or variant ID.

1 store

shopping_product_search

Search the product catalog through The Agent Times UCP Gateway.

1 store

similar_deals

Deals like this one (nearest by product, not just category), in the same shape search_deals returns....

1 store

subscribe_product_alert

Subscribe an email address to a product alert: restock (back in stock) or price_drop (price falls to...

1 store

ucp_describe

Returns the UCP business profile describing capabilities, services, and payment handlers.

1 store

ucp.create_checkout

Create a checkout cart from storefront line items and return payment requirements. When the order is...

1 store

ucp.search_products

Search published storefront products.

1 store

ucp.update_checkout

Apply payment and address details to an existing checkout cart and complete offline/COD orders. On s...

1 store

update_cart_item

Change a cart line's quantity.

1 store

update_item_quantity

Change the quantity of a line item in a cart. Use quantity=0 to remove the item. Returns the updated...

1 store

add_item

Add an item to the shopping cart

0 stores

build-bundle

Build a multi-store shopping cart in one call. Pass an array of items (each with domain + v...

0 stores

checkout_create

Create a stateless checkout session for one or more products and return a continue_url to redirect t...

0 stores

complete_checkout_session

Place the order. Must provide valid AP2 mandate.

0 stores

create_checkout_session

Create a checkout session for a product. Returns session ID, totals, shipping options, payment handl...

0 stores

find_store

Find an Artos store by name, slug, or UUID. Use this first to get the storeId needed for search_prod...

0 stores

get_linked_identities

Get all linked identities for a profile

0 stores

get_offer_ancillaries

Load live ancillary services for one selected flight offer, including extra baggage and seat options...

0 stores

link_identity

Link an identity to a profile

0 stores

receive_order_event

Receive an order event notification

0 stores

remove_item

Remove an item from the shopping cart

0 stores

resolve_identity

Resolve an identity across platforms

0 stores

search_flights

Search for available flights. Returns offers with TTL, pricing, and itinerary details.

0 stores

ucp_get_order

Retrieve order details and status (requires authentication)

0 stores

ucp_list_orders

List orders for authenticated user with optional filtering

0 stores

ucp_payment_handler_complete_session

Completa una sessione payment handler UCP sottomettendo una credential tokenizzata (MIT). Usa questo...

0 stores

ucp_payment_handler_create_session

Crea una nuova sessione payment handler UCP per Click to Pay, Google Pay, Apple Pay, PayPal. Restitu...

0 stores

ucp_payment_handler_get_session

Recupera lo stato di una sessione payment handler UCP esistente.

0 stores

ucp_register_webhook

Register webhook for order lifecycle events (order.created, order.status_changed)

0 stores

unlink_identity

Unlink an identity from a profile

0 stores

update_checkout_session

Update shipping or apply discount to a checkout session.

0 stores

update_item

Update an item in the shopping cart

0 stores

Frequently Asked Questions

What are MCP tools in UCP?
MCP tools are the specific operations an AI agent can invoke on a UCP-enabled store. They are discovered via MCP's 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?
Tools are the agent-facing API surface that maps to higher-level capability contracts. A single capability like checkout may expose multiple tools such as get_cart, update_cart, and get_product_details.
How does an agent discover available tools?
Agents connect to the store's MCP endpoint (declared in the UCP manifest) and call tools/list to enumerate available operations. Each tool returns its name, description, and JSON Schema for its input parameters.
Weekly UCP Report

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.

Free forever No spam Unsubscribe anytime

View a sample report →

Weekly UCP Report
Issue #53 · Oct 5, 2026
+664
new verified stores
Verified rate
Latest spec
Cart capability