MCP onboarding

The server is https://www.voiceflip.cz/api/mcp. Tool list and version: /docs/mcp.

Claude Desktop

Add an HTTP MCP server. Use a placeholder until vf_get_signup_status returns a real key — never paste a key from a screenshot or an old runbook.

{
  "mcpServers": {
    "voiceflip": {
      "url": "https://www.voiceflip.cz/api/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer vfk_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Buyer agent (no human click)

  1. Call vf_get_pricing.
  2. Call vf_signup with business_domain, business_email, and optional preferred_locale (cs, en, de, pl, sk, el, zh, ae).
  3. If next_action.demo_payment is present, call vf_complete_signup with that test token. Otherwise pay with a Stripe Shared Payment Token, or open next_action.url for Checkout.
  4. Poll vf_get_signup_status with the same intent_token. When payment has finished, the response includes the API key and embed_snippet. The email to the business is a copy of the same result.
  5. Call vf_update_greeting, then vf_publish_draft, using the new key as the bearer token.

Free email addresses

Gmail, Seznam, and similar domains are flagged. They are not blocked unless the deployment sets AGENTIC_KYC_ENFORCE=1. That flag has no hosted verification page yet, so leave it unset for a live demo.

Lost the key? Email support@voiceflip.cz with the key prefix only (vfk_live_xxxxxxxx), never the full secret.

VoiceFlip MCP onboarding