io.github.1lystore/mcp-server

Command

Environment

• ONELY_WALLET_SOLANA_KEYsecret

  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.

• ONELY_WALLET_EVM_KEYsecret

  Path to EVM private key file or 0x-prefixed hex string. Required for payments on Base network.

• ONELY_API_KEYsecret

  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.

• 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).

• ONELY_NETWORK

  Preferred blockchain network for payments. 'solana' (default) or 'base'. Determines which wallet is used when an API supports both networks.

• 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.

• 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.

• 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.

• 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).

• 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.

• 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.