# BrandMentions MCP MCP > BrandMentions tracks brand sentiment and monitors social listening from anywhere. This MCP lets your AI agent manage entire brand campaigns—from setting up a new tracking project to pulling detailed mentions for competitor analysis or discovering key influencers—all without leaving your chat window. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** social-listening, web-monitoring, brand-tracking, competitor-analysis, sentiment-analysis, market-intelligence ## Description Monitoring your brand reputation used to mean logging into multiple dashboards, filtering keywords manually, and compiling data across several tabs. Now, you can talk to your AI client and handle all that work in one conversation. You tell the agent what keywords or competitors you need to track, and it runs the search job for you. When the results are ready, you don't download a file; you ask for them. The system retrieves structured mention data, pinpoints the most influential voices discussing your brand, and lets you manage all active tracking campaigns. Because this MCP is hosted through Vinkius, connecting to any compatible AI client means you get access to professional-grade social listening tools without ever needing to open a browser tab. It's pure conversational workflow. ## Tools ### add_project Creates a new, dedicated campaign to track brand keywords over time. ### delete_project Removes an existing tracking project from your account. ### get_influencers Lists the key people associated with a specific, active monitoring project. ### get_mentions Retrieves the complete set of results for a search job that has finished running. ### get_processed_mentions Gets partial, real-time results while a large search job is still running. ### get_project_mentions Retrieves all the mention data tied to a specific campaign project ID. ### get_remaining_credits Checks your account's current API credit usage and limit. ### list_projects Shows a list of all the active monitoring campaigns you have set up. ### post_search Starts an instant, one-time search job for a specific keyword or phrase. ## Prompt Examples **Prompt:** ``` List all active tracking projects in BrandMentions. ``` **Response:** ``` I've retrieved your projects. You have 3 active campaigns: 'Acme Corp Brand' (ID: proj_1), 'Competitor Analysis' (ID: proj_2), and 'Q3 Product Launch' (ID: proj_3). ``` **Prompt:** ``` Start a quick search for the keyword 'Vinkius'. ``` **Response:** ``` The search job has been started. The tracking hash is `hash_abc123`. You can query the results in a few moments. ``` **Prompt:** ``` Show me the top influencers for project proj_1. ``` **Response:** ``` Retrieving influencers... The top voices discussing your brand are TechReviewer (Score: 95) and MarketingGuru (Score: 88). ``` ## Capabilities ### Run immediate keyword searches Start an instant search job across web and social media for specific keywords. ### Set up tracking projects Create, list, or delete structured campaigns to continuously monitor a brand or competitor over time. ### Pull detailed mention data Retrieve full and partial results for specific search jobs or entire ongoing projects. ### Identify key influencers List the top voices who are discussing your tracked keywords associated with a project. ### Check API usage limits Get real-time information on your remaining credits and API quotas. ## Use Cases ### Crisis response monitoring A PR Manager hears rumors about the company. They ask their agent to 'Start an instant search for keywords related to the rumor.' The system uses `post_search` and then allows them to use `get_processed_mentions` repeatedly until they have enough data to draft a statement. ### Competitive deep dive A Brand Analyst needs to compare their brand against two competitors. They first use `add_project` twice, once for each competitor's name, then use `list_projects` to confirm both are running. Later, they request all data using `get_project_mentions`. ### Quarterly review prep A Marketing Director needs a summary of the last quarter's discussions. They first use `list_projects` to identify the relevant campaign, then ask for all historical data using `get_project_mentions` and finally find top voices with `get_influencers`. ### Quick check on a product name Someone wants to know if there's chatter about a new product code. They use `post_search` for the exact phrase, then wait a few minutes and ask for results with `get_mentions` once the job is complete. ## Benefits - Never leave the conversation to analyze data. You can use `get_processed_mentions` to pull in partial results while a search job is still running, keeping your workflow continuous. - Build structured monitoring efforts using `add_project`. This tool lets you set up campaigns for product launches or competitor tracking that run automatically over weeks, not just hours. - Identify who matters most. After setting up a project, simply asking to use `get_influencers` pulls back the top voices discussing your brand, saving research time. - Audit and report instantly using `get_project_mentions`. Instead of exporting data to Excel, you get structured mention lists directly in the chat for immediate analysis. - Keep track of costs with `get_remaining_credits`. This tool shows exactly how much API usage you have left before starting a big job. ## How It Works The bottom line is that you manage complex monitoring tasks using natural language commands from your AI agent. 1. Subscribe to this MCP and provide your BrandMentions API Key. 2. Ask your AI agent to perform a task, like 'List all my active campaigns' or 'Start tracking the word X'. 3. The MCP executes the job, retrieving structured data (like mentions or influencers) directly into the chat interface. ## Frequently Asked Questions **How do I monitor a new competitor with BrandMentions MCP?** You must first use the `add_project` tool to create a dedicated tracking campaign for that competitor. You can then ask your agent to list all active campaigns using `list_projects` to confirm it's running. **What is the difference between get_mentions and get_processed_mentions?** `get_mentions` gets results only after a search job has fully completed. Use `get_processed_mentions` when you need partial, real-time updates while a large search job is still actively running. **Can I find top influencers using the BrandMentions MCP?** Yes. After setting up and monitoring a project, use `get_influencers` to retrieve a list of key people who are discussing your brand within that specific campaign scope. **How do I check if my API credits are low using BrandMentions MCP?** You call the `get_remaining_credits` tool. This will return a precise status update on your current usage and remaining allowance for running searches. **How do I set up a new tracking effort using the `add_project` tool?** You run `add_project` to establish a dedicated container for your brand's data. This process creates a unique, isolated campaign ID where all future mentions and analytics will be stored. **If a tracking project is finished, should I use the `delete_project` tool?** Yes, you run `delete_project` when a monitoring goal is complete or if the data is no longer needed. This action permanently removes all associated campaign records from your account. **What's the workflow for running a quick keyword search using `post_search`?** `post_search` starts an immediate, on-demand job without needing to create a formal project first. It returns a tracking hash, which you must use later when checking the final results. **How do I pull all mention data for one specific campaign using `get_project_mentions`?** You specify the exact project ID when calling `get_project_mentions`. This ensures you only retrieve structured mention data relevant to that single, defined tracking effort. **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.