Stoat Command Reference

Reference for every Arcalotl Stoat member and admin command, including typed-message syntax, permissions, examples, and private replies.

Stoat commands are !-prefixed messages. Type or paste the entire command into a server channel the bot can read. Commands do not use native slash-command autocomplete. Private billing and administration replies move to DMs.

Member commands

Command	Who can use it	What it does
`!subscribe [number]`	Any member	Browses plans or starts checkout for a numbered plan.
`!subscribe NUMBER BILLING_NUMBER`	Any member	Selects a billing option when a tier has several.
`!donate [amount=5.00]`	Any member	Starts a one-time donation when donations are enabled.
`!manage [page=2]`	Known subscriber	Lists subscriptions, cancel commands, and the member portal link.
`!cancel [number]`	Active subscriber	Starts the guided cancellation and save-offer flow.
`!link [code]`	Any member	Generates or redeems an account-link code.
`!help`	Any member	Shows the Stoat command guide.
`!ping`	Any member	Checks whether the bot is responding.

When a list contains more than 20 items, use the page= value shown by the bot. Numbered selections are resolved against the current list.

Setup and linking

Command	What it does
`!arcalotl setup`	Creates a new community and starts Stripe setup.
`!arcalotl setup CODE`	Connects this Stoat server to an existing community.
`!arcalotl link [CODE]`	Generates or redeems a member identity-link code.
`!arcalotl ping`	Checks the admin command router.

Setup requires server ownership or Manage Server permission. Billing administration also respects the community's explicit Arcalotl admin list. Member identity linking uses private codes and does not require admin access.

Plans

Command	What it does
`!arcalotl plan list [page=2]`	Lists active plans with their numbers and IDs.
`!arcalotl plan create role=ROLE_ID name="VIP" monthly=9.99 annual=99.99 currency=usd`	Creates a tier and its billing options.
`!arcalotl plan edit plan=PLAN_ID name="VIP" price=19.99 hierarchy=Membership:2`	Updates a plan.
`!arcalotl plan delete plan=PLAN_ID`	Starts confirmed plan deactivation.
`!arcalotl plan import product=STRIPE_PRODUCT_ID role=ROLE_ID name="VIP"`	Imports a supported Stripe product and prices.

Role values are Stoat role IDs, not role names. Arcalotl rejects roles the bot cannot manage.

Donations

!arcalotl donation create name="Donations" default=5.00 min=1.00 max=100.00 currency=usd

This creates or updates a choose-your-amount donation path. Donation role access is configured through entitlements in the dashboard.

Analytics and refunds

Command	What it does
`!arcalotl analytics`	Shows subscription and retention metrics.
`!arcalotl refund-subscription subscription=SUBSCRIPTION_ID reason=requested_by_customer`	Starts a confirmed refund-and-cancel operation.

Refunds require explicit confirmation. Use the dashboard Subscriber view when you need more context before acting.

Settings

Show current settings:

!arcalotl settings

Update payment recovery:

!arcalotl settings dunning enabled=true max_attempts=4 interval_hours=48 grace_days=7

Enable or disable retention workflows:

!arcalotl settings cancel enabled=true
!arcalotl settings term enabled=true

Configure public and admin channels with Stoat channel IDs:

!arcalotl settings channels subscribe=CHANNEL_ID announcements=CHANNEL_ID admin=CHANNEL_ID

Configure explicit Arcalotl admins:

!arcalotl settings admins add=USER_ID
!arcalotl settings admins remove=USER_ID
!arcalotl settings admins clear=true

The dashboard exposes the complete cancellation-save and term-optimization configuration. Stoat's settings command covers workflow enablement, recovery timing, channels, and admin IDs.

Member portal and storefront

Use !manage to list memberships, then open the member portal link in the private reply. Choose Manage beside a membership for billing and plan changes.

Admins can use !arcalotl storefront to retrieve the community's published storefront link when a storefront is available.

Unknown commands

Bare !arcalotl and unknown !arcalotl subcommands show the help embed rather than failing silently. For a typo in a member command, Arcalotl suggests the closest command when possible.

See Stoat setup for installation, permissions, role hierarchy, and privacy behavior.

Stoat Command Reference

On this page