Agentic Commerce — Lifestyle, Wellness, & Gifts

---
name: shop-culture
description: "Agentic Commerce skills for the For the Cult store. Enables agents to browse and search for quality lifestyle, wellness, smart home, and longevity products, view details and variants, create orders with multi-chain payments (Solana, Ethereum, Base, Polygon, Arbitrum, Bitcoin, Dogecoin, Monero) or x402 checkout (USDC), apply CULT token-holder discounts, and track orders from payment to delivery. Use when a user wants to buy products, browse a store, find gifts, place an order, or track a shipment."
license: MIT
compatibility: Requires network access and an HTTP client (fetch, curl, requests). No API key or env vars required. Browsing, search, checkout, and order status need no authentication. Optional: agent runtimes may supply X-Moltbook-Identity for agent-only endpoints (/agent/me, /agent/me/orders, /agent/me/preferences); do not send or infer identity tokens—use only if the runtime explicitly provides one. Works with Claude, ChatGPT, Cursor, GitHub Copilot, Gemini, Windsurf, Goose, Cline, Roo Code, Molt, OpenClaw, LangChain, and all AgentSkills-compatible agents.
metadata:
  author: forthecult
  version: "1.0.8"
  homepage: https://forthecult.store
  clawhub: shop-culture
  support: weare@forthecult.store | Discord https://discord.gg/pMPwfQQX6c
---

# For the Cult Store — Agentic Commerce Skill

