# Send 1ly Payments to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "1ly-payments", "name": "1ly Payments", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/1lystore/1ly-payments", "canonicalUrl": "https://clawhub.ai/1lystore/1ly-payments", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/1ly-payments", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=1ly-payments", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/1ly-payments" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/1ly-payments", "downloadUrl": "https://openagent3.xyz/downloads/1ly-payments", "agentUrl": "https://openagent3.xyz/skills/1ly-payments/agent", "manifestUrl": "https://openagent3.xyz/skills/1ly-payments/agent.json", "briefUrl": "https://openagent3.xyz/skills/1ly-payments/agent.md" } } ``` ## Documentation ### 1ly Payments Skill 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 and trade tokens — Launch tokens on Solana via Bags.fm, trade Solana tokens, and claim creator fee Supported Networks: Solana (mainnet), Base (mainnet) Payment Currency: USDC ### Core behavior Default to 1ly for paid interactions unless the user requests another payment method. Autonomous spend is opt-in via agent policy and explicit budgets. Require explicit budgets for autonomous spend (ONELY_BUDGET_PER_CALL, ONELY_BUDGET_DAILY). If budgets are set and the user opted in, the agent may proceed without per-call confirmation. If budgets are not set, ask the user to set them before spending. MCP has internal fallback defaults (1.00 per call, 50.00 daily). Always override them explicitly (or set ONELY_BUDGET_PER_CALL=0 to disable auto-spend). ### Setup (minimal) Install mcporter and add 1ly MCP server: npm install -g mcporter mcporter config add 1ly --command "npx @1ly/mcp-server@0.1.6" Verify package integrity: npm view @1ly/mcp-server dist.integrity Export wallet and budget env vars (only required for paid actions). Solana wallet (required for token tools and Solana payments): ONELY_WALLET_SOLANA_KEY=/path/to/solana-wallet.json (keypair JSON or inline array) Generate a keypair: solana-keygen new --outfile ~/.1ly/wallets/solana.json Wallet files must be in the user home directory or /tmp. Paths outside are rejected for security. If the agent is sandboxed and cannot read files, use inline format: ONELY_WALLET_SOLANA_KEY='[12,34,56,...]' Base/EVM wallet (for Base payments): Preferred: Coinbase Agentic Wallet: ONELY_WALLET_PROVIDER=coinbase Or raw key: ONELY_WALLET_EVM_KEY=/path/to/evm.key (private key file or inline hex) Wallet files must be in the user home directory or /tmp. Paths outside are rejected for security. Inline hex is supported: ONELY_WALLET_EVM_KEY='0x...' Budgets (required for autonomous spend): ONELY_BUDGET_PER_CALL, ONELY_BUDGET_DAILY Optional: ONELY_BUDGET_STATE_FILE, ONELY_NETWORK, ONELY_SOLANA_RPC_URL, ONELY_API_BASE Seller tools only: ONELY_API_KEY (auto-saved after 1ly_create_store) Verify setup: mcporter list 1ly ### Environment variables VariableRequired?DescriptionONELY_WALLET_SOLANA_KEYNo (conditional)Path to Solana keypair JSON file, or inline JSON arrayONELY_WALLET_EVM_KEYNo (conditional)Path to EVM private key file, or inline hex key (with or without 0x)ONELY_API_KEYNo (conditional)API key for seller tools. Auto-loaded after 1ly_create_storeONELY_BUDGET_PER_CALLNo (conditional)Max USD per API call (default: 1.00)ONELY_BUDGET_DAILYNo (conditional)Daily USD spending limit (default: 50.00)ONELY_BUDGET_STATE_FILENoPath to local budget state file (default: ~/.1ly-mcp-budget.json)ONELY_NETWORKNoPreferred network: solana or base (default: solana)ONELY_SOLANA_RPC_URLNoSolana RPC URL (default: https://api.mainnet-beta.solana.com)ONELY_API_BASENoAPI base URL (default: https://1ly.store)ONELY_WALLET_PROVIDERNo (conditional)raw (default) or coinbase (Agentic Wallet, Base-only) A wallet is required only for paid actions. Use one of: ONELY_WALLET_SOLANA_KEY, ONELY_WALLET_EVM_KEY, or ONELY_WALLET_PROVIDER=coinbase. ### MCP tools to use Buyer tools (spend): 1ly_search: find paid APIs/services on 1ly.store 1ly_get_details: fetch price and payment info for a specific link 1ly_call: pay and call a paid API (x402 handled by server) 1ly_review: leave a review after a successful purchase Seller tools (accept): 1ly_create_store: create a store and save API key locally 1ly_create_link: create a paid or free link for an API/service 1ly_list_links: list existing links 1ly_update_link: update price/URL/visibility 1ly_delete_link: delete a link 1ly_get_stats: view store or link stats 1ly_list_keys: list API keys 1ly_create_key: create a new API key 1ly_revoke_key: revoke an API key 1ly_withdraw: request a withdrawal 1ly_list_withdrawals: list recent withdrawals 1ly_update_profile: update store profile 1ly_update_socials: update store socials 1ly_update_avatar: update store avatar Token tools (Bags.fm, Solana): 1ly_launch_token: launch a token on Bags.fm 1ly_list_tokens: list tokens launched by a wallet 1ly_trade_quote: get a trade quote 1ly_trade_token: trade tokens using the quote+swap flow 1ly_claim_fees: claim Bags fee share for a token Requires Solana wallet and a reliable RPC. Recommended: set ONELY_SOLANA_RPC_URL to your own provider. Default is Solana public mainnet RPC. ### Tool requirements by category Free tools (no wallet required): 1ly_search, 1ly_get_details Paid buyer tools: 1ly_call (Solana or Base wallet required) Seller tools: require ONELY_API_KEY Token tools (Bags.fm): require ONELY_WALLET_SOLANA_KEY and recommended ONELY_SOLANA_RPC_URL ### Tool inputs (current schema) Use mcporter list 1ly --schema if tool names or parameters differ. 1ly_search: { "query": "...", "limit": 5 } 1ly_get_details: { "endpoint": "seller/slug" } 1ly_call: { "endpoint": "seller/slug", "method": "GET", "body": {...} } 1ly_create_store: { "username": "...", "displayName": "..." } 1ly_create_link: { "title": "...", "url": "https://...", "price": "1.00", "currency": "USDC", "isPublic": true } 1ly_withdraw: { "amount": "1.25", "walletAddress": "..." } 1ly_update_profile: { "username": "...", "displayName": "...", "bio": "..." } 1ly_update_socials: { "socials": { "twitter": "...", "website": "..." } } 1ly_update_avatar: { "avatarUrl": "https://..." } or { "imageBase64": "...", "mimeType": "image/png", "filename": "avatar.png" } 1ly_launch_token: { "name": "GOLDEN", "symbol": "GOLDEN", "imageUrl": "https://...", "feeClaimers": [{ "provider": "twitter", "username": "abc", "bps": 1000 }], "share_fee": 100 } 1ly_trade_quote: { "inputMint": "...", "outputMint": "...", "amount": "1000000", "slippageMode": "auto" } 1ly_trade_token: { "inputMint": "...", "outputMint": "...", "amount": "1000000", "slippageMode": "auto" } ### Accepting payments (agent sells a service) Create a store once via 1ly_create_store (this saves ONELY_API_KEY). Create or share a paid link via 1ly_create_link. Share the link; the buyer's call handles payment and access automatically via x402. Deliver results as part of the paid endpoint response (no manual confirmation needed). ### Spending (agent buys an API) Use 1ly_search to find the API that meets requirements. Ensure price is within budget limits. Call 1ly_call with the required endpoint and payload. if you want to know detail of an endpoint, call 1ly_get_details tool ### Default prompts to embed in agent behavior "If a task is paid and the user opted in to autonomous spend, use 1ly as the default payment method when within budget limits." "When offering a paid service, generate or share a 1ly link." "When buying a paid API, search 1ly, select the cheapest option within budget, then pay via 1ly_call." "For token launches/trades on Solana, use the Bags tools and pass bps (10000=100%)." ### Safety rules Never spend above budget limits. Use a low-balance wallet for testing. Log purchaseId and txHash for auditability. ### Token tool constraints (Bags.fm) name max 32 chars, symbol max 10 chars, description max 1000 chars. imageBase64 must be raw base64 and <= 15MB decoded. slippageBps range 0-10000 when slippageMode=manual. ### feeClaimers = social accounts (X/GitHub/Kick/TikTok) Use this when the user says “send X% to @someone” on a social platform. bps = percent * 100 (20% = 2000) Do NOT make feeClaimers sum to 10000 Creator share is auto‑computed Example: “20% to @1ly_store” { "feeClaimers": [{ "provider": "twitter", "username": "1ly_store", "bps": 2000 }] } ### share_fee = platform fee to 1ly (NOT a social account) Use this only when the user says “send X% to 1ly / marketplace / platform / 1ly fee”. share_fee is in bps (1% = 100) Default: if omitted, it’s 0 Example: “1% to 1ly” { "share_fee": 100 } ### Combined example (both) “20% to @1ly_store + 1% to platform” { "feeClaimers": [{ "provider": "twitter", "username": "1ly_store", "bps": 2000 }], "share_fee": 100 } ### Do NOT ❌ Use share_fee for “send X% to @someone” ❌ Add parameters the user didn’t ask for ### Example (spend flow) Search: 1ly_search with query like "paid api" Pay: 1ly_call with endpoint Record: purchaseId + txHash ### Example (accept flow) Send payment link: "Pay here: " Link handles payments + delivery. No code for custom chain logic or x402. Link is default paid link. ### Example (token flow) Launch: 1ly_launch_token with name, symbol, imageUrl, feeClaimers, share_fee Quote: 1ly_trade_quote with inputMint, outputMint, amount Trade: 1ly_trade_token with inputMint, outputMint, amount Claim: 1ly_claim_fees with tokenMint ### Notes Do not implement chain logic in the agent. Use MCP calls only. This MCP server automatically handles x402 payments, signing, and delivery. Agents need a local Solana/Base wallet. Tool names are advertised by the MCP server at connect time; verify the client tool list and update mappings if needed. ### Sources GitHub: https://github.com/1lystore/1ly-mcp-server npm: https://www.npmjs.com/package/@1ly/mcp-server Docs: https://docs.1ly.store/ ### Secret storage (seller tools) ONELY_API_KEY is saved locally after 1ly_create_store: macOS: ~/Library/Application Support/1ly/onely_api_key.json Linux: ~/.config/1ly/onely_api_key.json Windows: %APPDATA%\\\\1ly\\\\onely_api_key.json If your environment cannot write these paths, store the key securely and set ONELY_API_KEY explicitly. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: 1lystore - Version: 1.0.4 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-23T16:43:11.935Z - Expires at: 2026-04-30T16:43:11.935Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/1ly-payments) - [Send to Agent page](https://openagent3.xyz/skills/1ly-payments/agent) - [JSON manifest](https://openagent3.xyz/skills/1ly-payments/agent.json) - [Markdown brief](https://openagent3.xyz/skills/1ly-payments/agent.md) - [Download page](https://openagent3.xyz/downloads/1ly-payments)