GitHunt
UP

Upsonic/UCP-Agent

A shopping assistant powered by Upsonic AI Agent and UCP (Universal Checkout Protocol).

UCP Shopping Agent

A shopping assistant powered by Upsonic AI Agent and UCP (Universal Commerce Protocol).

How it works

flowchart LR
    subgraph User
        A[๐Ÿ‘ค You]
    end
    
    subgraph Upsonic
        B[๐Ÿค– AI Agent]
    end
    
    subgraph UCP
        C[๐Ÿ”Œ UCP Tools]
    end
    
    subgraph Merchant
        D[๐Ÿช Shop API]
        E[(๐Ÿ“ฆ Products)]
        F[(๐Ÿ›’ Orders)]
    end
    
    A -->|Chat| B
    B -->|Tool Calls| C
    C -->|API Requests| D
    D --> E
    D --> F
    D -->|Response| C
    C -->|Results| B
    B -->|Answer| A
Loading

UCP (Universal Checkout Protocol) enables AI agents to interact with e-commerce systems through a standardized interface.

Tool Description
get_available_products() Browse product catalog
get_available_discount_codes() View discount codes
get_your_user() Get user info & addresses
discover_merchant() Merchant & payment info
create_cart() Create shopping cart
apply_discount() Apply discount to cart
set_shipping_address() Set delivery address
complete_purchase() Complete checkout

Installation

uv venv
uv pip install "ucp-client[server]==0.0.11"
uv pip install upsonic==0.69.3
uv pip install streamlit

Usage

Terminal 1 - Start the mock server:

uv run ucp mockup_server

Terminal 2 - Run the agent (CLI):

uv run upsonic_shopping_agent.py

Streamlit UI

You can also use the Streamlit web interface:

uv run streamlit run streamlit_app.py

Then open http://localhost:8501 in your browser.

Screenshot 2026-01-12 at 4 32 16 PM

Languages

Python85.2%Makefile14.8%

Contributors

MIT License
Created January 12, 2026
Updated March 5, 2026