# VBOUT MCP > VBOUT connects your marketing automation platform to any AI agent. You manage leads, trigger workflows, schedule social posts, and sync e-commerce orders—all through natural conversation. It lets you treat your entire customer lifecycle as a single chat session. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** lead-nurturing, campaign-management, social-media-marketing, landing-pages, marketing-analytics ## Description Yo, listen up. The VBOUT MCP Server hooks your marketing automation platform right up to any AI agent you're running. Forget jumping between screens to manage leads, run campaigns, or schedule social posts; we let you do it all just by talking naturally to your agent. You treat the entire customer lifecycle like one continuous chat session—it’s that simple. **Manage Contact Data:** Need info on a client? You can use `search_contacts` to dig through your whole database, pulling up records based on names, emails, or even when they last bought something. If you need the full scoop, fire off `get_contact`, and it’ll retrieve every detailed profile for that single person. Got a new lead? Use `add_contact` to drop them directly into a specific VBOUT email list using just their email address and the correct list ID. **Sync E-commerce Orders:** When someone buys something, you don't want to track it manually. You can run `add_ecommerce_order`, which logs all the details of a customer’s purchase right into your VBOUT record system. This keeps your customer profile current and powerful for targeted marketing. **Run Automation Workflows:** If you need to re-engage a lead that went cold, or maybe kick off a welcome sequence for a new sign-up, you can use `list_workflows` first. That shows you every pre-set automation workflow VBOUT runs. Once you know which one it is, you trigger it with `trigger_workflow`, selecting the specific contact and initiating that marketing automation right then and there. **Track Campaign Statuses:** You gotta know what’s working and what’s collecting dust. Use `list_campaigns` to get a rundown of every campaign—both the ones running right now and the historical ones you ran last quarter. It lets you audit your whole marketing effort at a glance. **Post Social Media Content:** You don't need to switch over to a separate social media manager tool. To draft and publish posts, just use `create_social_post`. Your agent handles writing content across all your linked channels and pushes it out live. **List Email Lists:** Before you add anyone anywhere, you gotta know where they’re going. Use `list_email_lists` to pull up the names and IDs of every single email list setup inside VBOUT. This makes sure you don't send a message into thin air. Basically, your agent uses these tools to manage leads, kick off complex campaigns, sync sales data, post content on social media, and keep track of all your marketing efforts—all through conversation. You talk it out, and the system handles the heavy lifting. ## Tools ### add_contact Adds a new contact to a specified VBOUT email list using an email address and list ID. ### add_ecommerce_order Logs details of a customer's purchase, syncing the order into your VBOUT record system. ### get_contact Retrieves all detailed information for a single specified contact record. ### list_campaigns Provides a list of currently active and historically run marketing campaigns. ### list_email_lists Retrieves the names and IDs of all email lists configured within VBOUT. ### list_workflows Lists all available marketing automation workflows that can be triggered for contacts. ### search_contacts Searches your entire contact database using criteria like name, email, or last purchase date. ### create_social_post Publishes new content across your linked social media channels. ### trigger_workflow Initiates a specific marketing automation workflow for a chosen contact. ## Prompt Examples **Prompt:** ``` List all my email marketing lists in VBOUT. ``` **Response:** ``` I've retrieved your lists. You have 4 active directories: 'Main Newsletter', 'E-book Downloads', 'Webinar Leads', and 'Past Customers'. Which one would you like to add a contact to? ``` **Prompt:** ``` Add 'John Doe' (john@example.com) to the 'Webinar Leads' list. ``` **Response:** ``` Success! John Doe has been added to the 'Webinar Leads' list (ID: 10293). Shall I trigger the 'Welcome' workflow for him as well? ``` **Prompt:** ``` Post this to my social media: 'Join our upcoming MCP webinar! https://vinkius.com/live' ``` **Response:** ``` Social post scheduled! I've sent your content to VBOUT for publishing on your connected channels. The post includes the link to the webinar registration. ``` ## Capabilities ### Manage Contact Data Search for specific contacts, retrieve full profiles, or add new leads to designated email lists. ### Run Automation Workflows Trigger pre-set marketing automation workflows on demand for any individual contact. ### Track Campaign Statuses List all active and past marketing campaigns to audit your current commercial efforts. ### Post Social Media Content Draft and publish social media posts using the platform's connected channels. ### Sync E-commerce Orders Log incoming customer orders directly into VBOUT to update customer records. ## Use Cases ### The Cold Lead Re-activation A marketing manager finds a list of leads who haven't opened an email in 60 days. They ask the agent to 'list all workflows for inactive users.' The agent uses `list_workflows`, identifies the 'Re-engagement Sequence,' and then executes `trigger_workflow` on the entire batch, solving the problem without leaving the chat. ### Post-Sale Marketing Sync An e-commerce owner uploads a spreadsheet of 50 recent orders. Instead of manually updating records, they ask the agent to process it using `add_ecommerce_order`. This immediately updates the customer segment in VBOUT so that the next day's email campaign is hyper-personalized. ### Rapid Social Campaign Deployment A team needs to post about a new product launch across three channels. They simply prompt, 'Post details about our new widget.' The agent uses `create_social_post`, handles the content formatting, and publishes it instantly, eliminating manual posting steps. ### Auditing Marketing Efforts A manager needs to know if a recent campaign hit its target audience. They ask the agent to 'list all campaigns.' The agent uses `list_campaigns`, pulls up the status, and provides an immediate audit trail for their review. ## Benefits - Stop clicking through five different tabs. You manage contact data and campaign status—from `get_contact` to `list_campaigns`—all within the AI client conversation window. - Keep your customer records accurate by syncing order data using `add_ecommerce_order`. This keeps your marketing segments fresh without manual spreadsheet updates. - Automate re-engagement. Instead of guessing, you list available automation workflows (`list_workflows`) and trigger them precisely when a lead goes cold, using `trigger_workflow`. - Never forget to post. Use `create_social_post` to schedule content instantly after running through your marketing checklist for the day. The AI handles the publishing step. - Find exactly who you need. If you're looking for a contact, don't scroll—use `search_contacts` and get actionable results immediately. ## How It Works The bottom line is, you manage your entire marketing engine from one chat window—no jumping between tabs or copying API keys into separate scripts. 1. Subscribe to the VBOUT MCP Server on Vinkius. Then, paste your VBOUT API Key (you find this in your account settings under API) into your AI client. 2. Your agent can now access VBOUT's tools. You instruct your agent—for instance, 'Find all leads who bought X last month.' 3. The agent executes the necessary tools (`search_contacts`, `list_campaigns`), pulls the data back, and gives you a clear answer in plain text. ## Frequently Asked Questions **How do I check if a contact exists before adding them to an email list using add_contact?** You should use `search_contacts` first. This verifies the person's existence and gives you their full profile details. Then, if they are new or need updating, you can safely run `add_contact`. **Can I make a complex marketing sequence using trigger_workflow?** Yes. You first use `list_workflows` to see what sequences are available. Then, when a contact meets the criteria, you simply ask the agent to 'trigger workflow X for this user,' which executes the entire predefined process. **What data does add_ecommerce_order sync into VBOUT?** It syncs core order details (purchase items, total price, date) directly into your contact's profile. This allows other tools like `list_campaigns` to factor in recent purchase history for better targeting. **What is the best way to find my email lists before adding a new lead?** Always run `list_email_lists` first. This gives you all available list IDs and names, so you don't guess or make mistakes when running `add_contact`. **What credentials do I need to use `list_campaigns`?** You must provide a valid VBOUT API Key. This key controls access and permissions for all tools, so make sure you're using the correct secret credential. **What happens if `add_contact` fails because of an invalid list ID?** The agent will return a specific error code detailing why the contact couldn't be added. You can then use `list_email_lists` to find and validate the correct list ID. **Are there rate limits when I run many `create_social_post` commands?** Yes, VBOUT enforces standard API rate limits for social publishing. If you hit a limit, the agent will tell you and recommend waiting before trying again. **How does `search_contacts` handle complex search criteria (e.g., name plus list)?** You structure your query to include all necessary parameters like name or domain, along with the target list ID. The tool returns a structured JSON object containing matching records. **Can I search for a specific contact using a keyword?** Yes! Use the `search_contacts` tool and provide your keyword. The agent will return matching contacts from your VBOUT database. **How do I trigger an automation for a new lead?** Use the `trigger_workflow` action. You'll need the Workflow ID and the contact's email address to start the automation manually via AI. **Is it possible to post to my social channels directly?** Absolutely. Use the `create_social_post` tool, provide your content and an optional link. VBOUT will handle the publishing to your connected profiles.