# Zingtree MCP > Zingtree connects your AI agent to interactive workflow data. It lets you list entire decision trees, search content across nodes, and analyze detailed user sessions—from viewing path history to extracting form answers. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** decision-trees, workflow-automation, interactive-content, user-sessions, process-mapping, node-management ## Description This MCP gives your agent the ability to interact directly with Zingtree's complex workflows and session histories. Instead of manually clicking through dashboards or running separate reports, your AI client can query your entire decision map via natural language instructions. You can ask it to list every active tree in your organization or pinpoint exactly what a user did during a specific interaction. It retrieves the detailed path data for any user session, showing not just which nodes they hit, but also the exact answers they entered into forms along the way. The real power comes when you combine these inputs: you can ask it to find all sessions that failed at a particular step or search across every single node's text content. If you’re building automations that rely on user input—like passing form data from one system to another—the MCP handles the complexity while running inside Vinkius. This means when your agent pulls session details, it does so through a zero-trust proxy; your API keys never sit on disk. Furthermore, using Vinkius AI Analytics gives you full visibility into every single tool call made, showing exactly what data flowed and how your budget is being used. It keeps everything transparent. ## Tools ### get_session_form_data Gathers all values and answers submitted by the user during their workflow session. ### search_all_trees Searches for specified text, keywords, or labels across all content inside the system's trees. ### get_clean_session_path Retrieves the simple, linear sequence of steps taken during one user session. ### get_session_details Pulls detailed information about a specific user session, including browser data and interaction history. ### list_tree_sessions Generates a list of sessions for a specific workflow that happened within defined dates. ### get_tree_structure Returns the full, hierarchical structure of a single decision tree. ### list_tree_variables Shows every variable name currently being used across the system's trees. ### list_trees Returns a list of every interactive decision tree in your organization account. ## Prompt Examples **Prompt:** ``` List all decision trees in my Zingtree account. ``` **Response:** ``` I've retrieved your trees. You have 5 active workflows, including 'Customer Troubleshooting', 'Sales Intake', and 'Product FAQ'. Which one would you like to explore? ``` **Prompt:** ``` Show me the structure for tree ID '12345'. ``` **Response:** ``` I've fetched the structure for tree 12345. It contains 12 nodes, starting with 'Welcome' and branching into 'Technical Issue' or 'Billing Question'. Would you like to see the content of a specific node? ``` **Prompt:** ``` Get the form data for session ID 'XYZ-987-ABC'. ``` **Response:** ``` I found the form data for session XYZ-987-ABC. The user provided: Name: 'John Smith', Email: 'john@example.com', and Issue: 'Product Defect'. ``` ## Capabilities ### Map entire workflow structures Retrieve the complete node breakdown of any specific decision tree. ### Find content across all flows Search for keywords or labels within every single piece of text in your system's trees. ### Analyze user journey paths Get a clean, linear record of the steps a user took during a session. ### Extract specific user inputs Pull all form answers and variables entered by the user in a given session. ### Track performance over time List and review sessions for a tree within a custom date range. ## Use Cases ### Debugging the checkout path The agent finds that many users get stuck after Step 3. By using `get_clean_session_path` on failed sessions, it confirms they always hit a specific error node and never reach the final confirmation step. ### Compliance audit of data collection An operations analyst runs a query to list all active trees and then uses `list_tree_variables` to ensure that sensitive fields like SSNs are not being collected by any workflow unintentionally. ### Understanding support friction points A support manager needs to know what the top 10 issues are. They ask the agent to search all trees for 'billing' and then use `get_session_form_data` on related sessions to see common missing information. ### Preparing for a system update A product owner wants to modify a variable. They first call `list_trees` to scope the change, then use `get_tree_structure` to verify dependencies before making any edits. ## Benefits - Stop guessing why a customer got lost. Use the agent to analyze full session details, identifying exactly where users deviated from the intended path using `get_clean_session_path`. - No more manual design reviews. Ask for the full tree structure with `get_tree_structure` and get immediate visibility into complex logic without needing to open the designer tool. - Automate data capture. Use `get_session_form_data` to pull every piece of variable input from a user session, making it instant source material for reports or downstream systems. - Pinpoint content issues fast. Running `search_all_trees` lets you check for specific keywords across all workflows simultaneously, saving hours of manual searching. - Audit workflow performance easily. Use `list_tree_sessions` to pull records for a date range and track usage metrics automatically. ## How It Works The bottom line is that you get instant, structured access to deep workflow metrics without ever leaving your AI conversation. 1. Subscribe to this MCP and provide your Zingtree API key. 2. Connect the MCP to your preferred client (Cursor, Claude, etc.). 3. Ask your agent a question like: 'List all active trees' or 'Get form data for session XYZ'. ## Frequently Asked Questions **How do I use the get_session_details tool with Zingtree?** You provide the agent with a specific session ID. The MCP then fetches comprehensive data, giving you more than just the path; it includes browser information and detailed interaction history for that exact user session. **Can I use list_trees to see all my workflows?** Yes, calling `list_trees` returns a complete inventory of every interactive workflow in your organization. This is the first step if you need to know which specific process you want to analyze. **Which tool do I use for form data? get_session_form_data?** Correct. The `get_session_form_data` tool is designed specifically to pull all variable values and answers a user entered into the trees during their session, keeping your reporting clean. **Is search_all_trees better than searching specific nodes?** Yes. `search_all_trees` searches every label and piece of text across *all* workflows in a single call, making it much broader and more efficient than checking individual trees. **When should I use the `get_tree_structure` tool?** It immediately provides the full blueprint of any specific decision tree. This is useful when you need to understand all potential nodes and connections in a workflow before analyzing user interaction or data entry points. **How do I confirm what variables are available using `list_tree_variables`?** The tool lists every variable used across your organization's interactive trees. Use this to verify which context variables your agent needs to collect or reference when analyzing a session, preventing missing data issues. **Is `get_clean_session_path` better than getting full session details?** Yes, it provides a simplified, linear sequence of the user's journey. Use this specifically when your goal is mapping flow—understanding *how* they moved through the tree—rather than analyzing deep metadata like browser information or every single click. **How can I limit my historical analysis using `list_tree_sessions`?** You specify a precise start and end date range. This limits the data set to only relevant time periods, which is essential for performance and focusing your audit on specific campaigns or defined operational windows. **How do I find my Zingtree API Key?** Log in to Zingtree and go to Account > Organizations and Billing to find your unique API Key. **Can I see the path a specific user took in a tree?** Yes, the `get_session_details` or `get_clean_session_path` tools provide the exact sequence of nodes visited by a user during their session. **Is it possible to retrieve answers entered in forms?** Absolutely. Use the `get_session_form_data` tool with a session ID to extract all field values submitted by the user.