1. Docs
2. /
3. Tool reference
4. /
5. Commerce
6. /
7. createOffer

Commerce

createOffer

Create Offer

Create a Space Offer as a PRIVATE draft (never auto-publishes).

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "create the $10/year Library Card", and it calls createOffer.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "amountCents": 1,
    "name": "<name>",
    "spaceId": "<spaceId>"
  },
  "name": "createOffer"
}

Arguments

• amountCentsintegerrequiredPrice in cents, e.g. 1000 = $10.00.
• currencystringoptionalISO 4217 currency, default usd.
• descriptionstringoptionalOne short sentence about the offer. Put what is bought in lineItems; cadence and cancel sentences are stripped.
• installmentCountintegeroptionalNo description is declared in the tool schema.
• intervalstringoptionalRequired for subscription: day, week, month, or year.
• intervalCountintegeroptionalIntervals between charges. Unit-specific maximum is 3 years.
• kindstringoptionalPricing kind: one_time, subscription, or installment. Or pass paymentTerms instead.
• lineItemsobject[]optionalWhat the buyer gets, one line each, printed as the pay page's itemization. Lines without amountCents print as what the price includes. The cadence is said once by the page; never write it into a line.
• namestringrequiredOffer name, e.g. 'ENOK Library Card'.
• paymentMethodsstring[]optionalHow this offer may be paid. Absent uses the shop cart setting. An explicit list is honored exactly when the account supports it.
• paymentTermsobjectoptionalThe cadence, instead of kind/interval/installmentCount/trialDays: {kind:"one_time"}, {kind:"recurring", interval:"month"} or {kind:"installments", count:4, interval:"month"}. amountCents is one charge.
• recordsToobjectoptionalInteractions channel of this Space (id from listChannels) that every paid checkout files one entry into. Space admins only.
• spaceIdstringrequiredThe Space name, slug or id that owns the offer.
• trialDaysintegeroptionalNo description is declared in the tool schema.

Returns

The result states the remaining steps to a shareable checkout link: bindSpacePaymentAccount first if needed, then setOfferVisibility public with confirm:true, which returns the link.

Declared limits

• amountCents: greater than 0
• amountCents: maximum 9007199254740991
• installmentCount: greater than 0
• installmentCount: maximum 9007199254740991
• intervalCount: greater than 0
• intervalCount: maximum 1095
• lineItems: maximum items 20
• trialDays: minimum 0
• trialDays: maximum 9007199254740991

Ask for it

The Cloud routes these requests to this verb.

• create the $10/year Library Card
• add a membership offer
• set up Space checkout
• concierge an offer

Pair it with

The verbs that finish the job.

• listSpacePaymentAccounts
• bindSpacePaymentAccount
• setOfferVisibility

Questions

• What does createOffer do?

  Create a Space Offer as a PRIVATE draft (never auto-publishes). It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use createOffer from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "create the $10/year Library Card", and it calls createOffer.

• Is createOffer safe to let an AI call?

  createOffer changes your workspace. What an AI creates is Private until you share it.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.