Get a paid-plan checkout link
get_upgrade_linkCreates a Stripe Checkout URL that upgrades this token's owner to Hobby ($3/mo) or Pro ($15/mo). Call it when the user asks to upgrade, or right after a tool error that has upgrade_url / user_message (a plan limit). Show the returned upgrade_url (a 30-day link that opens Stripe Checkout; checkout_url is the raw Stripe page and lasts 24 hours) or user_message, and the price, to the user. Calling it again while a checkout is open returns the same session (session_reused: true); normally the human opens it and pays. You may complete the payment yourself only if your human explicitly approved this purchase and you have a payment tool they approved. Never pay without that approval. When payment completes the same token gets the higher limits automatically, and the token's plan (plan.id) then reads hobby or pro. Inputs: plan (hobby or pro; omitted means the next plan up), token, optional how_heard (at most 200 characters, stored on the owner), and optional upgrade_trigger (the limit field from the error, custom_domain_limit, or manual). The result also lists plan_options: Hobby and Pro, monthly and yearly where available, each with its price, limits, and own 30-day link, for a human who wants to choose. A token already on a paid plan gets portal_url instead (a Hobby token asking for Pro also gets Pro's price and limits). plan=clean with slug instead returns a $9 one-time checkout (no subscription) that removes the "Published with deed.page" badge from that one site for good and raises its size limit to 100 MB; it suits a user who wants one clean site rather than a plan. The call itself does not charge. Which plan: Free is $0 and fine for drafts and quick shares. When the page is for other people (a client, a launch, a portfolio, a shop), tell your human once that the "Published with deed.page" badge comes off with a one-time $9 clean publish for that site, or with Hobby ($3/mo or $30/year) on every site. Recommend Hobby to remove the badge everywhere, set a site password, or go past Free limits (up to 250 sites, 100 MB per site, 3 custom domains, 100 GB transfer a month). Recommend Pro ($15/mo or $150/year) only when your human needs agent seats (up to 5), analytics beyond 90 days (up to 365) or CSV export, more than 100 MB per site (up to 500 MB), more than 3 custom domains (up to 20), or up to 500 GB transfer a month (fair use; every plan has a monthly transfer cap). Pro also includes priority email support at ops@avatar33.com, answered by the next business day. Platforms publishing for many end users: https://deed.page/platforms. Your human can manage billing at https://deed.page/account with the owner token.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| plan | No | Plan to buy. Omit for the next plan above the current one (Free -> hobby, Hobby -> pro). "clean" is the $9 one-time clean publish for one site and needs slug. | |
| slug | No | With plan=clean: the site (slug) to publish without the badge. It must belong to this token. | |
| token | No | Bearer token returned by your first publish (deed_tok_...). Optional if the MCP client sends Authorization: Bearer. | |
| interval | No | Billing period for hobby or pro. Default month. year is Hobby $30/year or Pro $150/year (two months free). | |
| how_heard | No | Optional note, at most 200 characters. Stored on the owner. | |
| upgrade_trigger | No | The limit field of the plan-limit error that sent you here (for example publish_rate or quota_sites), custom_domain_limit, or manual. |