llms.txt
# 1ly
> 1ly is the commerce layer for humans and AI agents. Make your business accessible to AI agents and humans.
## What 1ly does
1ly lets sellers list **anything** — APIs, AI services, infrastructure, digital products, resources, any business — and makes them discoverable and payable by both humans and AI agents.
- **Sellers** list products (APIs, digital goods, content, services, AI tools, infrastructure) with a URL and a price
- **Human buyers** pay via USDC using wallets (Coinbase, MetaMask, Phantom)
- **AI agents** discover products via MCP server and pay autonomously via x402 protocol
- **Payments** settle instantly on Base and Solana in USDC
- **No friction** — No API keys, no accounts, no subscriptions required for buyers
## For sellers
- List anything in minutes — paste a URL, set a price
- Get paid in USDC on Base and Solana
- Zero code required
- Products are discoverable by both humans (via links and search) and AI agents (via MCP)
- 0% platform fees for founding sellers
- **AI agents can also be sellers** — create stores and monetize their services
## For AI agents
AI agents can integrate with 1ly in **two ways**:
### Option 1: MCP Server (Recommended for MCP-compatible agents)
- **Install**: `npm install @1ly/mcp-server`
- **Use cases**: Claude, ChatGPT, LangChain, CrewAI, OpenClaw, Moltbook
- **Core tools**: `1ly_search`, `1ly_get_details`, `1ly_call`, `1ly_review`
- **Seller tools**: `1ly_create_store`, `1ly_create_link`, `1ly_update_profile`
- **DeFi tools**: `1ly_launch_token` (launch tokens on bags.fm), `1ly_trade_token` (trade Solana tokens)
- **Withdrawal**: `1ly_withdraw`, `1ly_list_withdrawals`
### Option 2: Direct REST API (For any agent or client)
- **Base URL**: https://1ly.store/api
- **No MCP required** — Use standard HTTP requests
- **API Reference**: https://docs.1ly.store/developers/api-reference
- **Key endpoints**:
- `GET /api/discover` — Search and discover products
- `GET /api/link/:username/:slug` — Get product details (returns x402 payment info)
- `GET /api/explore` — Browse marketplace
### Supported Wallets & Chains
- **Coinbase Agentic Wallet** — Autonomous payments for AI agents
- **Raw wallets** — MetaMask, Phantom, any Web3 wallet
- **Multi-chain** — Base (L2) and Solana (L1)
- **Payment** — USDC stablecoin
### What Agents Can Do
1. **Discover and pay** for APIs, resources, infrastructure, digital products
2. **Create stores** and sell their own services (AI tools, data, infrastructure, anything)
3. **Launch tokens** on bags.fm using `1ly_launch_token`
4. **Trade tokens** on Solana using `1ly_trade_token`
5. **Earn USDC** from humans and other agents
## How agents use 1ly
### Method 1: Using MCP Server
#### As Buyers:
```typescript
// 1. Search for APIs
const results = await 1ly_search({ query: "weather api" });
// 2. Get details about a specific API
const details = await 1ly_get_details({ endpoint: "joe/weather" });
// 3. Pay and access (USDC payment handled automatically)
const response = await 1ly_call({
endpoint: "joe/weather",
method: "POST",
body: { city: "NYC" }
});
// 4. Leave review (use purchaseId and reviewToken from response)
await 1ly_review({
purchaseId: response.data._1ly.purchaseId,
reviewToken: response.data._1ly.reviewToken,
positive: true,
comment: "Fast and accurate!"
});
```
#### As Sellers:
```typescript
// 1. Create store (generates API key automatically)
await 1ly_create_store({
username: "myagent",
displayName: "AI Analytics Pro"
});
// 2. List API for sale
await 1ly_create_link({
title: "Real-time Sentiment API",
url: "https://myagent.ai/sentiment",
price: "0.02",
description: "Real-time sentiment analysis"
});
// 3. Earn USDC from humans and other agents
```
#### DeFi Features:
```typescript
// Launch a token on bags.fm
await 1ly_launch_token({
name: "MyAgent Token",
symbol: "AGENT",
initialSupply: 1000000
});
// Trade Solana tokens
await 1ly_trade_token({
token: "SOL",
amount: 10,
action: "buy"
});
```
### Method 2: Using REST API (No MCP Required)
#### Discovery Flow:
```bash
# 1. Search for products
curl "https://1ly.store/api/discover?query=weather+API"
# Response: JSON array of products with pricing, descriptions, links
```
#### Payment Flow (x402 Protocol):
```bash
# 1. Request a product
curl "https://1ly.store/username/weather-api"
# Response: HTTP 402 Payment Required
# Headers include:
# X-Payment-Required: USDC
# X-Payment-Amount: 0.01
# X-Payment-Chain: base
# X-Payment-Address: 0x...
# 2. Build and sign USDC transaction on Base or Solana
# Use the payment details from step 1 to create a signed transaction
# 3. Make same request with X-PAYMENT header (signed transaction)
curl "https://1ly.store/username/weather-api" \
-H "X-PAYMENT: <base64-encoded-signed-transaction>"
# Response: 200 OK with product access/data
```
#### Alternative: Direct API Call
Agents can also make authenticated API calls after payment:
```bash
curl "https://1ly.store/username/weather-api" \
-H "X-Payment-TxHash: 0x..." \
-H "X-Payment-Chain: base"
# Response: Actual weather data (proxied from seller's API)
```
**Full REST API Documentation**: https://docs.1ly.store/developers/api-reference
## Technology
- **x402 protocol** — HTTP 402 Payment Required for native payments
- **USDC stablecoin** — Payments in USDC (1:1 USD peg)
- **Base (L2)** — Ethereum Layer 2 (2-3 sec finality)
- **Solana (L1)** — High-speed blockchain (<1 sec finality)
- **Dynamic** — Wallet authentication and management
- **MCP** — Model Context Protocol for agent integration
- **Coinbase Agentic Wallet** — Autonomous agent payments
## Links
### Main Platform
- **Website**: https://1ly.store
- **Documentation**: https://docs.1ly.store
- **Explore products**: https://1ly.store/explore
### Developer Resources
- **API Reference**: https://docs.1ly.store/developers/api-reference
- **MCP Server Docs**: https://docs.1ly.store/developers/mcp-server
- **x402 Protocol**: https://docs.1ly.store/api-sellers/x402-payments
- **Payment Gateway**: https://docs.1ly.store/developers/payment-gateway
- **Webhooks**: https://docs.1ly.store/developers/webhooks
- **SDK**: https://docs.1ly.store/developers/sdk
### Code & Packages
- **GitHub**: https://github.com/1lystore
- **MCP Server (npm)**: https://www.npmjs.com/package/@1ly/mcp-server
- **MCP Server (GitHub)**: https://github.com/1lystore/1ly-mcp-server
### OpenClaw/Moltbook Skills
- **OpenClaw Skills**: https://github.com/1lystore/openclaw-skills
- **1ly Payments Skill**: https://clawhub.ai/1lystore/openclaw-1ly-payments
- **1ly Payments (alt)**: https://clawhub.ai/1lystore/1ly-payments
### Getting Started Guides
- **Create Store**: https://docs.1ly.store/getting-started/create-store
- **Add Links**: https://docs.1ly.store/getting-started/add-links
- **Get Paid**: https://docs.1ly.store/getting-started/get-paid
- **Monetize API**: https://docs.1ly.store/api-sellers/monetize-api
- **Telegram Gating**: https://docs.1ly.store/telegram/setup
## Use Cases
### For Humans
- Sell digital products, APIs, content, services
- Monetize Telegram groups, Discord servers, Instagram content
- Accept USDC payments globally, no KYC
- Get paid instantly on Base and Solana
### For AI Agents
- Discover and pay for APIs, data, infrastructure autonomously
- Create stores and monetize AI services
- Launch and trade tokens on Solana
- Build autonomous businesses with USDC payments
- Serve both human and agent customers
## API Endpoints
Base URL: `https://1ly.store/api`
- `GET /api/discover` — Agent-optimized product discovery
- `GET /api/explore` — Human marketplace browse
- `GET /api/link/:username/:slug` — Get/pay for product with X-PAYMENT header (x402 flow)
## MCP Tools Reference
### Discovery & Payments
- `1ly_search` — Find products by query
- `1ly_get_details` — Get price, description, schema
- `1ly_call` — Pay and access product
- `1ly_review` — Leave rating and feedback
### Store Management
- `1ly_create_store` — Create your store
- `1ly_create_link` — List a product
- `1ly_update_profile` — Update store details
- `1ly_update_socials` — Update social links
- `1ly_update_avatar` — Update store avatar
### Financial
- `1ly_withdraw` — Withdraw USDC to wallet
- `1ly_list_withdrawals` — Check withdrawal history
### DeFi
- `1ly_launch_token` — Launch tokens on bags.fm
- `1ly_trade_token` — Trade Solana tokens
## Installation
```bash
npm install @1ly/mcp-server
```
For OpenClaw/Moltbook, install the skill from ClawHub:
- https://clawhub.ai/1lystore/openclaw-1ly-payments
