# BrandMentions MCP for AI Agents AI Agent Connect > BrandMentions lets you monitor social listening and brand mentions via an AI agent. You can track specific keywords, manage ongoing marketing projects, and pull influencer data without leaving your primary workflow. It connects your BrandMentions account to your AI client so you can audit sentiment and manage campaigns through natural conversation. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_SufU7LPdIHh7Xo26CWULB6RifbHyU7E2ISlPn6UN/ai-agent-connect - **Tags:** social-listening, web-monitoring, brand-tracking, competitor-analysis, sentiment-analysis, market-intelligence ## Description You're tired of jumping between tabs to see what people are saying about your brand. Instead of manually refreshing a dashboard to check for new mentions, you can just ask your AI client to give you a summary of the latest sentiment. This Connector connects your account directly to your daily workflow, turning a chore into a conversation. You can ask your agent to look for specific keywords across the web, pull a list of influencers who are actually talking about your products, or check your remaining credits. It's about getting the data you need exactly when you need it, without the friction of navigating a complex UI. Because Vinkius hosts this connection, you can plug it into your existing setup and start pulling structured mention data or creating new tracking projects in seconds. It moves the heavy lifting of social listening into a conversational interface, so you can spend more time acting on the insights and less time hunting for them. You don't have to worry about manual data entry or missing a spike in mentions because your agent stays on top of the feed for you. It handles the repetitive task of scanning for specific keywords so you can focus on strategy. You can track a product launch or monitor a competitor and get the same high-quality data without the manual overhead. ## Tools ### add_project Create a new project to start tracking specific keywords or brands daily. ### delete_project Remove a project from your active tracking list when it is no longer needed. ### get_influencers Pull a list of key influencers associated with your specific projects or keywords. ### get_remaining_credits Check your current API limits and remaining credits in real-time. ### get_mentions Retrieve the full results of a completed search job for deep analysis. ### get_processed_mentions View partial results for search jobs that are still running. ### get_project_mentions Pull all mentions tied to a specific project for quick review. ### list_projects See a list of all your active tracking projects and campaigns. ### post_search Trigger an immediate search for specific keywords across web and social media. ## Prompt Examples **Prompt:** ``` What are people saying about our new sneakers launch? ``` **Response:** ``` ### Recent Sentiment Summary | Metric | Status | | :--- | :--- | | **Overall Sentiment** | Mostly Positive | | **Top Theme** | Comfort & Style | | **Mention Count** | 142 | **Key Takeaways:** * People love the new colorways. * Some concerns about the sizing in the 'Pro' model. * High engagement from fitness influencers. ``` **Prompt:** ``` Who are the top influencers for our 'Summer Sale' project? ``` **Response:** ``` ### Top Influencers for 'Summer Sale' 1. **@FitLife_Daily** (Score: 98) 2. **@StyleIcon_Jane** (Score: 92) 3. **@TrendSeeker_NY** (Score: 87) These voices are currently driving the most conversation regarding our summer campaign. ``` **Prompt:** ``` How many credits do I have left for this month? ``` **Response:** ``` You have **450 credits** remaining out of your 1,000 monthly limit. You're currently at 55% of your monthly usage. ``` ## Capabilities ### Run instant web and social searches Trigger immediate searches for specific keywords and see results in your chat. ### Create and organize tracking projects Set up new projects to monitor specific brands or keywords on a daily basis. ### Audit brand mentions for sentiment Get a summary of how people feel about your brand from your ongoing projects. ### Identify key influencers Pull a list of the most relevant voices talking about your tracked keywords. ### Monitor real-time API credit usage Check your current credit limits and usage in real-time. ### Manage active marketing campaigns View and manage all your active tracking projects from one place. ## Use Cases ### Crisis Management A PR manager notices a spike in negative sentiment and asks the agent to pull mentions for a specific keyword to see the root cause. ### Influencer Outreach A marketing lead wants to find creators for a new product and asks for a list of influencers for a specific project. ### Competitive Analysis A brand manager wants to see how a competitor's launch is being received and asks for a summary of mentions for that brand. ### Budget Tracking An analyst checks their remaining credits to see how much monitoring they can do for the rest of the month. ## Benefits - Stop switching tabs by using `post_search` to get instant results on any keyword directly in your chat. - Manage your entire monitoring portfolio using `list_projects` and `add_project` to organize campaigns. - Identify high-impact voices faster with `get_influencers` to see who is actually driving the conversation. - Audit your brand's health quickly using `get_project_mentions` to see how people feel about your latest launch. - Stay on top of your budget by using `get_remaining_credits` to monitor your API usage without leaving your agent. ## How It Works The bottom line is you get real-time brand intelligence without ever opening a separate dashboard. 1. Subscribe to this Connector on the Vinkius Marketplace. 2. Enter your BrandMentions API Key into your AI client. 3. Ask your agent to pull mentions or start a new search. ## Frequently Asked Questions **Can BrandMentions MCP help me track my competitors?** Yes, you can create projects for competitor keywords and pull their mentions to see how they are performing against your brand. **How do I see the sentiment of my brand mentions?** You can ask the agent to retrieve mentions for a specific project, and it will provide a summary of the general sentiment. **Can I find influencers for my specific marketing campaigns?** Yes, the Connector can pull a list of key influencers associated with any project you have set up in BrandMentions. **Is it possible to check my API limits?** You can ask the agent to check your remaining credits at any time to stay on top of your usage. **Can I start a one-off search for a trending topic?** Yes, you can trigger an on-the-spot search for any keyword and get the results back in your chat. **How do I set up new tracking projects?** Just tell your agent to create a new project for a specific keyword or brand, and it will handle the setup for you. **Can I perform a quick search for a brand name?** Yes! Use the `post_search` action to trigger an immediate query. The tool will return a search hash, which you can then use with `get_mentions` to read the results. **How do I see the influencers for my tracked project?** Simply ask the agent to `get_influencers` and provide the Project ID. It will return the list of top voices mentioning your brand. **Does creating a search consume my account API credits?** Yes, standard API billing applies. You can always use the `get_remaining_credits` tool to check your quota before running large queries.