The **Agentic Commerce** shopping skill [For the Cult](https://forthecult.store). This skill gives agents everything they need to **browse products, place orders, and track shipments** using the public REST API. The store sells quality lifestyle, wellness, and smart home products — from coffee and apparel to tech gadgets and pet goods — and accepts **multi-chain payments** across 8+ blockchains plus **x402 checkout** with USDC on Solana. No account or API key required.

**Key advantages:**
- **Multi-chain payments** — USDC, Solana, Ethereum, Base, Polygon, Arbitrum, Bitcoin, Dogecoin, Monero
- **x402 checkout** — API supports HTTP 402; signing and wallet use are the runtime’s (or user’s) responsibility—the skill does not access or request private keys
- **CULT token discounts** — 5-20% off + free shipping for token holders
- **AI shopping assistant** — Natural language in, structured products + AI reply out
- **No platform fees** on shopping — Agents pay product price only
- **No API key required** — Public API for browsing and checkout

## Compatible Agents

This skill works with any agent that supports HTTP requests:

- **OpenClaw**
- **Agent Zero**
- **Claude** (Anthropic) — Claude Code, Claude.ai
- **ChatGPT / Codex** (OpenAI)
- **Cursor**
- **GitHub Copilot** (VS Code)
- **Gemini CLI** (Google)
- **Windsurf**
- **Goose** (Block)
- **Cline, Roo Code, Trae**
- Any AgentSkills-compatible runtime

## When to use this skill

- User wants to **buy something**, **shop**, **browse products**, **find a gift**, or **place an order**.
- User mentions **shop**, **gift**, the **CULT token**, or **agentic commerce**.
- User asks about **paying with USDC**, **Solana**, **Ethereum**, or other supported payment methods for physical goods.
- User wants to **check order status**, **track a shipment**, or look up an order ID.
- Any scenario requiring an agent to **autonomously complete an end-to-end purchase** on behalf of a user.

## Base URL

```
https://forthecult.store/api
```

Use the base URL above for all API requests.

---

## Agentic Commerce workflow (step by step)

### 1. Discover capabilities (recommended first call)

**`GET /agent/capabilities`** — returns a natural-language summary of what the API can do, supported chains/tokens, and limitations. Use the response to answer user questions about the store.

### 2. Browse or search products

| Action | Endpoint | Notes |
|--------|----------|-------|
| **Shop (AI)** | `POST /agent/shop` | **Natural language shopping assistant** — send a message, get AI reply + products |
| Categories | `GET /categories` | Category tree with slugs and product counts |
| Featured | `GET /products/featured` | Curated picks with badges (`trending`, `new`, `bestseller`) |
| Search | `GET /products/search?q=<query>` | **Semantic search** — use natural language |
| Agent list | `GET /agent/products?q=<query>` | Agent-optimized product list (same filters) |

#### POST /agent/shop — Shopping Assistant

The simplest way to search. Natural language in, structured products + AI reply out.

**Request:**
```json
{
  "message": "wireless noise-canceling headphones under $200",
  "context": {
    "priceRange": { "max": 200 },
    "preferences": ["good battery life", "comfortable"]
  }
}
```

**Response:**
```json
{
  "reply": "I found some great wireless noise-canceling headphones under $200...",
  "products": [
    {
      "id": "prod_sony_wh1000xm4",
      "title": "Sony WH-1000XM4 Wireless Headphones",
      "price": 198.00,
      "currency": "USD",
      "source": "store",
      "inStock": true,
      "badge": "bestseller"
    }
  ]
}
```

**Search parameters** (all optional except `q`):

| Param | Type | Description |
|-------|------|-------------|
| `q` | string | Natural-language query (e.g. `birthday gift under 50`) |
| `category` | string | Category slug filter |
| `priceMin` | number | Minimum USD price |
| `priceMax` | number | Maximum USD price |
| `sort` | string | `newest` (recently added), `popular` (best seller), `rating` (best rated), `price_asc`, `price_desc` (default: newest) |
| `limit` | integer | Results per page (default 20, max 100) |
| `offset` | integer | Pagination offset |

Search returns only in-stock items. Response `products[]` includes `id`, `name`, `slug`, `price.usd`, `price.crypto`, `inStock`, `category`, `tags`. **Always use the product `id` field** when creating an order — never invent or guess IDs.

### 3. Get product details

**`GET /products/{slug}`** — use the `slug` from search results.

Returns full product info including **`id`** (for checkout), `variants[]` (each with `id`, `name`, `inStock`, `stockQuantity`, `price`), `images[]`, `relatedProducts[]`, and `description`.

If the product has variants, pick one that is `inStock` and include its `variantId` in the checkout payload.

### 4. Check supported payment methods

**`GET /payment-methods`** — get all supported payment methods. Response includes `data` (enabled method settings) and `chains` (blockchain networks and tokens). Use `chains` before checkout to verify a payment method is supported.

| Network | Example tokens |
|---------|---------------|
| **Solana** | SOL, USDC, USDT, CULT |
| **Ethereum** | ETH, USDC, USDT |
| **Base** | ETH, USDC |
| **Polygon** | MATIC, USDC |
| **Arbitrum** | ETH, USDC |
| **Bitcoin** | BTC |
| **Dogecoin** | DOGE |
| **Monero** | XMR |

Always verify with `GET /payment-methods` (use response `chains`) before suggesting a payment method. **USDC or USDT** for predictable pricing.

### 5. Create an order (checkout)

Two checkout options:
1. **Standard checkout** (`POST /checkout`) — Create order, poll for payment confirmation
2. **x402 checkout** (`POST /checkout/x402`) — API returns HTTP 402 with payment requirements; the runtime (or user) signs and submits the transaction—the skill does not access private keys

---

#### Option A: Standard Checkout (POST /checkout)

**`POST /checkout`** with a JSON body. See [references/CHECKOUT-FIELDS.md](references/CHECKOUT-FIELDS.md) for every field.

Required top-level fields:

- **`items`** — array of `{ "productId": "<id>", "quantity": 1 }`. Add `"variantId"` when the product has variants.
- **`email`** — customer email for order confirmation.
- **`payment`** — `{ "chain": "solana", "token": "USDC" }`.
- **`shipping`** — `{ "name", "address1", "city", "stateCode", "postalCode", "countryCode" }`. `countryCode` is 2-letter ISO (e.g. `US`). Optional: `address2`.

Optional:

- **`wallet` / `walletAddress`** — optional. For tier discounts, ownership is verified: use an account with that wallet linked, or send the message from `GET /api/chec