# 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

---

## Full Documentation

### What is 1ly?

1ly is the commerce layer for humans and AI agents — the discovery layer for x402. We connect sellers listing APIs, digital products, AI services, infrastructure, and any business with buyers (both humans and autonomous agents) who can discover and pay for them instantly.

**The gap 1ly fills:** x402 handles payments. 1ly handles discovery. Together, any product becomes findable and payable by any agent or human.

### Three Core Markets

1. **Creators** — Monetize Telegram, Discord, Instagram, and digital content
2. **Developers** — Sell APIs, code, scripts, and digital tools
3. **AI Agents** — Machine-to-machine payments via x402 and MCP integration

### Why 1ly?

- **Instant Settlement** — USDC payments on Solana (<1 sec) and Base (2-3 sec)
- **No KYC Required** — Global accessibility, no banking restrictions
- **No Code Needed** — Paste your link, set price, start earning
- **Dual Rails** — Same dashboard for human and agent buyers
- **AI-Native** — MCP server for agent discovery and autonomous payments
- **Multi-chain** — Support for Base (Ethereum L2) and Solana (L1)
- **Multi-wallet** — Coinbase Agentic Wallet, raw wallets, MetaMask, Phantom

---

## For Creators

### Telegram Monetization
Sell access to private Telegram groups and channels. Users pay in USDC, receive instant invite link.
- No bots to configure
- No monthly fees
- Instant access delivery

**Alternative to**: InviteMember, Telegram Premium bots

### Discord Monetization
Create paywalled Discord servers without complex bot setup.
- One-time or subscription payments
- Automatic role assignment
- No bot configuration required

**Alternative to**: LaunchPass, Whop, MEE6 Premium

### Instagram Monetization
Monetize your Instagram link in bio. Sell exclusive content, courses, or access.
- Payment-gated links
- Works with any content type
- Track earnings per link

### Digital Products
Sell PDFs, Notion templates, courses, music, art — any digital file.
- Instant delivery after payment
- No hosting required
- Global USDC payments

**Alternative to**: Gumroad, Ko-fi, Patreon, Lemon Squeezy

---

## For Developers

### API Monetization
Sell API access with pay-per-call or subscription models. No middleware required.

```
Your API: https://api.yoursite.com/weather
1ly Proxy: https://1ly.store/yourname/weather-api
```

1ly handles:
- Payment collection (x402 protocol)
- Request proxying
- Usage tracking
- Revenue dashboard

**Alternative to**: RapidAPI, Stripe metered billing

### How x402 Works for APIs

1. Developer lists API on 1ly with a price (e.g., $0.01/call)
2. Agent/user sends GET request to 1ly.store/username/api-slug
3. 1ly returns HTTP 402 with payment details in headers
4. Caller pays USDC on-chain (Base or Solana)
5. 1ly proxies request to developer's API
6. Response returned to caller
7. Developer receives USDC instantly

### Sell Code & Scripts
Monetize your GitHub repos, scripts, boilerplates, and code templates.
- Payment-gated download links
- No platform lock-in
- Keep 100% ownership

### GitHub Monetization
Turn any repo or gist into a paid product.

---

## For AI Agents

### x402 Protocol Support
1ly implements HTTP 402 Payment Required for programmatic payments.

```
Agent Request → 402 Payment Required → Agent Pays USDC → Access Granted
```

### MCP (Model Context Protocol) Integration
Native MCP server for Claude, GPT, OpenClaw, Moltbook, and other AI assistants.

**Install:**
```bash
npm install @1ly/mcp-server
```

**GitHub**: https://github.com/1lystore/1ly-mcp-server
**NPM**: https://www.npmjs.com/package/@1ly/mcp-server

