# MCP: onboarding

Source: <https://telegafirst.com/docs/mcp-onboarding>
Locale: ru
releaseGitSha: 0bb11ef116e17ec64c802d5476eaff442e53d252
sourceContentDigest: 11476a9538b42d3ff2444081b71c67078f1004502f22944a8f284f3de5a662cc
Version: 9

# 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-cancel-auto-renew)

## check\_free\_conditions

Check the current conditions for keeping your business site on the free plan.

Scopes (ALL): \["onboarding:read"]. Risk: "read".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-check-free-conditions)

## check\_slug\_availability

Check address format and availability for the authenticated owner or scoped tenant without reserving it.

Scopes (ALL): \["onboarding:read"]. Risk: "read".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-check-slug-availability)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-claim-slug)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-confirm-supergroups)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-create-quest-product)

## create\_quick\_site

Publish a business site from a description or structured fields.

Scopes (ALL): \["onboarding:write"]. Risk: "write".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-create-quick-site)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-discover-supergroups)

## get\_billing\_state

Read the current plan, paid period and automatic renewal state.

Scopes (ALL): \["onboarding:read"]. Risk: "read".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-get-billing-state)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-get-catalog-topic-link)

## get\_onboarding\_state

Read onboarding progress and the next action for the current business.

Scopes (ALL): \["onboarding:read"]. Risk: "read".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-get-onboarding-state)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-init-managed-bot)

## onboarding\_check\_test\_product

Check that the saved test product and its digital delivery are ready.

Scopes (ALL): \["onboarding:read"]. Risk: "read".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-onboarding-check-test-product)

## onboarding\_check\_test\_purchase

Verify the owner’s test purchase, actual delivery and granted bonus from server facts.

Scopes (ALL): \["onboarding:read"]. Risk: "read".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-onboarding-check-test-purchase)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-onboarding-complete)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-onboarding-defer-first-payment)

## onboarding\_defer\_tariff

Record the owner’s decision to select and pay for a tariff later, preserving progress.

Scopes (ALL): \["onboarding:write"]. Risk: "write".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-onboarding-defer-tariff)

## onboarding\_save\_ai\_preferences

Save the owner’s explicitly confirmed device, AI application and subscription answers.

Scopes (ALL): \["onboarding:write"]. Risk: "write".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-onboarding-save-ai-preferences)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-onboarding-send-tariff-checkout-card)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-register-existing-bot)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-register-mini-app-origin)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-resume-bot-connection)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-resume-infrastructure)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-retry-onboarding-site)

## 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".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-set-tax-profile)