Access and gates
get_site_access
Start here before changing access: ONE unified view of the published gate, the gate the next publish will present, whether a publish is required, the stored classic gate, Stripe readiness, and every paid offer with its buyer_audience, scope, price, access length, design surface and buyer-requirement counts. Both sides are always reported because the unselected one stays dormant. For whether the account can actually take money, call get_commerce_setup. Never returns passwords, hashes or allowlist entries. 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
| Name | Type | Required | Description |
|---|---|---|---|
| site_id | uuid | Yes | Site UUID from list_sites. |
Returns
| Name | Type | Description |
|---|---|---|
| site_id | string | - |
| published_primary_gate | enum classic | paid | - |
| published_paid_site_scope | enum or null entire_site | except_homepage | - |
| configured_primary_gate | enum public | email_capture | allowlist | password | paid | - |
| configured_paid_site_scope | enum or null entire_site | except_homepage | - |
| desired_primary_gate | enum public | email_capture | allowlist | password | paid | - |
| paid_intent_unbacked | boolean | - |
| publish_required | boolean | - |
| classic_gate | object | - |
| stripe_ready | boolean | DEPRECATED and AMBIGUOUS: true when SOME payment environment (test OR live) can charge. MUST NOT be read as 'real money can be taken'. Use real_payments_ready for live money and test_payments_ready for test mode. |
| commerce_readiness | enum not_connected | onboarding_incomplete | restricted | test_ready | live_ready | Canonical account payment readiness; same enum and derivation as get_commerce_setup. 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. |
| test_payments_ready | boolean | TRUE when TEST-mode Stripe can charge test cards right now. Test-mode purchases move no real money and are not sales. |
| payment_environment | enum or null test | live | Payment environment this site's own offers are pinned to ('test' or 'live'), or null when the site has no offers or they disagree. 'test' means no real money changes hands. |
| has_paid_site_config | boolean | - |
| paid_offers | array of object | - |
| page_paths | array of string | - |
Using it
get_site_access 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.