1lystore MCP

@1ly/mcp-server

MCP server for 1ly.store — Enable AI agents to discover, pay for, and sell APIs using crypto.

Overview

This MCP server gives AI agents the ability to:

• Buy — Search, discover, and pay for APIs/resources with automatic crypto payments (x402 protocol)
• Sell — Create a store, list paid API endpoints or resources, and accept payments
• Launch Tokens — Create and trade tokens on Bags.fm, and claim fee shares

Supported Networks: Solana (mainnet), Base (mainnet) Payment Currency: USDC and $1LY (Solana only)

What is this?

This MCP server enables AI agents (Claude, GPT, Cursor, and more) to:

• Create a store on 1ly.store
• Accept payments for your APIs/resources using 1ly as the payment layer
• Create paid links that any x402‑compatible agent can call and pay automatically
• List paid links on the 1ly marketplace for instant agent discovery
• Search for APIs and services on 1ly.store
• Get details about pricing, reviews, and usage
• Call paid APIs with automatic crypto payments (x402 protocol) securely
• Leave reviews after purchases (optional but recommended)
• Launch tokens on Bags.fm, trade solana tokens, and claim fees

Quick Start

Wallet path rule: wallet files must be located in your home directory (recommended) or /tmp. Paths outside those locations are rejected for security. ~/ is supported and expands to your home directory when running directly from the terminal. Important: Claude Desktop and Cursor config JSON do not expand ~. Always use absolute paths in JSON config files (e.g. /Users/yourname/.1ly/wallets/solana.json).

1. Install and Run

Option A: Raw Wallet (default)

# Solana wallet

ONELY_WALLET_SOLANA_KEY="~/.1ly/wallets/solana.json" npx @1ly/mcp-server

OR Base/EVM wallet

ONELY_WALLET_EVM_KEY="~/.1ly/wallets/evm.key" npx @1ly/mcp-server

OR both wallets

ONELY_WALLET_SOLANA_KEY="~/.1ly/wallets/solana.json" \ ONELY_WALLET_EVM_KEY="~/.1ly/wallets/evm.key" \ npx @1ly/mcp-server

Option B: Coinbase Agentic Wallet (Base only)

ONELY_WALLET_PROVIDER="coinbase" npx @1ly/mcp-server

When using Agentic Wallet, you do not pass raw private keys.

Make sure the Coinbase Agentic Wallet app is running and authenticated.

If you haven't installed Agentic Wallet yet:

• Follow Coinbase Agentic Wallet docs: docs.cdp.coinbase.com/agentic-wallet/welcome
• Quick install:

npx skills add coinbase/agentic-wallet-skills

npx awal show

Option C: DCP Local (recommended for secure signing)

# Start DCP locally

dcp init npx @dcprotocol/server

Run MCP (auto-detects DCP at localhost:8420)

npx @1ly/mcp-server

Option D: DCP Remote (relay)

# Pairing outputs these values

DCP_VAULT_ID="vault_..." \ DCP_RELAY_URL="wss://relay.dcp.1ly.store" \ DCP_VAULT_HPKE_PUBLIC_KEY="base64..." \ npx @1ly/mcp-server

2. Verify Setup

ONELY_WALLET_SOLANA_KEY="~/.1ly/wallets/solana.json" npx @1ly/mcp-server --self-test

Configuration

HTTP Mode (Cloud MCP)

Run MCP over HTTP (for cloud hosting or mcp.1ly.store):

# HTTP transport

MCP_TRANSPORT=http npx @1ly/mcp-server

Custom host/port

MCP_TRANSPORT=http MCP_HTTP_HOST=0.0.0.0 MCP_HTTP_PORT=3000 npx @1ly/mcp-server

Environment Variables

*A wallet is required only for paid calls. For free search/details you can run without a wallet.* Use one of: ONELY_WALLET_SOLANA_KEY, ONELY_WALLET_EVM_KEY, or ONELY_WALLET_PROVIDER=coinbase.

Claude Desktop Configuration

Add to claude_desktop_config.json:

{

"mcpServers": { "1ly": { "command": "npx", "args": ["@1ly/mcp-server"], "env": { "ONELY_WALLET_SOLANA_KEY": "/Users/yourname/.1ly/wallets/solana.json", "ONELY_BUDGET_PER_CALL": "1.00", "ONELY_BUDGET_DAILY": "50.00" } } } }

