Getly

---

The 30-second version

You're a vibe coder. You build with Cursor, Claude, Copilot, v0, Lovable. You have things worth selling — templates, code, prompts, courses, music — and zero desire to build carts, webhooks, tax-safe payment flows, file CDNs and payout rails.

Getly is that backend, already running. This repo is everything your AI needs to drive it:

# Point AI at a folder. Get a live product + a selling blog post + a pay link.
npx @getly/auto-store ./my-icon-pack --dry-run

Behind that one command: Claude reads your folder, writes an honest product listing and an SEO article, uploads your files (up to 2GB), publishes to a marketplace with 708 categories, and hands you a checkout link that accepts cards and USDT/USDC — with delivery, receipts and license keys handled.

🎬 Demo GIF coming — run the command above with --dry-run to see the plan without writing anything.

Quickstart

1. Get an API key (one manual step, ~2 minutes): getly.store/dashboard/developer/keys → create a key with the scopes you need.

2. Sell your first product:

import { Getly } from '@getly/sdk';

const getly = new Getly(); // reads GETLY_API_KEY from env

const product = await getly.products.create({
  name: 'Neon UI Kit',
  priceCents: 1900,                    // money is ALWAYS integer cents
  shortDescription: '120 dark-mode components for Figma',
});

await getly.products.uploadFile(product.id, {
  fileName: 'neon-ui-kit.zip',
  data: await fs.readFile('./neon-ui-kit.zip'),
});

const live = await getly.products.publish(product.id);
console.log(live.urls.buy); // → share it. Getly handles checkout + delivery.

3. Sell inside a conversation (bots, support chats, anywhere):

const link = await getly.checkoutLinks.create({
  productId: product.id,
  couponCode: 'FRIENDS20',
  reference: chatId,            // echoed back in the sale.completed webhook
});
// → link.url — buyer pays with PayPal or USDT/USDC, no Getly account needed.

Prefer curl? The full copy-paste flow with expected responses: getly.store/developers.

🤖 MCP — your AI runs the store

The part nobody else ships. Add Getly to Claude Code:

claude mcp add getly --env GETLY_API_KEY=your_key -- npx -y @getly/mcp

or Cursor (.cursor/mcp.json):

{ "mcpServers": { "getly": { "command": "npx", "args": ["-y", "@getly/mcp"], "env": { "GETLY_API_KEY": "your_key" } } } }

Now this is a conversation, not a coding session:

"Upload everything in ~/designs/spring-pack as a new product at $24, write a launch post for my blog, and give me a 15%-off link I can share on X."

30 tools: products (create/update/publish/upload), your own license-key pool, blog posts, coupons, checkout links, licenses, orders, sales stats, Getly Billing plans and subscriptions, category search, Pay Widget code. Destructive actions require explicit confirmation — a prompt-injected review can't nuke your store. npx @getly/mcp init writes the config for Claude Code / Cursor / Claude Desktop / Windsurf for you.

📦 What's in the box

Package	What it does
@getly/sdk	Zero-dependency TypeScript client. Auto idempotency keys, rate-limit-aware backoff, one-call 2GB uploads, webhook signature verification, cursor iterators.
@getly/mcp	The MCP server above. init command, Smithery-ready.
@getly/nextjs	Checkout() + Webhooks() route handlers — Polar-style one-liners for Next.js.
@getly/auto-store	The folder → live store CLI (Claude-powered).
create-getly-store	npx create-getly-store my-shop → a deployable Next.js storefront wired to your Getly store.
examples/	Telegram sales bot (sells in-chat, confirms payments), dependency-free storefront widget, one-line Pay Widget buy button.
Pay Widget	One <script> + a Buy button adds checkout (buyer email + PayPal or USDT/USDC) to any site — no API key in the browser, no payment account for the seller. Getly delivers the file.
openapi/getly-v1.yaml	The whole API, OpenAPI 3.1, examples on every operation. Also served at getly.store/openapi.yaml.
llms.txt	The entire API reference as one file your AI can swallow. Also at getly.store/llms-api.txt.
AGENTS.md	The golden prompt: paste into Cursor/ChatGPT and your AI uses the API correctly on the first try.

💸 What it costs (no fine print)

Sales you drive through this SDK — API checkout links, the Pay Widget on your own site, your Telegram store — are your own traffic: Getly takes 10%, you keep 90%. Always. Sales the Getly marketplace brings you start at 20% and drop with volume (17% / 15% / 12% by prior-month sales). No monthly fee, no listing fee, no file-hosting bill, no payment-gateway setup. Full model with a live calculator: getly.store/pricing.

	Getly (10% all-in on your own traffic)	Typical payments-API stack (4–10% + fixed)
