Для AI-агентов: markdown этой страницы — /docs/mcp-onboarding.mdиндекс документации — /llms.txt
MCP: onboarding
Обновлено
Определения инструментов. Обновляйте tools/list после изменения прав. required_scopes: ALL.
cancel_auto_renew
Cancel automatic renewal while keeping access through the paid period.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
check_free_conditions
Check the current conditions for keeping your business site on the free plan.
Scopes (ALL): ["onboarding:read"]. Risk: "read".
check_slug_availability
Check address format and availability for the authenticated owner or scoped tenant without reserving it.
Scopes (ALL): ["onboarding:read"]. Risk: "read".
claim_slug
Claim the immutable public address and language; automatic site preparation starts immediately. Read get_onboarding_state until site_operation completes; no business questionnaire is required.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
confirm_supergroups
Confirm three discovered groups by candidate number and fingerprint. If discovery is stale, follow next_action to refresh it.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
create_quest_product
Create a free quest product with delivery content for your trial business. Completion is recorded after the actual purchase and delivery.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
create_quick_site
Publish a business site from a description or structured fields.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
discover_supergroups
Scan the owner's Telegram groups with the reserved technical account. Call it once, only after the owner has acted (added the account to the groups); never poll it. Scans are limited to one per business per minute, refresh included. When body.kind is "wait", body.wait_for gives reason, retry_after_seconds and until: do not call again before retry_after_seconds; body.candidates is then the last saved snapshot. Read get_onboarding_state for the next action.
Scopes (ALL): ["onboarding:read"]. Risk: "write".
get_billing_state
Read the current plan, paid period and automatic renewal state.
Scopes (ALL): ["onboarding:read"]. Risk: "read".
get_catalog_topic_link
Get the deeplink to the Catalog topic in the tenant Settings supergroup (where products are added). Returns null with guidance if the Settings supergroup / catalog topic is not provisioned yet.
Scopes (ALL): ["onboarding:read"]. Risk: "read".
get_onboarding_state
Read onboarding progress and the next action for the current business.
Scopes (ALL): ["onboarding:read"]. Risk: "read".
init_managed_bot
Get a two-tap Telegram deeplink to connect a new managed bot. The server derives its name from the published business site and its username from the claimed address.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
onboarding_check_test_product
Check that the saved test product and its digital delivery are ready.
Scopes (ALL): ["onboarding:read"]. Risk: "read".
onboarding_check_test_purchase
Verify the owner’s test purchase, actual delivery and granted bonus from server facts.
Scopes (ALL): ["onboarding:read"]. Risk: "read".
onboarding_complete
After explicit owner confirmation, verify every mandatory condition and finish this business onboarding. A payment provider and a first payment are not mandatory conditions.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
onboarding_defer_first_payment
Record the owner’s decision to receive their first live payment later. Informational only: a first payment is not required to finish onboarding.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
onboarding_defer_tariff
Record the owner’s decision to select and pay for a tariff later, preserving progress.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
onboarding_save_ai_preferences
Save the owner’s explicitly confirmed device, AI application and subscription answers.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
onboarding_send_tariff_checkout_card
Send the selected live platform tariff checkout card to the owner for this explicit business. The owner completes checkout in Telegram; card presentation does not confirm payment or finish onboarding.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
register_existing_bot
Connect the owner’s existing Telegram bot using the bot_token supplied in this agent conversation. The existing registration pipeline validates and finalizes the connection; connected:true means completed finalization. Never echo or place the token in a subsequent instruction. Retry the same token safely, or use resume_bot_connection after a lost response.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
register_mini_app_origin
Register the tenant host as the Mini App origin of one channel (telegram, MAX or VK) in one zone; MAX and VK exist only in zone ru. The result is pending with a recipe: the URL to set in BotFather (Telegram) or business.max.ru (MAX), or nothing to paste (VK). The origin becomes registered automatically on the first validly signed launch from it. The origin defaults to the zone's tenant host, the only origin accepted. No messenger API is called.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
resume_bot_connection
Resume the selected business’s frozen bot connection operation without sending a token again. connected:true requires the existing durable finalized result matching the currently bound bot; a partial or unfinished connection returns BOT_CONNECTION_NOT_READY.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
resume_infrastructure
After the owner repairs the reported permissions or group settings, resume infrastructure for the current business using its existing confirmed groups and durable convergence operation. This does not rediscover or bind groups. Terminal platform failures require the repair described by next_action before setup can continue.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
retry_onboarding_site
Retry a failed automatic first-site operation using its saved work. Read get_onboarding_state for phases and the final two-zone bio result; no description is required.
Scopes (ALL): ["onboarding:write"]. Risk: "write".
set_tax_profile
Set the business tax profile for payment setup. Returns onboarding progress and the next action. Optional: payment setup is not part of the mandatory onboarding path and never blocks onboarding_complete.
Scopes (ALL): ["onboarding:write"]. Risk: "write".