VoiceFlip MCP

Endpoint: https://www.voiceflip.cz/api/mcp. JSON-RPC 2.0, stateless. Server version 3.0.2 (same value as initialize.serverInfo.version and vf_health).

Onboarding steps, Claude Desktop config, and the signup poll tool are in the MCP onboarding guide. REST-shaped notes live at /docs/api.

Authentication

Public tools work without a key. Everything else expects Authorization: Bearer vfk_<live|test>_<8 hex>_<48 hex>. The buyer agent receives that key from vf_complete_signup or, after a human Stripe Checkout, from vf_get_signup_status.

Tools

• vf_health — public
• vf_list_agents — starter and professional
• vf_get_agent — starter and professional
• vf_list_conversations — starter and professional
• vf_get_conversation_transcript — professional
• vf_list_leads — professional
• vf_get_kb_status — starter and professional
• vf_get_analytics — starter and professional
• vf_update_greeting — starter and professional
• vf_update_working_hours — starter and professional
• vf_update_fallback_message — starter and professional
• vf_publish_draft — starter and professional
• vf_revert_to_published — starter and professional
• vf_add_kb_url — professional
• vf_remove_kb_source — professional
• vf_change_voice — professional
• vf_update_white_label — professional
• vf_create_api_key — professional
• vf_signup — public
• vf_complete_signup — public
• vf_get_signup_status — public
• vf_get_pricing — public
• vf_upgrade_subscription — starter and professional
• vf_get_billing_summary — starter and professional

Agent signup

1. vf_get_pricing (include currency: "aed" for the UAE market)
2. vf_signup with the business domain, email, and preferred_locale (ae is valid)
3. Pay with the Shared Payment Token, the human Checkout URL, or the stage test token when the deployment allows it
4. vf_get_signup_status until status is completed and embed_snippet is present
5. vf_update_greeting then vf_publish_draft

The embed URL uses ?agentId= (the VoiceFlip agent id). Paste embed_snippet onto the customer site.