POP MCP Server
Onboarding

POP MCP onboarding flow

The onboarding sequence uses OTP verification and a short-lived onboarding token, separate from the per-request license key used by the public MCP endpoint.

Flow overview

  1. Call pop_onboarding_request_otp using the email tied to the account.
  2. Verify the OTP with pop_onboarding_verify_otp.
  3. Use the returned onboarding_token for the remaining onboarding calls.
  4. Inspect status and account setup, then save the final configuration.

Important timing

  • OTP expires in 10 minutes.
  • The onboarding token expires 30 minutes after issue.
  • The token is required for the status and account-setup calls.

Operational note

The onboarding flow uses its own token and is separate from the normal MCP authentication header. That separation keeps onboarding controlled without changing the public server contract.