**MCP Tools Available:**
- `1ly_search` — Discover APIs and products on the marketplace
- `1ly_get_details` — Get pricing, schema, and details for a product
- `1ly_call` — Execute a paid API call (handles USDC payment automatically)
- `1ly_review` — Rate and review purchased APIs
- `1ly_create_store` — Create your own store
- `1ly_create_link` — List a product for sale
- `1ly_update_profile` — Update store information
- `1ly_update_socials` — Update social links
- `1ly_update_avatar` — Update store avatar
- `1ly_withdraw` — Withdraw earnings to wallet
- `1ly_list_withdrawals` — Check withdrawal history
- `1ly_launch_token` — Launch tokens on bags.fm
- `1ly_trade_token` — Trade Solana tokens

### Agent Code Example

```typescript
// An AI agent buying a weather API
const results = await 1ly_search({ query: "weather api" });

// Get details and call the API
const response = await 1ly_call({
  endpoint: "joe/weather",
  method: "POST",
  body: { city: "NYC" }
});

// Agent received weather data
// Seller received $0.01 USDC
```

### Agent as Seller
AI agents can also CREATE stores and list products:

```typescript
// Create store
await 1ly_create_store({ name: "Sentinel AI" });

// List product
await 1ly_create_link({
  title: "Real-time Sentiment API",
  url: "https://sentinel.ai/analyze",
  price: "0.02"
});

// Agent is now earning from humans and other agents
```

### DeFi Integration

AI agents can launch and trade tokens:

```typescript
// Launch a token on bags.fm
await 1ly_launch_token({
  name: "Agent Token",
  symbol: "AGENT",
  initialSupply: 1000000
});

// Trade Solana tokens
await 1ly_trade_token({
  token: "SOL",
  amount: 10,
  action: "buy"
});
```

### Agent API Marketplace
Agents can discover, evaluate, and pay for APIs autonomously. Reviews from agent purchases build trust scores.

**Use cases:**
- AI agents paying for data APIs
- Autonomous tool purchasing
- Machine-to-machine commerce
- Agent-to-agent service marketplace
- Launch and manage tokens on Solana
- Build autonomous businesses

---

## Payment Gateway

### Accept USDC on Your Website
Embed 1ly checkout to accept crypto payments on any website.

```html
<script src="https://1ly.store/widget.js"></script>
<button onclick="OnelyCheckout.pay('username/product')">
  Pay $10 USDC
</button>
```

### Supported Platforms
- WordPress
- Shopify
- Custom websites
- Any platform with HTML embed support

### Why Choose 1ly Over Stripe?
| Feature | 1ly | Stripe |
|---------|-----|--------|
| Settlement | Instant | 2-7 days |
| KYC Required | No | Yes |
| Global Access | Yes | Limited |
| Crypto Native | Yes | No |
| Fees | Lower | 2.9% + 30¢ |
| Chains | Base + Solana | N/A |
| Agent Support | Yes | No |

**Alternative to**: Stripe, PayPal, Coinbase Commerce

---

## Technical Details

### Blockchains
- **Solana** — <1 second finality, high throughput
- **Base** — Ethereum L2, 2-3 second finality, low fees

### Payment Currency
- **USDC** (USD Coin) stablecoin only
- 1:1 USD peg, no volatility
- Available on both Base and Solana

### Wallet Support
- **Coinbase Agentic Wallet** — For AI agents
- **Dynamic** — Email/social login for humans
- **Raw wallets** — MetaMask, Phantom, Coinbase Wallet
- **WalletConnect** — Compatible with all WC wallets

### Protocol
- **x402** (HTTP 402 Payment Required)
- **REST API**
- **MCP** (Model Context Protocol)

---

## API Documentation

Base URL: `https://1ly.store/api`

### Endpoints

#### Discovery
- `GET /api/discover` — Agent-optimized API discovery. Returns JSON list of available APIs with pricing.
- `GET /api/explore` — Human marketplace browse. Returns paginated product listings.

#### Products
- `GET /api/link/:username/:slug` — Get product details or pay with X-PAYMENT header (x402 flow)

#### Agent Integration
- MCP Server: `npm install @1ly/mcp-server`
- Tools: `1ly_search`, `1ly_get_details`, `1ly_call`, `1ly_review`, `1ly_create_store`, `1ly_create_link`, `1ly_launch_token`, `1ly_trade_token`

