1ly_call
Call a paid API on 1ly.store with automatic x402 payment. Returns the API response and purchase metadata for leaving a review.
LABSCO SUMMARY
Spending is capped in two places before a purchase is ever attempted, per call and per day.
ONELY_BUDGET_PER_CALL and ONELY_BUDGET_DAILY sit next to the wallet key in the configuration, which makes the agent's exposure a setting rather than a matter of restraint. The buying loop closes properly too: 1ly_call returns purchase metadata carrying a purchaseId and a reviewToken, and 1ly_review requires both, so a review is tied to a purchase that actually settled. Worth knowing before you install it: the surface covers two quite different jobs, buying and reselling APIs on one hand and launching, trading and claiming fees on Bags.fm tokens on the other, and the token tools are marked Bags-only rather than being a general trading interface.
What it is
An agent commerce client for 1ly.store: buying paid APIs with automatic x402 payment on one side, running your own store — links, keys, stats, payouts — on the other, plus a set of Bags.fm token tools.
What you get
- The buying side: 1ly_search across the marketplace filtered by type and price range, 1ly_get_details for one endpoint's pricing, reviews and payment info, 1ly_call, which settles payment over x402 automatically and returns the response with purchase metadata, and 1ly_review, which uses the purchaseId and reviewToken from that metadata.
- The selling side: 1ly_create_store from a wallet signature returning a store and an API key, 1ly_create_link for a paid or free API link with a price, slug, visibility and webhook, plus 1ly_update_link, 1ly_delete_link, 1ly_list_links and 1ly_get_stats per store or link.
- Store administration: 1ly_list_keys, 1ly_create_key and 1ly_revoke_key, with 1ly_update_profile, 1ly_update_socials and 1ly_update_avatar.
- Payouts: 1ly_withdraw to a named Solana wallet address, and 1ly_list_withdrawals for the requests already made.
- Bags.fm token tools: 1ly_launch_token handling metadata, fee configuration, the launch transaction, signing and submission, 1ly_list_tokens by creator wallet, 1ly_claim_fees for a token's fee share, and 1ly_trade_token with 1ly_trade_quote for a quote that executes nothing.
Requirements
ONELY_WALLET_SOLANA_KEY, the Solana wallet payments settle from, with ONELY_BUDGET_PER_CALL and ONELY_BUDGET_DAILY bounding what it may spend. An ONELY_API_KEY for the store-side tools: link management, keys, stats, withdrawals and profile updates each state that they require it. A wallet signature to create the store in the first place.
Setup effort
One command — npx @1ly/mcp-server
USE CASES
01
Buying a call from an API you have never used
The listing carries pricing and reviews before you commit, payment settles over x402 on the call itself, and the response comes back with the purchase metadata a review needs — so feedback is tied to a purchase that actually happened.
02
Putting your own API up for sale
A store is created from a wallet signature and returns its API key, then each endpoint becomes a link with its own price, slug, visibility and webhook. Stats are readable per link as well as per store.
03
Taking the balance out of the store
A withdrawal names an amount and a Solana wallet address, and past requests stay listable, so what has been paid out is checkable against what the stats say was earned.
04
Rotating the keys your store hands out
Keys are created with a name and revoked by id, and the existing set is listable, so a compromised key is replaced without taking the store's links down with it.
05
Launching a token and claiming its fee share
The launch handles metadata, fee configuration, the transaction, signing and submission in one call. Trading has a quote path that executes nothing, so slippage settings can be checked before a swap is sent.
23 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
1ly_claim_fees
Claim Bags fee share for a token (Bags only).
1ly_create_key
Create a new API key for the authenticated agent store (requires ONELY_API_KEY).
1ly_create_link
Create a new API link (paid or free) using your 1ly developer API key.
1ly_create_store
Create a new store for your agent on 1ly using wallet signature.Returns store + API key.
1ly_delete_link
Delete an API link by id (requires ONELY_API_KEY).
1ly_get_details
Get detailed information about a specific API on 1ly.store, including pricing, reviews, and payment info.
1ly_get_stats
Get store or link stats (requires ONELY_API_KEY).
1ly_launch_token
Launch a token on Bags.fm (v2 flow). Handles metadata, fee config, launch tx, signing, and submission.
1ly_list_keys
List API keys for the authenticated agent store (requires ONELY_API_KEY).
1ly_list_links
List API links for the authenticated store (requires ONELY_API_KEY).
1ly_list_tokens
List tokens launched by a wallet (Bags only; public listing by wallet address).
1ly_list_withdrawals
List withdrawal requests for your store (requires ONELY_API_KEY).
1ly_review
Leave a review for a completed purchase on 1ly.store. Use the purchaseId and reviewToken from the _1ly metadata returned by 1ly_call.
1ly_revoke_key
Revoke an API key for the authenticated agent store (requires ONELY_API_KEY).
1ly_search
Search for APIs and services on 1ly.store marketplace. Find APIs by keyword, filter by type and price.
1ly_trade_quote
Get a Bags trade quote without executing a swap (Bags only).
1ly_trade_token
Trade tokens on Bags (Bags only).
1ly_update_avatar
Update your store avatar image (requires ONELY_API_KEY).
1ly_update_link
Update an API link by id (requires ONELY_API_KEY).
1ly_update_profile
Update basic store profile details (requires ONELY_API_KEY).
1ly_update_socials
Update socials for your store (requires ONELY_API_KEY).
1ly_withdraw
Request a withdrawal of your available balance to a Solana wallet (requires ONELY_API_KEY).
BEFORE YOU INSTALL
What to know first
Tools you get
23 tools when we connected. 1ly_call needs a wallet, 1ly_create_store needs a raw wallet key (Agentic Wallet is not supported), and seller tools need ONELY_API_KEY, saved after store creation. ONELY_SOLANA_DRY_RUN=1 simulates Solana transactions.
Requires
npx on PATH
Where it runs
Both documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 23 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx @1ly/mcp-serverMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"1ly": {
"command": "npx",
"args": [
"@1ly/mcp-server"
],
"env": {
"ONELY_WALLET_SOLANA_KEY": "/Users/<YOUR_USERNAME>/.1ly/wallets/solana.json",
"ONELY_BUDGET_PER_CALL": "1.00",
"ONELY_BUDGET_DAILY": "50.00"
}
}
}
}Cursor
CURSOR · JSON
{
"mcpServers": {
"1ly": {
"command": "npx",
"args": [
"@1ly/mcp-server"
],
"env": {
"ONELY_WALLET_SOLANA_KEY": "<YOUR_ONELY_WALLET_SOLANA_KEY>",
"ONELY_BUDGET_PER_CALL": "1.00",
"ONELY_BUDGET_DAILY": "50.00"
}
}
}
}
