https://github.com/Upsonic/UCP-Agent
A shopping assistant powered by Upsonic AI Agent and UCP (Universal Checkout Protocol).
https://github.com/Upsonic/UCP-Agent
agent mcp ucp universal-commerce-protocol
Last synced: 3 months ago
JSON representation
A shopping assistant powered by Upsonic AI Agent and UCP (Universal Checkout Protocol).
- Host: GitHub
- URL: https://github.com/Upsonic/UCP-Agent
- Owner: Upsonic
- License: mit
- Created: 2026-01-12T12:10:10.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2026-01-12T14:59:53.000Z (5 months ago)
- Last Synced: 2026-02-01T20:47:24.655Z (4 months ago)
- Topics: agent, mcp, ucp, universal-commerce-protocol
- Language: Python
- Homepage:
- Size: 26.4 KB
- Stars: 8
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ucp - UCP Agent Demo - A shopping assistant powered by Upsonic AI Agent and UCP (Universal Commerce Protocol) (AI & Agent Integrations)
README
# UCP Shopping Agent
A shopping assistant powered by **Upsonic AI Agent** and **UCP (Universal Commerce Protocol)**.
## How it works
```mermaid
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
```
**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
```bash
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:
```bash
uv run ucp mockup_server
```
**Terminal 2** - Run the agent (CLI):
```bash
uv run upsonic_shopping_agent.py
```
## Streamlit UI
You can also use the Streamlit web interface:
```bash
uv run streamlit run streamlit_app.py
```
Then open http://localhost:8501 in your browser.
