1ly MCP Server

What is 1ly MCP Server?

1ly MCP Server is an MCP server for 1ly.store that enables AI agents to discover, pay for, and sell APIs using cryptocurrency. It supports Solana (mainnet) and Base (mainnet) networks, with USDC and $1LY (Solana only) as payment currencies.

How to use 1ly MCP Server?

Install via npx @1ly/mcp-server with required environment variables for wallet keys (Solana, EVM, or Coinbase Agentic Wallet). Configure budgets and network preferences via environment variables. Use tools like 1ly_search, 1ly_get_details, 1ly_call, 1ly_review, 1ly_create_store, and others to interact with the marketplace. A wallet is required only for paid operations.

Key features of 1ly MCP Server

• Search and discover APIs on the 1ly.store marketplace
• Pay for APIs automatically with crypto via the x402 protocol
• Create a store to list paid API endpoints and accept payments
• Launch and trade tokens on Bags.fm, claim fee shares
• Leave reviews after purchases
• Supports both Solana and Base networks

Use cases of 1ly MCP Server

• An AI agent calls a paid weather API and pays automatically with USDC
• A developer creates a store on 1ly.store to sell their API endpoints
• An agent searches for and compares multiple APIs before purchasing
• An AI agent launches a token on Bags.fm and trades it

FAQ from 1ly MCP Server

What networks and currencies are supported?

Solana (mainnet) and Base (mainnet) are supported. Payment currencies are USDC and $1LY (Solana only).

Do I need a wallet to use the server?

A wallet is required only for paid calls (e.g., 1ly_call). Free search and details work without a wallet.

How do I set up a wallet?

You can use a raw wallet file (Solana keypair JSON or EVM private key) or the Coinbase Agentic Wallet (Base-only). Set path via ONELY_WALLET_SOLANA_KEY, ONELY_WALLET_EVM_KEY, or ONELY_WALLET_PROVIDER=coinbase.

What is the x402 protocol?

The x402 protocol enables automatic crypto payments for API calls. The server handles the payment process when calling paid APIs via 1ly_call.

Where are wallets and budget state files stored?

Wallet files must be in the home directory or /tmp. Budget state defaults to ~/.1ly-mcp-budget.json. Absolute paths are required in Claude Desktop or Cursor config files (tilde expansion is not supported there).