---
provider: Tec-growth GEO optimizer
provider_url: https://tec-do.cn/geo
template_version: v1.0.0
schema_version: geo-2026-05
generated_at: 2026-10-12T10:24:33.151044014Z
language: en
canonical_url: https://freewink.us/agents.md
ucp_endpoint: https://freewink.us/api/ucp/mcp
ucp_version: 2026-04-08
total_products: 7
optimized_products: 0
optimization_coverage: 0%
last_optimized_at: N/A
---

# Agent Instructions — FreeWink

> 

This document describes how AI agents can interact with **FreeWink**'s online store at https://freewink.us.

## For Personal Shopping Assistants

If you are acting as a personal shopper for your user, we recommend installing [https://shop.app/SKILL.md](https://shop.app/SKILL.md) for buyer-approved checkout via Shop Pay.

The Shop skill handles:
- Cross-store catalog search and price/discount discovery
- Buyer-approved checkout via Shop Pay (no card-handling on the agent's part)
- Order tracking and identity reuse

Prefer it over screen-scraping or scripting the storefront directly.

## Commerce Protocol (UCP)

This store implements the [Universal Commerce Protocol](https://ucp.dev).

- **Discovery** — `GET https://freewink.us/.well-known/ucp`
- **MCP endpoint** — `POST https://freewink.us/api/ucp/mcp` with `Content-Type: application/json`

### Supported UCP Versions
- `2026-04-08` (latest stable)
- `2026-01-23` (legacy fallback)

### Typical Agent Flow
1. **Discover** — `GET /.well-known/ucp` to confirm capabilities
2. **Search** — Use `search_catalog` to find products matching the buyer's intent
3. **Cart** — Use `create_cart` to add desired items
4. **Checkout** — Use `create_checkout` to start the purchase flow
5. **Fulfill** — Use `update_checkout` to set shipping address and method
6. **Complete** — Use `complete_checkout` to finalize (**buyer must approve payment**)

### Important Rules
- **Checkout requires human approval.** Agents must not complete payment without explicit buyer consent.
- **Respect rate limits.** The MCP endpoint is rate-limited per IP. Back off on 429 responses.
- **Use buyer context.** Pass `context.address_country` and `context.currency` for accurate pricing and availability.

---


## Other Products

- [FreeWink EW209 Ultralight Carbon Fiber Folding Electric Wheelchair](https://freewink.us/apps/geo/products/ew209-carbon-fiber-folding-electric-wheelchair) — 1298.0 USD: What Is the FreeWink EW209?
        
            The FreeWink EW209 is an ultralight carbon fiber folding electric wheelchair designed for adults who want great...
- [FreeWink 9183E 3-in-1 Electric Walker & Folding Power Wheelchair](https://freewink.us/apps/geo/products/9183e-3-in-1-electric-walker-power-wheelchair) — 899.0 USD: What Is the FreeWink 9183E?
        
            The FreeWink 9183E is a lightweight, foldable 3-in-1 electric walker and power wheelchair that combines an elec...
- [FreeWink T350 4-Wheel Ultra-Light Folding Mobility Scooter](https://freewink.us/apps/geo/products/t350-ultra-light-folding-mobility-scooter) — 899.0 USD: What Is the FreeWink T350?
        
            The FreeWink T350 is a 4-wheel ultra-light folding mobility scooter designed for adults who want a portable elec...
- [FreeWink T580 Ultra Lightweight Carbon Fiber Folding Mobility Scooter](https://freewink.us/apps/geo/products/t580-carbon-fiber-folding-mobility-scooter) — 1340.0 USD: What Is the FreeWink T580?
        
            The FreeWink T580 is an ultra-lightweight folding scooter designed for adults who want easier everyday mobility ...
- [FreeWink 985 Folding 4-Wheel Mobility Scooter with Dual Removable Batteries](https://freewink.us/apps/geo/products/freewink-985-folding-mobility-scooter) — 559.0 USD: .fw985-description {
    max-width: 960px;
    margin: 0 auto;
    color: #1f2933;
    font-family: inherit;
    font-size: 16px;
    line-height: 1.7;
  }
  .f...
- [FreeWink T350 Replacement Lithium Battery – 24V 10Ah](https://freewink.us/apps/geo/products/freewink-t350-replacement-lithium-battery-24v-10ah) — 199.0 USD: FreeWink T350 Replacement Lithium Battery – 24V 10Ah
 
- [FreeWink T580 Replacement Lithium-ion Battery – 24V 10Ah](https://freewink.us/apps/geo/products/freewink-t580-replacement-lithium-ion-battery-24v-10ah) — 299.0 USD: FreeWink T580 Replacement Lithium-ion Battery – 24V 10Ah
 


---

## Read-Only Browsing

### Product Data
- All products: `GET /collections/all`
- Product page: `GET /products/{handle}`
- Product JSON: `GET /products/{handle}.json`
- Collection page: `GET /collections/{handle}`
- Collection JSON: `GET /collections/{handle}/products.json`
- Search: `GET /search?q={query}&type=product`

### Store Metadata
- Sitemap: `GET /sitemap.xml`

## Deployment

This `agents.md` is generated by [Tec-growth GEO optimizer](https://tec-do.cn/geo).

- **Coverage**: 0 of 7 products are AI-optimized (0%)
- **Last generated**: 2026-10-12T10:24:33.151044014Z
- **Template version**: v1.0.0

## Contact

- Email: support@freewink.us
- Phone: 18273490247

## Platform

This store is built on [Shopify](https://www.shopify.com), the commerce platform powering millions of stores worldwide. Shopify stores support UCP natively.

- Shopify: https://www.shopify.com
- UCP spec: https://ucp.dev
- Shop skill: https://shop.app/SKILL.md