ucp.new

Last change

None yetUnchanged since first read.

Declared read-only

3 of 6

llms.txt

Present

1. add_to_cartCan change things

   Add an exact visible catalog variant to its merchant cart. First call get_search_results with product_id and copy the product_id and variant_id exactly; never guess a size, option, seller, or unavailable variant. This adds to an existing line when present and schedules merchant Cart MCP sync, but does not begin checkout.

   First seen 12 Oct 2026. Unchanged since.

2. get_cartReads only

   Read the shopper's current UCP Playground carts, grouped by merchant because each merchant owns a separate cart and checkout. Returns visible line items, quantities, cached prices, merchant totals, and sync state. It does not refresh stale details, change quantities, clear a cart, or begin checkout.

   First seen 12 Oct 2026. Unchanged since.

3. get_search_resultsReads only

   Read products already loaded in the active UCP Playground session. Use after search_catalog or when the user refers to a visible product. Pass product_id to return that product's exact variant ids, options, availability, price, and merchant before add_to_cart. This does not perform a network request or reveal hidden catalog data.

   First seen 12 Oct 2026. Unchanged since.

4. get_site_stateReads only

   Read the current UCP Playground page, active session, session history, and high-level search/cart counts. Call this first when you need to orient yourself or obtain a session_id. It does not return product results or cart lines; use get_search_results or get_cart for those.

   First seen 12 Oct 2026. Unchanged since.

5. navigateCan change things

   Navigate the visible UCP Playground page. Use destination=session only with a session_id returned by get_site_state, and destination=product only with a product_id returned by get_search_results. Other destinations need no id. This changes only the visible page; it does not search, change carts, or begin checkout.

   First seen 12 Oct 2026. Unchanged since.

6. search_catalogCan change things

   Start a text search in the Global Catalog using the UCP Playground's current filters, buyer context, language, currency, and page-size settings. Use for a shopper's product query, not for a known product id. Results arrive asynchronously: after calling, wait for completion and call get_search_results. This opens the active session and does not add anything to the cart.

   First seen 12 Oct 2026. Unchanged since.

Run this site? This page shows what your site told our crawler, ToolChronicleBot. To be left out, disallow it in robots.txt or write to hello@toolchronicle.com.