Lid

Showing 25 of 43 from the live probe.

• Search Creators

  Search creators by username/bio/country. Returns up to 6 matches. Minimum 2 chars for query.

• Get Latest Creators

  Recently active creators. Default 10, max 20. Good for 'who's new' queries.

• Get Reviews By Product

  Reviews and average rating for a product/NFT collection by contract address. Paginated.

• Get Affiliate By Code

  Public lookup of an affiliation by its short code. Registers a click (side-effect). Returns the collection and affiliate wallet.

• Get Solana Affiliate Earnings

  AffiliateEarning records + aggregates (total commission, sales count, withdrawals) for a Solana pubkey.

• My Agent Wallet

  IDENTITY. Returns who this MCP API key acts as: userId, the user's real wallet (where revenue goes), and the custodial agent wallet (the on-chain `creator` used when creating products). Call this first to confirm the key is wired correctly.

• Get My Usage

  USAGE & LIMITS. Read-only status of this API key: whether MCP creation is globally enabled, creation caps (daily window and lifetime) with used/remaining counts and the daily reset time, plus the custodial agent wallet balances (SOL in lamports, USDC in atomic units). Checking it does NOT consume any quota. Call it before create_product/create_bounty to self-regulate instead of hitting limit errors.

• Create Product

  WRITE. Create a new Lidpro product ON-CHAIN, custodially, with the FULL set of product attributes. The server signs as the agent wallet (creator) and the platform sponsor pays gas — the agent needs no Solana wallet. Revenue (royalties) is routed 100% to the key owner's real wallet. Only `name`, `priceUsdc` and `maxSupply` are required; everything else is optional. Returns productPda, productId, tx signature and explorer link. IMPORTANT: a PAID product with no `extraFiles` is created as a DRAFT (

• My Products

  List the products owned by the API key's user (created via MCP or otherwise). Returns productPda, name, price, supply and on-chain status.

• Affiliate To Product

  WRITE. Affiliate the API key's user to an existing product so they earn commission promoting it. Off-chain (no signing). Returns the affiliate code + shareable /ref link. You cannot affiliate to your own product.

• My Affiliations

  List ALL the products the API key's user is affiliated to (the ones they promote), with each affiliate code, /ref link, clicks, conversions and earnings. Use to read the user's affiliations.

• My Analytics

  Read the API key user's analytics. perspective='creator' (sales, revenue, affiliates of my products) or 'affiliate' (commissions I earned promoting others). Optional timeframe: 7d, 30d, 90d, 1y, all.

• Product Analytics

  Analytics for ONE of the user's products by productPda: totals (sales, gross volume, creator revenue, platform fees, affiliate sales, commission paid, distinct buyers/affiliates), per-affiliate breakdown, daily time series and recent purchases. Use to see how a specific product is performing. Only works for products the user owns.

• Prepare Usdc Transfer

  Build an UNSIGNED USDC transfer transaction. Returns base64-serialized tx + metadata (feePayer, recentBlockhash, instructions). The caller signs with their keypair and submits. Use when an agent needs to pay USDC (e.g. mint price) without giving the server its private key. FREE — no funds move server-side.

• Prepare Sol Transfer

  Build an UNSIGNED native SOL transfer transaction. Returns base64 tx. The caller signs and submits. Useful for paying another wallet's rent or topping up a helper. FREE.

• List Webhooks

  Your webhook endpoints: where Lid notifies you when something happens (a sale, a claimed prize, an approved conversion). Read-only.

• Create Webhook

  Register a URL that Lid will call when the events you pick happen. Events: purchase.completed, prize.claimed, conversion.approved, subscription.created, bounty.submission.created. The response includes the signing secret ONCE — store it: every delivery is signed with it so you can verify the call really came from Lid.

• Delete Webhook

  Stop notifying a webhook endpoint.

• Webhook Deliveries

  Recent delivery attempts for one webhook, with status code and error — the first place to look when the tenant says 'Lid is not notifying me'.

• Prepare Purchase

  WRITE (does not spend YOUR money). Build an UNSIGNED purchase transaction so that ANOTHER wallet — your own end user — can sign it. This is how you sell from your own site or app without ever showing a Lid screen: you get back `txBase64`, your frontend has the buyer sign it with their wallet, then you POST it to /api/v1/lidpro/sponsor (the platform co-signs as gas payer and broadcasts) and finally call confirm_purchase with the signature. Pass affiliateCode to have the on-chain split pay the aff

• Confirm Purchase

  Confirm a purchase you already broadcast: checks the signature landed on-chain and queues it so the receipt (and the buyer's downloadable files) show up in seconds instead of waiting for the next sweep. Safe to call twice.

• My Sales

  What you SOLD (not what you bought), newest first, each with the deliverable files as presigned URLs (24h) so you can hand them to the buyer from your own app. Filter by ?buyer= to answer 'what did this customer buy'. Only covers products created by your wallets: a seller delivers what they sold.

• Purchase Product

  WRITE — SPENDS MONEY. Buy a Lidpro product ON-CHAIN with the custodial agent wallet: the USDC comes out of THAT wallet's own balance (fund it first — check get_my_usage) and the platform sponsor pays gas. The agent wallet becomes the owner of the receipt and is the only one that can download the content afterwards, via my_purchases. The 3% platform fee and the creator's share are split in the same transaction. Pass maxPriceUsdc (ATOMIC USDC string) as a spending cap: if the on-chain price is hig

• My Purchases

  What the custodial agent wallet has bought, newest first, WITH the deliverable files as presigned URLs (valid 24h). This is how the agent actually receives what it paid for. Right after purchase_product the receipt takes a few seconds to appear (the on-chain listener persists it), so retry if it is not there yet.

• Create Bounty

  WRITE. Create a bounty (Superteam-style reward). Created as a draft; with fund=true the custodial agent wallet signs create_pool + fund_pool ON-CHAIN (sponsor pays gas), the USDC prize is escrowed and the bounty opens immediately. Requires the agent wallet to hold enough USDC (fundAmount or the sum of prizes). Amounts are ATOMIC USDC strings (1 USDC = '1000000'). POLICY — you MUST pass acceptTerms:true, and the human must have agreed first: a bounty that had any activity (USDC escrowed on-chain