Voiceflow
Voiceflow is a platform for building, deploying, testing, and analyzing conversational AI agents.
Verdict
Common use cases
- Pull transcripts to diagnose user drop-off
- Export environment snapshots before each release
- Audit which variables the agent references
- Inject knowledge articles from public URLs
- Compare draft and production agent configs
Integration
- Vendor
- Voiceflow
- Category
- other
- Auth
- API_KEY
- Tools
- 20
- Composio slug
voiceflow
Tools
- Create Variable
Create one user-defined variable in a Voiceflow project environment and return its assigned ID and configuration.
- Delete Variabledestructive
Permanently delete one user-defined variable by ID. Use only after confirming it is not a system variable or referenced by the agent.
- Export Environment
Return a complete JSON snapshot of one Voiceflow environment, including agent, workflows, tools, functions, variables, and knowledge-base records.
- Get Agent Configuration
Return one project environment's agent configuration; optionally include its large global prompt and instructions.
- Get Conversation State
Read a user's Voiceflow conversation variables, storage, and execution stack for a draft or published environment.
- Get Transcript
Return one transcript with its full conversation logs, properties, evaluations, and recording URL.
- Import Knowledge Document from URL
Crawl one public web URL into a Voiceflow knowledge base and return the created document and ingestion status. This may consume knowledge-base quota.
- List Agent Components
List playbooks, API tools, functions, project-level evaluations, MCP servers or tools, attached tools, or tests for a Voiceflow project and, where applicable, an environment.
- List Environments
Return a project's environments, aliases, release history, and live traffic percentages.
- List Knowledge Documents
Return all knowledge-base documents in one project environment with their IDs, sources, ingestion status, and chunking settings.
- List Projects
Return every Voiceflow project in one workspace, including project IDs used by agent, runtime, and authoring tools.
- List Variables
Return system and user-defined variables in one project environment with IDs, defaults, descriptions, and ownership flags.
- List Workspaces
Return every Voiceflow workspace accessible to the connected account, including IDs needed to list projects.
- Publish Environment
Publish a Voiceflow environment as a named release. This changes the version available to published conversations, is externally visible, creates a persistent release, and is not automatically reversible. Requires explicit confirmation thro
- Query Knowledge Base
Retrieve relevant document chunks and optionally synthesize an answer from a project's draft or published Voiceflow knowledge base. Answer synthesis may consume model usage.
- Query Project Analytics
Return one Voiceflow project-level analytics metric as a time series for a requested date range and interval.
- Search Transcripts
Search a project's conversation transcripts by time, environment, version, session, and transcript-property filters, returning one bounded page.
- Send Conversation Message
Send one text turn to a Voiceflow agent and return its typed response traces; this invokes the agent and may consume model usage.
- Update Conversation Variables
Merge named variable values into one user's existing conversation state without replacing storage or the execution stack.
- Update Variable
Update selected editable fields of one user-defined variable; omitted fields remain unchanged.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and click **Add Integration** under the MCP section. 2. Select **Voiceflow** from the catalog. 3. You'll need a Voiceflow API key: log into your Voiceflow workspace, navigate to **Settings → API Keys**, and generate a new key with read and write permissions. 4. Paste the key into Switchy's auth prompt and click **Connect**. 5. Switchy will confirm the connection and list the 20 tools now available. 6. Inside any Project, type **@Voiceflow get agent configuration** and include your project ID to verify the MCP can read your agent's prompt and settings. 7. If the response includes your agent's global instructions, the integration is live and ready for team use.
What teammates see: by default, memories from Voiceflow are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Audit Agent Variables
@Voiceflow list all user-defined variables for project ID abc123 in the development environment. Show each variable's name, type, and default value.
Fetch Recent Transcripts
@Voiceflow get the five most recent transcripts for project ID abc123. Include conversation logs, user properties, and any evaluation results.
Export Before Deploy
@Voiceflow export a full environment snapshot for project ID abc123, staging environment. Include agent config, workflows, tools, functions, variables, and knowledge-base records.
Ingest Help Article
@Voiceflow import the knowledge document at https://docs.example.com/faq into project ID abc123. Return the document ID and ingestion status.
Debug Live Session
@Voiceflow get the conversation state for user ID user_456 in project ID abc123, production environment. Show all variables, storage, and the execution stack.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Voiceflow export the production environment configuration so I can review all workflows and variables before we migrate to the new project structure.
Exported production environment snapshot (3.2 MB JSON). The export includes 47 workflows, 12 custom functions, 23 user-defined variables, 8 API integrations, and 156 knowledge-base documents. All agent prompts, intents, and conversation paths are preserved in the snapshot. You can now diff this against your staging environment or use it as a rollback reference.
Export captures a complete point-in-time snapshot of your Voiceflow environment. Useful for version control, audits, or migrations. Requires API key with read access to the target environment. Large projects may produce multi-megabyte JSON files.
@Voiceflow create a variable called 'user_tier' with default value 'free' in the staging environment so we can start testing subscription-based routing logic.
Created variable 'user_tier' (ID: var_8x3k9m2p) in staging environment. Default value set to 'free'. The variable is now available in all workflows and can be referenced in conditions, API calls, or agent responses. Remember to update your conversation flows to populate this variable based on user authentication data.
Variable creation is immediate but requires the API key to have write permissions on the target environment. Once created, the variable persists across all workflows in that environment. Deleting a variable later requires confirming it's not referenced in active flows to avoid runtime errors.
@Voiceflow pull the last 15 transcripts from our support bot and summarize the most common user complaints so we can prioritize fixes this sprint.
Retrieved 15 recent transcripts (spanning 4 days). Common complaint themes: (1) 'Refund policy unclear' — mentioned in 8 conversations, users repeatedly asked follow-up questions. (2) 'Can't find order status' — 5 users abandoned after the bot failed to parse order numbers with dashes. (3) 'Transfer to human agent' — 6 users requested escalation, average wait before request was 2.3 turns. Recommend clarifying refund copy in the knowledge base and adding order-number format validation.
Transcript retrieval gives you raw conversation logs, user inputs, bot responses, and metadata like duration and evaluation scores. Pairing this with AI summarization helps surface patterns across sessions. Transcripts are only available for environments where logging is enabled, and retention policies vary by Voiceflow plan tier.
Use-case deep-dives
When Voiceflow MCP helps debug production conversation flows
A 6-person conversational AI team ships a customer-support voice agent and needs to triage why callers drop off at the billing step. The Voiceflow MCP wins here: Get Transcript pulls the full conversation log with execution stack and variables, then Get Conversation State shows exactly which branch the user hit before hanging up. The team spots a missing variable handoff in 10 minutes instead of guessing from analytics dashboards. This works when you own the Voiceflow project and have API-key access to the workspace. If you're debugging a third-party agent or lack workspace admin rights, you can't authenticate and this MCP is a non-starter. For teams shipping voice or chat agents on Voiceflow who need fast root-cause analysis during on-call shifts, this is the right call.
Automating help-doc ingestion into Voiceflow knowledge bases
A 3-person product team runs a Voiceflow chatbot that answers SaaS onboarding questions, and the help docs live in Notion. Every sprint they publish 4-6 new articles and want the bot to stay current without manual copy-paste. The Import Knowledge Document from URL tool crawls each published URL and adds it to the knowledge base in one call. This scenario works when your docs are public or behind a URL the MCP can reach, and when you're okay with quota consumption per import. If your help center is gated or you need to dedupe before ingesting, you'll hit friction. For small teams that ship docs faster than they can update the bot manually, this MCP closes the loop and keeps the agent accurate without a dedicated ops person.
When to use Voiceflow MCP for staging-to-prod promotion
A 5-person enterprise chatbot team maintains separate Voiceflow environments for dev, staging, and production. After QA signs off on staging, they want to promote the agent config and variables to prod without clicking through the UI or risking manual drift. Export Environment pulls the full JSON snapshot from staging, then Create Variable and Get Agent Configuration let them script the promotion with a diff check. This works when your environments live in the same Voiceflow workspace and you have API-key access to both. If environments span workspaces or you need approval gates that Voiceflow's native publish flow already handles, the MCP adds complexity without payoff. For teams running formal release cycles with multiple environments, this MCP turns promotion into a repeatable script instead of a risky manual checklist.
Frequently asked
What does the Voiceflow MCP let me do in Switchy?
It lets your AI agents read and modify Voiceflow conversational-AI projects — create variables, export environment snapshots, import knowledge documents from URLs, pull transcripts, and inspect agent configurations. You can automate Voiceflow project management, audit conversation logs, or sync knowledge bases without opening the Voiceflow dashboard.
Do I need a Voiceflow API key to connect this MCP?
Yes. You need a Voiceflow API key with workspace-level permissions. Generate one in your Voiceflow workspace settings, then paste it into Switchy when you add the MCP. Without it, none of the twenty tools will authenticate.
Can the MCP publish a Voiceflow agent or change its live environment?
No. The MCP reads draft and published environment state, exports snapshots, and modifies variables or knowledge documents, but it cannot trigger a publish action. You still deploy agents through the Voiceflow UI or their separate deployment API.
Why use this MCP instead of calling Voiceflow's API directly?
The MCP wraps twenty common Voiceflow operations into natural-language tools your AI agents can call without you writing integration code. If you need one-off data pulls or want full control over request payloads, use the API. If you want agents to manage Voiceflow projects conversationally, use the MCP.
Who on my team should connect the Voiceflow MCP?
Whoever owns your Voiceflow workspace API keys — typically a product manager or engineer managing conversational-AI projects. That person controls which Voiceflow workspaces Switchy can read and modify. Everyone else on the Switchy team can then invoke the MCP's tools in shared chats.