# Voiceflow MCP for AI Agents AI Agent Connect

> Voiceflow MCP connects your account to any AI client so you can build, test, and monitor conversational agents using natural language. Instead of clicking through a complex dashboard, you can ask your agent to query knowledge bases, update user variables, or pull transcripts. It bridges the gap between your bot's logic and your daily workflow, making it easier to debug flows and check real-time feedback.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_l22Y6YFkjLlbfmb2bwNvq56Y3lGMb9ioSh3t5jM5/ai-agent-connect
- **Tags:** conversational-ai, chatbot-design, rag-pipeline, dialog-flow, prototyping, ai-agent-testing

## Description

Most people spend way too much time jumping between tabs to manage their bots. You're constantly hunting for the right project, digging through logs, and trying to figure out why a user hit a dead end. It's a tedious cycle of manual navigation that slows down every update. This Connector changes that by letting you handle those tasks directly from your AI client. You can ask your agent to pull transcripts, check conversation variables, or query your knowledge base without ever leaving your chat. It's about getting the info you need to actually improve the bot's logic without the friction of a complex dashboard.

If you're trying to figure out why a specific flow is looping, you can just ask your agent to see the current state of a session. If you're worried that your RAG data isn't accurate, you can query the knowledge base directly to see what the bot thinks it knows. You can even trigger actions or send messages to the bot to test new prompts on the fly. Because Vinkius makes it easy to connect these types of tools, you can spend less time clicking around and more time actually shipping. You get a way to see what's happening under the hood and make changes in real-time. It turns a manual, multi-tab process into a simple conversation, letting you focus on the experience instead of the plumbing.

## Tools

### get_state
Check the current variables and conversation state for a user. It's perfect for seeing exactly where a user is stuck in a flow.

### get_transcript
Pull the full details of a specific conversation. Use it to read the exact back-and-forth between a user and the bot.

### interact
Send a message to your Voiceflow agent. This lets you test responses and trigger actions instantly from your chat.

### list_kb_docs
See all the documents currently in your knowledge base. Use it to verify that your RAG data is loaded correctly.

### list_transcripts
Get a list of all conversation transcripts. Use this to find specific sessions for review.

### save_state
Update or set user variables and conversation states. Use this to manually move a user through a flow or set specific data.

### query_kb
Ask a question directly to your Knowledge Base. It lets you see what the bot knows without having to run a full test.

### list_kb_tags
See all the tags applied to your knowledge base documents. Use it to organize and find specific content types.

### list_projects
See a list of all your Voiceflow projects. This makes it easy to switch between different bots you're managing.

### delete_state
Reset a user's conversation state. This is the fastest way to clear a session and start a test from scratch.

### get_feedback
Pull user upvotes and downvotes. This helps you see what parts of the conversation are actually working for people.

### get_project
Get the specific details for a Voiceflow project. Use this to quickly check your current configuration settings.

## Prompt Examples

**Prompt:** 
```
Show me the last 3 transcripts for my Customer Support bot.
```

**Response:** 
```
I've pulled the most recent logs for you. Here they are:

| User ID | Status | Summary |
| :--- | :--- | :--- |
| User_8823 | Success | Completed refund check |
| User_8824 | Dropped | Connection lost at payment |
| User_8825 | Handoff | Moved to human agent

Would you like me to pull the full dialogue for any of these?
```

**Prompt:** 
```
What does our Knowledge Base say about the refund policy?
```

**Response:** 
```
According to the documentation, customers can request a refund within 14 days of purchase. However, the items must be in their original packaging. Should I check for any other specific details?
```

**Prompt:** 
```
Update the user's status to 'Premium' and move them to the VIP flow.
```

**Response:** 
```
I've updated the conversation state for this user. Their status is now set to 'Premium', and I've triggered the transition to the VIP flow. Is there anything else you'd like to change?
```

## Capabilities

### Query knowledge bases
Ask questions directly against your uploaded documents to see what the bot knows.

### Manage conversation states
Update or reset user variables to debug complex logic and move users through flows.

### Fetch conversation logs
Pull full transcripts to monitor user interactions and find specific sessions.

### Send messages to agents
Trigger actions and test responses in real-time from your chat interface.

### Monitor user feedback
Retrieve upvotes and downvotes to see which parts of your bot are performing well.

### List project details
See a list of your projects and configurations to manage your entire bot ecosystem.

## Use Cases

### Debugging a looping flow
A designer notices a bot is stuck. They use get_state to see the current variables and save_state to reset the user to the start of the flow.

### RAG verification
A developer wants to see if a document was indexed. They use query_kb to ask a specific question and check the accuracy of the returned data.

### User sentiment analysis
A product manager wants to see if a new flow is liked. They use get_feedback to see the ratio of upvotes to downvotes from real users.

### Testing a new prompt
A designer wants to see how the bot reacts to a specific phrase. They use interact to send a message and see the immediate response.

## Benefits

- Test flows faster by using interact to trigger responses without manual clicks in the builder.
- Debug complex logic instantly with get_state and save_state to see exactly where variables are failing.
- Audit your RAG performance by using query_kb to see what your knowledge base actually returns.
- Monitor real user sentiment by pulling data with get_feedback to see what is working for your audience.
- Save time on research by using list_transcripts to find specific user issues in seconds.
- Manage multiple projects easily with list_projects to keep your different bots organized.

## How It Works

The bottom line is you get a direct line of command to your Voiceflow projects from your chat interface.

1. Subscribe to this Connector on Vinkius and grab your Voiceflow API Key and Version ID.
2. Add those credentials to your AI client's configuration.
3. Start asking your agent to manage your bots, logs, and knowledge bases.

## Frequently Asked Questions

**How can I use the Voiceflow MCP to test my chatbot?**
You can send messages directly to your bot through your AI client to see how it responds in real-time. This lets you test complex flows and triggers without having to manually click through the builder.

**Can I check my Voiceflow Knowledge Base with this Connector?**
Yes, you can ask your AI agent to query your Knowledge Base directly. This helps you verify that your RAG data is accurate and that the bot is pulling the correct information.

**How does the Voiceflow MCP help with debugging?**
It gives you direct access to conversation states and transcripts. You can see exactly where a user got stuck or check the variables at any point in the flow to find and fix logic errors quickly.

**Can I see user feedback through the Voiceflow MCP?**
You can pull user upvotes and downvotes directly into your chat. This makes it much easier to monitor how real people are interacting with your bot and identify areas that need improvement.

**Is the Voiceflow MCP good for managing multiple bots?**
Yes, it lets you list all your projects and quickly switch between them. You can manage your entire conversational ecosystem from one place instead of opening multiple tabs.

**Can I reset a user session using the Voiceflow MCP?**
You can use the Connector to clear a user's conversation state. This is great for testing because it lets you start a fresh session with a single command.

**Does the Voiceflow MCP work with Claude and Cursor?**
Yes, it works with any MCP-compatible client, including Claude, Cursor, and Windsurf. You just need your Voiceflow API key to get started.

**Can I query my Voiceflow Knowledge Base directly via AI?**
Yes! Use the `query_kb` tool with your question. Your agent will trigger the Voiceflow RAG system and return the answer based on your uploaded documents.

**How do I see the transcripts for a specific project?**
Run the `list_transcripts` query with your Project ID. The agent will return a list of past conversation logs, which you can then inspect using `get_transcript`.

**Is it possible to reset a user's session via AI?**
Absolutely. Use the `delete_state` tool and provide the User ID. This will permanently clear the conversation history and variables for that specific session.