Note: Replace /Users/yourname with your actual home directory. On Linux use /home/yourname. ~ does not work in Claude Desktop config.

Base/EVM wallet configuration

{

"mcpServers": { "1ly": { "command": "npx", "args": ["@1ly/mcp-server"], "env": { "ONELY_WALLET_EVM_KEY": "/Users/yourname/.1ly/wallets/evm.key", "ONELY_BUDGET_PER_CALL": "1.00", "ONELY_BUDGET_DAILY": "50.00" } } } }

</details>

Cursor One-Click Install

Cursor uses .cursor/mcp.json. If you prefer manual setup, use:

{

"mcpServers": { "1ly": { "command": "npx", "args": ["@1ly/mcp-server"], "env": { "ONELY_WALLET_SOLANA_KEY": "/absolute/path/to/solana.json", "ONELY_BUDGET_PER_CALL": "1.00", "ONELY_BUDGET_DAILY": "50.00" } } } }

<details>

Both Solana + Base wallets

{

"mcpServers": { "1ly": { "command": "npx", "args": ["@1ly/mcp-server"], "env": { "ONELY_WALLET_SOLANA_KEY": "~/.1ly/wallets/solana.json", "ONELY_WALLET_EVM_KEY": "~/.1ly/wallets/evm.key", "ONELY_BUDGET_PER_CALL": "1.00", "ONELY_BUDGET_DAILY": "50.00" } } } }

</details>

Tools Reference

Buyer Tools

Wallet required only for paid calls (1ly_call). Search/details work without a wallet.

1ly_search

Search for APIs on 1ly.store marketplace.

{

"query": "weather api", "type": "api", "maxPrice": 0.10 }

Returns:

{

"ok": true, "data": { "results": [ { "title": "Real-time Weather", "endpoint": "/api/link/joe/weather", "price": "$0.010000000000000000 USDC", "type": "api", "seller": "Joe's APIs", "stats": { "buyers": 150, "rating": "95%" } } ], "total": 42, "showing": 10 } }

1ly_get_details

Get detailed information about a specific API.

{

"endpoint": "joe/weather" }

Returns (example):

{

"ok": true, "data": { "endpoint": "/api/link/joe/weather", "fullUrl": "https://1ly.store/api/link/joe/weather", "link": { "title": "Real-time Weather", "description": "Global weather data", "slug": "weather", "price": "0.010000000000000000", "currency": "USDC" }, "paymentInfo": { "networks": ["solana", "base"] }, "reviews": { "stats": { "total": 50, "positive": 48 }, "recent": [{ "positive": true, "comment": "Fast!" }] } } }

1ly_call

Call a paid API with automatic crypto payment.

{

"endpoint": "joe/weather", "method": "POST", "body": { "city": "NYC" } }

Returns (example):

{

"ok": true, "data": { "data": { "temp": 72, "conditions": "sunny" }, "_1ly": { "purchaseId": "abc123", "txHash": "tx_hash_here", "reviewUrl": "https://1ly.store/api/review/abc123", "reviewToken": "xyz789" } } }

Note: The _1ly object contains tokens needed for 1ly_review. Save these if you want to leave a review.

For free APIs, _1ly may be { "note": "No payment required (free API)" }.

Agentic Wallet (Base only):

• Set ONELY_WALLET_PROVIDER=coinbase.
• Ensure Coinbase Agentic Wallet is installed, running, and authenticated.
• Local private keys are not required.

1ly_review

Leave a review after a successful purchase.

{

"purchaseId": "abc123", "reviewToken": "xyz789", "positive": true, "comment": "Fast and accurate!" }

Returns:

{

"ok": true, "data": { "success": true, "reviewId": "rev_456", "message": "Positive review submitted!" } }

Seller Tools (Accept Payments)

These tools require an API key. There are two ways to get one:

Option A — Via MCP tool (agent does it for you): Run 1ly_create_store and the key is automatically saved locally.

Option B — Via UI (no wallet needed):

1. Go to 1ly.store and sign in
2. Open Settings → enable Developer Mode
3. Create an API key from the dashboard
4. Set it as ONELY_API_KEY in your MCP config

1ly_create_store

Create a new store and get an API key. Run this once. The API key is automatically saved locally.

Note: Creating a store requires a raw wallet key (Solana or EVM). Agentic Wallet does not support store creation yet.

| username | string