mcp-server

MCP server for 1ly.store — buy/sell APIs and launch tokens on Bags.fm with USDC & $1LY.

stdio v0.1.7

Connection Configuration

Add this to your AI agent's MCP config file to connect.

Run in your terminal:

claude mcp add io.github.1lystore--mcp-server -- npx

Server Details

Transport

stdio

Authentication

None

Version

v0.1.7

Server Name

io.github.1lystore/mcp-server

Last Updated

Feb 18, 2026

Get Started

How to install and connect this MCP server.

Required Configuration

Environment variables you must provide when running this server.

Variable	Description	Required
`ONELY_WALLET_SOLANA_KEY` secret	Path to Solana keypair JSON file (e.g. /home/user/.1ly/wallets/solana.json) or inline JSON byte array. Required for paid API calls and token tools (launch, trade, claim). Note: Claude Desktop does not expand ~, use absolute paths.	Optional
`ONELY_WALLET_EVM_KEY` secret	Path to EVM private key file or 0x-prefixed hex string. Required for payments on Base network.	Optional
`ONELY_API_KEY` secret	1ly.store seller API key. Auto-saved locally after running the 1ly_create_store tool — you do not need to set this manually. Required for seller tools: manage links, stats, withdrawals, keys, and profile.	Optional
`ONELY_WALLET_PROVIDER`	Wallet provider to use. 'raw' (default) uses local key files via ONELY_WALLET_SOLANA_KEY or ONELY_WALLET_EVM_KEY. 'coinbase' uses Coinbase Agentic Wallet (Base network only, requires the wallet app running locally).	Optional
`ONELY_NETWORK`	Preferred blockchain network for payments. 'solana' (default) or 'base'. Determines which wallet is used when an API supports both networks.	Optional
`ONELY_SOLANA_RPC_URL`	Solana RPC endpoint URL. Defaults to https://api.mainnet-beta.solana.com. Use a private RPC (e.g. Helius, Quicknode) for better reliability and rate limits.	Optional
`ONELY_BUDGET_PER_CALL`	Maximum USD amount allowed per single paid API call. Defaults to 1.00. The server will refuse any call priced above this limit.	Optional
`ONELY_BUDGET_DAILY`	Maximum total USD spending per calendar day (UTC). Defaults to 50.00. Resets at UTC midnight. The server will refuse calls that would exceed this limit.	Optional
`ONELY_BUDGET_STATE_FILE`	Path to the local JSON file used to track daily spending. Defaults to ~/.1ly-mcp-budget.json. Created automatically with owner-only permissions (0600).	Optional
`ONELY_SOLANA_DRY_RUN`	Set to '1' to simulate Solana transactions without broadcasting to the blockchain. Returns a fake signature. Use for testing only — no real payments will be made.	Optional
`ONELY_API_BASE`	Override the 1ly.store API base URL. Defaults to https://1ly.store. Only http://localhost:PORT is accepted as an alternative (for local development). Do not change in production.	Optional

mcp-server

Connection Configuration

Server Details

Get Started

npm / npx

Required Configuration