Payments and selling
get_commerce_setup
Return whether this account can actually take money: readiness (not_connected, onboarding_incomplete, restricted, test_ready, live_ready), per-mode Stripe Connect state (test and live: connected, status, charges_enabled, payouts_enabled, details_submitted, outstanding requirement count, country, currency), the plan and whether Pro is required, whether this credential may run onboarding, and whether the public seller details needed for consumer selling are complete. live_ready means Stripe has enabled live charges, never merely that an account exists. Use create_stripe_connect_link to continue onboarding. Read-only.
Behaviour
- Effect
- Read only. Calling it never changes anything in the account.
- Repeat calls
- Idempotent. Repeating the same call produces the same result.
- Plan
- Available on every plan, including free.
Parameters
This tool takes no parameters.
Returns
| Name | Type | Description |
|---|---|---|
| plan | string | - |
| pro_required | boolean | - |
| can_manage | boolean | - |
| default_mode | enum test | live | The Stripe environment Connect onboarding targets by default for this deployment. This is an onboarding/default REQUESTED mode only. It is NOT a promise about where a newly created Paid Access offer will pin — read new_offer_environment for that. |
| available_modes | array of enum | - |
| new_offer_environment | enum or null test | live | The payment environment a Paid Access offer created RIGHT NOW would be pinned to: 'live' when a live Stripe account is active and can charge, otherwise 'test' when a test account is active and can charge, otherwise null. 'test' means no real money changes hands. null means creating an offer fails with E_STRIPE_NOT_READY. |
| readiness | enum not_connected | onboarding_incomplete | restricted | test_ready | live_ready | Canonical account payment readiness. test_ready means test charges only and no real money; live_ready means real money can be taken. |
| real_payments_ready | boolean | TRUE only when LIVE-mode Stripe can charge real cards right now. This is the ONLY field that means real money can be taken. |
| modes | array of object | - |
| seller_details_complete | boolean | - |
| seller_details_missing | array of string | - |
Using it
get_commerce_setup is called by an AI assistant connected to Sentway over MCP, not by hand. Point the assistant at the Sentway MCP endpoint and complete the OAuth flow, and the tool becomes available in the same session as the other 56 Sentway tools. See connecting over MCP.