Payment processing (PayPal, crypto; card when it returns)	✅ included	✅ that's the 4–10%
Crypto checkout (USDT/USDC, 5 chains) + stablecoin payouts (BSC or Tron)	✅ included	❌
File hosting + delivery up to 2GB	✅ included	❌ bring your own S3/CDN
Marketplace traffic (708-category catalog, search, AI recommendations)	✅ included	❌ you bring 100% of traffic
License key issue + validation API	✅ included	varies
Affiliate network + referral program	✅ included	❌
Chargebacks, receipts, refund plumbing	✅ handled	partially
Fixed monthly cost	$0	$0–29+

New sellers keep 90% on everything for their first 3 months. And the old honest caveat — «if you only need payment rails, a 4% API might be cheaper» — mostly died with the 10% own-traffic rate: at 10% all-in (processing, hosting, delivery, crypto, licenses, chargebacks included) versus 4–10% + fixed fees + everything above being your problem, the rails-only stack rarely wins anymore. We'd still rather you do that math than discover it angry. Tax note: Getly handles payments, delivery, refunds and chargebacks; sellers remain responsible for their own income/VAT obligations (details).

🌍 Why builders actually pick Getly

• Stablecoin payouts, no bank needed. USDT/USDC on BNB Smart Chain (from $5) or USDT on Tron (from $15), paid on the 1st and 15th — wherever you live.
• Guest checkout. Your buyers pay with an email and PayPal or crypto — no forced account creation killing your funnel. (Card checkout is paused and comes back on its own when it returns.)
• Deliver your own license keys. Upload your keys to a product's pool (getly.products.keys.add); every sale hands out the next one, and sale.completed carries it as items[].licenseKey.
• Subscriptions for your own SaaS. Getly Billing sells recurring plans for a product that lives on your site — hosted checkout, billing.* webhooks, getly.billing in the SDK.
• MCP-first. Not "we have an API" — your AI assistant has tools.

⚙️ The honest bootstrap

"Fully AI-managed" has exactly 3 human steps, ~5 minutes total:

1. Sign up at getly.store (Google/GitHub/magic link).
2. Create an API key → dashboard/developer/keys (creates your store automatically if needed).
3. To get paid: save a USDT/USDC wallet (BNB Smart Chain or Tron) at dashboard/settings → Payments.

Everything after that — products, blog, discounts, checkout links, licenses — is your AI's job.

🧪 Try the money flow without money

Create a $0 product (or a 100%-off coupon), run the full checkout-link → guest-checkout → sale.completed webhook loop for free, then flip the real price. The recipe is in AGENTS.md.

📚 Examples

• Telegram sales bot — sells your catalog in chat, drops pay links, confirms payment in the thread. The "AI closes deals mid-conversation" demo, running on a laptop.
• Storefront widget — one <script> + one <div> on any site (v0, Lovable, Webflow, plain HTML) renders your products with Buy buttons. No API key in the browser, ever.
• Pay Widget — one <script> + a Buy button turns any site into a checkout for a single product. The buyer enters an email and pays with PayPal or USDT/USDC; Getly delivers the file and handles receipts + refunds. Full guide in docs/pay-widget.md.
• React snippets — copy-paste <GetlyStorefront/> and <GetlyBuyButton/> for generated apps, plus a ready prompt for v0/Lovable/Bolt.

🗺 Roadmap

Hosted remote MCP (mcp.getly.store, OAuth — connect from claude.ai/ChatGPT without local config) · test-mode API keys · batch product endpoint · GitHub secret-scanning partnership for getly_sk_live_ keys · device-code CLI login · Python SDK (help wanted).

🔐 Security, briefly

Keys are getly_sk_live_…, scoped, rotatable with a 24h grace overlap, and belong in env vars — every tool here refuses to accept them any other way. Webhooks are HMAC-signed with timestamps (verifyWebhookSignature in the SDK). The MCP server annotates destructive tools and demands confirmation. Full guidance: AGENTS.md.

Contributing & community

Questions → GitHub Discussions. Bugs/ideas → issues. Dev setup and the minimal-dependency policy → CONTRIBUTING.md. Built something? Add it to SHOWCASE.md.

MIT. Sell well. 🟢