# Brandwatch MCP > Brandwatch connects social listening data directly into your AI agent. This MCP lets you analyze brand mentions, track competitor activity, and visualize market trends using natural conversation. List projects, check raw social mentions by query, or get volume aggregates to see how sentiment changes over time—all without leaving your workflow. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** consumer-intelligence, social-listening, market-research, sentiment-analysis, data-visualization, trend-tracking ## Description Brandwatch gives you a direct line into consumer research, letting you stop relying on clunky dashboards and manual exports. Your AI agent handles the heavy lifting of analyzing millions of data points about your brand and your competitors. Need to know what people are saying right now? You can query raw social mentions based on specific keywords or date ranges, giving you an immediate pulse check on your market health. Want to see if a campaign worked last quarter? Just ask for volume aggregates; the agent tracks mention spikes and overall trend changes over time. Even organizing data is simple; you can list available tags or create new ones right within your chat. Connecting Brandwatch through Vinkius means you get all this sophisticated social data analysis, orchestrated entirely through natural conversation, no matter which AI client you prefer. ## Tools ### create_tag Adds a new category tag to help organize mentions and social data records. ### get_mentions Fetches specific raw social media posts based on your defined search query. ### get_project Retrieves detailed information about a single, specified research project. ### get_volume_aggregates Calculates the total number of mentions over time for a given search query. ### list_dashboards Displays all available dashboards within an active research project. ### list_projects Provides a list of every ongoing and completed brand research project. ### list_queries Shows all the custom search queries that are currently configured within your project. ### list_tags Retrieves a list of every tag already available for categorization in the current project. ## Prompt Examples **Prompt:** ``` List all queries configured in project proj_1. ``` **Response:** ``` I've retrieved the queries for project proj_1. You have 3 queries running: 'Brand Name Mentions' (ID: q_1), 'Competitor X' (ID: q_2), and 'Industry Trends' (ID: q_3). ``` **Prompt:** ``` Get volume aggregates for query q_1 from Jan 1st to Jan 31st. ``` **Response:** ``` Retrieving data... There were 15,200 mentions in total during January. The highest spike occurred on Jan 15th with 4,500 mentions. ``` **Prompt:** ``` Create a new tag called 'Urgent Review' in project proj_1. ``` **Response:** ``` The tag 'Urgent Review' has been successfully created in your project. You can now use it to categorize mentions. ``` ## Capabilities ### Check active research projects List and retrieve detailed information about your brand's ongoing research projects and dashboards. ### Review configured search queries Access all the custom search queries you set up to monitor specific industry trends or brand health. ### Retrieve raw social mentions Query and inspect individual social media posts based on a defined query and date range. ### Analyze mention volume over time Get aggregated data to track how the total number of brand mentions changes, helping you spot trends or sudden spikes. ### Categorize social data List existing categorization tags or create new ones to keep your massive pool of social data organized. ## Use Cases ### A campaign needs immediate sentiment validation The social manager asks the agent, 'Show me all mentions for the new product launch from last week.' The agent uses get_mentions to pull raw data and then calculates volume aggregates to show if positive spikes followed the release. ### Quarterly report requires historical trend comparison The market researcher asks, 'What was the mention volume for competitor X in Q1 vs. Q2?' The agent uses get_volume_aggregates to compare the two periods and provides a simple spike analysis. ### Need to audit research scope quickly The analyst needs to know what data sources are available for Project Alpha. They use list_projects first, then check list_dashboards to see exactly which dashboards are live and active for review. ### Organizing messy incoming content feed A team member asks to tag all mentions related to 'policy changes.' The agent uses create_tag first, then applies the new category across existing data using list_tags verification. ## Benefits - Stop exporting to CSV. Instead of downloading massive data dumps, you simply ask the agent for volume aggregates, getting instant trend analysis right in your chat window. - Keep everything organized using categorization tags. You can list available tags or use a tool like create_tag to add new ones instantly when reviewing content. - Check brand health immediately by listing queries. This lets you verify if your current monitoring setup is tracking the right competitors and trends. - Get deep, granular data with get_mentions. Instead of just seeing a count, you can pull the actual raw social posts for detailed manual review. - Know what's running without clicking through menus. Use list_projects to see every active research initiative at a glance. ## How It Works The bottom line is, you tell your agent what insight you need, and it runs the complex Brandwatch queries for you. 1. Subscribe to this MCP and enter your Brandwatch API Username, Password, and Client ID. 2. Your AI client establishes a secure link to the Brandwatch service using those credentials. 3. You ask your agent for specific insights—like 'Show me the volume aggregates for Q4'—and get the data back in plain text. ## Frequently Asked Questions **How do I find out what projects are currently running with Brandwatch MCP?** You use list_projects. This tool quickly lists all active research initiatives in your account, so you know exactly where to focus your analysis. **Can the Brandwatch MCP give me a total count of mentions over time?** Yes, run get_volume_aggregates. You just need to specify the query and date range; it will calculate and provide the overall mention volume trend. **What is the difference between list_queries and list_tags in Brandwatch MCP?** list_queries shows your search terms (what you are looking for), while list_tags shows how people have already categorized the data after it's been found. **How do I retrieve specific raw posts using Brandwatch MCP?** You use get_mentions. This tool allows you to pull the actual social media content for a precise query and time frame, rather than just getting a number. **Does the Brandwatch MCP help me organize my data?** It does. You can use create_tag to define new categories or list_tags to see what organization structures are already in place for your mentions.