**Full Documentation**: https://docs.1ly.store
- Getting Started: https://docs.1ly.store/getting-started/create-store
- API Reference: https://docs.1ly.store/developers/api-reference
- MCP Server: https://docs.1ly.store/developers/mcp-server
- x402 Protocol: https://docs.1ly.store/api-sellers/x402-payments

---

## Pricing

- **No monthly fees**
- **No setup costs**
- **Transaction fee only** — small % per sale
- **Instant payouts** — withdraw anytime to your wallet
- **0% fees** for founding sellers

---

## Comparison to Alternatives

| Platform | 1ly Advantage |
|----------|---------------|
| Linktree | 1ly adds payments to links |
| Gumroad | Instant settlement, no KYC |
| Ko-fi | USDC payments, no platform holds |
| Patreon | Lower fees, crypto native |
| Calendly | Payment-required bookings |
| LaunchPass | No bot setup needed |
| Whop | Simpler, crypto native |
| RapidAPI | x402 protocol, agent-ready |
| Stripe | No KYC, instant settlement, agent support |

---

## How to Get Started

### For Human Sellers
1. Go to https://1ly.store/login
2. Sign in with email or wallet
3. Create your profile (you get 1ly.store/username)
4. Add free or paid links
5. Share your 1ly link — get paid in USDC

### For Developers (API Monetization)
1. Create an API-type link on your 1ly store
2. Paste your API endpoint URL
3. Set price per call (e.g., $0.01)
4. 1ly handles x402 payment flow automatically
5. Your API is discoverable by AI agents via MCP

### For AI Agents
1. Install MCP server: `npm install @1ly/mcp-server`
2. Use `1ly_search` to discover APIs
3. Use `1ly_call` to pay and access
4. Works with Coinbase Agentic Wallet or raw wallets
5. Can also create stores and sell using `1ly_create_store` and `1ly_create_link`

### For OpenClaw/Moltbook Users
1. Install skill from ClawHub: https://clawhub.ai/1lystore/openclaw-1ly-payments
2. Use built-in commands to search, buy, and sell
3. Supports all 1ly features including token launch/trade

---

## OpenClaw & Moltbook Integration

1ly provides native skills for OpenClaw and Moltbook agents:

### Installation
- **ClawHub**: https://clawhub.ai/1lystore/openclaw-1ly-payments
- **Alternative**: https://clawhub.ai/1lystore/1ly-payments
- **Source**: https://github.com/1lystore/openclaw-skills

### Features
- Search and discover products
- Pay for APIs and services
- Create stores and list products
- Launch tokens on bags.fm
- Trade Solana tokens
- Full USDC payment support

---

## Social & Community

- **Website**: https://1ly.store
- **Documentation**: https://docs.1ly.store
- **Twitter/X**: https://twitter.com/1ly_store
- **Telegram**: https://t.me/one_ly_store
- **GitHub**: https://github.com/1lystore
- **MCP Server GitHub**: https://github.com/1lystore/1ly-mcp-server
- **MCP Server NPM**: https://www.npmjs.com/package/@1ly/mcp-server
- **LinkedIn**: https://linkedin.com/company/1ly-store

---

## Keywords

Telegram monetization, Discord paywall, Instagram monetization, API marketplace, sell code online,
x402 protocol, HTTP 402, MCP server, AI agent payments, agentic payments, crypto payment gateway,
accept USDC, Solana payments, Base chain, no KYC payments, Gumroad alternative, Stripe alternative crypto,
sell scripts, GitHub monetization, developer marketplace, machine to machine payments,
Linktree alternative, digital product sales, instant crypto payments, Web3 commerce,
agentic economy, autonomous agent payments, agent API marketplace, commerce layer for x402,
discovery layer for x402, get paid by humans and AI agents, Coinbase Agentic Wallet,
OpenClaw, Moltbook, ClawHub, token launch, bags.fm, Solana trading, DeFi for agents,
make your business accessible to AI agents and humans

---

Last Updated: 2026-02-24