Purchases in chat
Only one call pays from the user's balance: get_skill with confirm: true, from a signed-in token with the install scope. The agent must ask the user first. With topup_usd as well, the same call first tops up the balance from the user's saved card.
Rules agents are given#
- Suggest one or two skills with name, price and why they fit. Always ask before buying.
- If the balance covers the price, get_skill states the balance before and after. Only after the user says yes, call get_skill again with
confirm: true. A skill the user already owns is never charged twice. - If the balance is too low and the user saved a card, get_skill returns
one_tap: { topup_usd, card }. Ask once, naming the price and the top-up, for example "Buy SEO Audit for $12.00? I'll top up your balance with $8.00 from your Visa •••• 4242 first." After yes, call get_skill withconfirm: trueand that exacttopup_usd. Any other amount charges nothing and returns the current offer. - If the balance is too low and there's no saved card: for skills from $5, show the card link first, then the top-up link. Under $5, show the top-up link.
- If get_skill returns
approve_payment_url, the user's bank wants to confirm the top-up. Give them the link; after they approve, call get_skill withconfirm: trueagain, withouttopup_usd. - If the user set a monthly limit for agent purchases and a purchase would pass it, get_skill says so and returns
monthly_limit_usd. There is no limit unless the user sets one. Nothing can be paid from the balance until the user changes the limit in Dashboard → Balance; the card checkout link still works. - Tell the user: "Doesn't do what its page promises? You get your money back." See the money-back guarantee.
| Link | What it is |
|---|---|
| Card checkout | https://mcp.agensi.io/checkout?offer=… Signed for one user and one skill, valid 24 hours. Opening it starts Stripe Checkout. |
| Top-up | https://agensi.io/dashboard?tab=credits&topup=<amount> Opens the dashboard to add funds. The agent says how much covers the shortfall, from $5. |
| Subscription | A signed link to subscribe monthly by card. The balance can't pay for it. |
| Bank approval | https://invoice.stripe.com/… Only when the user's bank wants to confirm a top-up from their saved card. |
After payment, the next get_skill call loads the skill. An expired or altered checkout link lands on agensi.io/mcp: call get_skill again for a fresh one.
Pricing rules. See Prices and payment and Your balance. Skills under $5 can only be paid from the balance. Top-ups run from $5 to $1,000 and last 12 months. Deal prices apply. VAT may be added at checkout.