# Brandwatch MCP for AI Agents AI Agent Connect > Brandwatch connects your consumer research and social listening data directly to your AI client. It lets your agent list projects, track specific search queries, and pull raw social mentions or volume aggregates. Instead of manual CSV exports, you can ask your agent to find specific trends or summarize brand sentiment across different platforms in real-time. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_U3iNoOtAHtq2EggV7EV28iaIxEv7vfFgwz5tvTKu/ai-agent-connect - **Tags:** consumer-intelligence, social-listening, market-research, sentiment-analysis, data-visualization, trend-tracking ## Description Brandwatch connects your consumer research and social listening data directly to your AI client. This setup gives your agent a direct line to your social listening projects. You can ask it to find specific mentions from last week, check how many people are talking about a new product launch, or even create new tags to organize your incoming data. It handles the heavy lifting of navigating the dashboard for you. Instead of downloading files and trying to make sense of them, you just talk to your agent about the trends you care about. It's a much faster way to handle market research because the data lives where you're already working. If you're looking for a way to centralize your consumer intelligence, finding this in the Vinkius catalog makes it easy to get set up without messing with complex requests. It turns your social listening setup into an active research tool rather than just another dashboard to check once a day. ## Tools ### create_tag Create a new category tag to organize your social mentions. This helps you group data by specific themes or campaigns. ### get_mentions Pull raw social posts for a specific query. Use this to see exactly what people are saying about a brand or product. ### get_project Get the specific details and metadata for a research project. This helps you quickly identify project scopes and settings. ### get_volume_aggregates Pull total mention counts for a query over a time range. It's great for spotting spikes or identifying trends. ### list_dashboards See all the different dashboards available within a project. This gives you a high-level view of your research setup. ### list_queries See the search terms and queries you've set up for a project. It helps you manage what your account is currently tracking. ### list_tags See all the tags you've already created to categorize your social data. Use this to check existing categories before making new ones. ### list_projects Get a full list of all your active research projects. Use this to navigate between different research folders easily. ## Prompt Examples **Prompt:** ``` What are the top brand mentions from the last 24 hours for our Summer Launch query? ``` **Response:** ``` ### Recent Mentions for 'Summer Launch' | Platform | Mention | Sentiment | | :--- | :--- | :--- | | Twitter | "The new summer gear looks amazing!" | Positive | | Instagram | "Can't wait for the summer launch!" | Positive | | Reddit | "Is the summer launch actually happening?" | Neutral | **Summary:** The majority of mentions are positive, with high engagement on Instagram. ``` **Prompt:** ``` Can you show me a summary of the mention volume for Competitor X over the last month? ``` **Response:** ``` ### Competitor X Volume Summary (Last 30 Days) * **Total Mentions:** 42,500 * **Peak Activity:** July 14th (8,200 mentions) * **Trend Analysis:** * **Week 1:** 9,000 mentions * **Week 2:** 12,500 mentions (Spike) * **Week 3:** 11,000 mentions * **Week 4:** 10,000 mentions The volume peaked during the middle of the month, likely due to their mid-month promotional event. ``` **Prompt:** ``` I need to organize our new data. Can you create a new tag called Influencer_Review in my main project? ``` **Response:** ``` I've successfully created the new tag **Influencer_Review** in your main project. You can now use this to categorize mentions specifically related to influencer content. ``` ## Capabilities ### Pull raw social mentions Get specific posts and comments for a query to see what people are saying. ### Check mention volumes See how many times a brand was mentioned over a specific period of time. ### List active projects See all your current research folders in one place. ### Manage search queries See what specific terms your account is currently tracking. ### Organize data with tags Create and list categories to group your social data effectively. ### View dashboard metadata Get details on your existing research views and project layouts. ## Use Cases ### Spotting a viral moment A social media manager needs to know if a recent tweet went viral. They ask the agent to pull mentions for a specific hashtag from the last 3 hours. ### Summarizing competitor sentiment A market researcher wants to see a summary of brand sentiment. They ask the agent to pull volume aggregates for the last month. ### Navigating research folders A data analyst is looking for a specific project. They ask the agent to list all active projects and find the one for Competitor X. ### Organizing campaign data A brand manager wants to organize a new campaign. They ask the agent to create a new tag called Summer_Promo_2024 in their main project. ## Benefits - Stop exporting CSVs by using get_mentions to pull raw data directly into your chat. - Track brand health faster by using get_volume_aggregates to see spikes in mentions instantly. - Organize research on the fly by using create_tag to categorize data as you find it. - Navigate projects quickly by using list_projects and list_queries to see what is active. - Save time on reporting by using list_dashboards to get a high-level view of your research setup. ## How It Works The bottom line is you get instant access to your social listening data without leaving your chat interface. 1. Subscribe to the Brandwatch MCP on Vinkius. 2. Plug in your Brandwatch API credentials including your Username, Password, and Client ID. 3. Ask your AI client to pull data or summarize trends from your projects. ## Frequently Asked Questions **Can the Brandwatch MCP help me summarize social media trends?** Yes, it pulls volume aggregates and raw mentions so your agent can summarize what people are saying about your brand or industry. **How do I get my social listening data into my AI client?** You just connect your Brandwatch account and can then ask your agent to pull specific mentions or project details directly into the chat. **Can I use this to track my competitors?** Definitely. You can list your queries to see what is being tracked and pull mentions for any competitor brand to see what they are doing. **Does this Connector work with my existing Brandwatch projects?** It connects directly to your account, so it can see all your active projects and dashboards as they currently exist. **Can I create new categories for my research data?** Yes, you can use the tool to create new tags for categorizing mentions as you go, helping you keep your research organized. **Is this good for market research?** It is built for it. It lets you pull consumer intelligence and trend data without the manual work of downloading and cleaning files. **Can I retrieve social mentions for a specific date range?** Yes! Use the `get_mentions` tool with the Project ID, Query ID, and your ISO 8601 formatted start and end dates (e.g., 2024-01-01T00:00:00.000Z). **How do I see the volume trend of a query over time?** Simply ask the agent to `get_volume_aggregates` and provide the relevant IDs and date range. It will return the aggregated data points showing mention spikes. **Does the integration allow creating new boolean queries?** Currently, the toolset is focused on reading and retrieving data from existing setups. Creating complex boolean queries should be done via the Brandwatch web interface to utilize their query builder and syntax validation.