BrandMentions MCP integration
Run BrandMentions searches, manage monitoring projects, fetch mentions, influencers, analytics, and receive callback events.
Sign in, add BrandMentions in Apps, then choose the account your AI can use.
Get started with BrandMentions
- Add BrandMentions to your Weavz workspace and connect the account you want to use.
- Review the available tools below and enable the actions your task needs. Check the account permissions before allowing changes.
- Connect a compatible AI client to your workspace, or use the actions API from your application.
Tools
| Name | Description |
|---|---|
Get Remaining Credits get_remaining_creditsGet remaining PostSearch, AddProject, and Mentions credits for the BrandMentions account. | Get remaining PostSearch, AddProject, and Mentions credits for the BrandMentions account. |
Post Search post_searchCreate an on-the-spot asynchronous BrandMentions search job and return a search_hash. | Create an on-the-spot asynchronous BrandMentions search job and return a search_hash. |
Get Search Mentions get_search_mentionsRetrieve complete results for a PostSearch search_hash. Search hashes are valid for one hour. | Retrieve complete results for a PostSearch search_hash. Search hashes are valid for one hour. |
Get Processed Mentions get_processed_mentionsRetrieve partial processed results for a running PostSearch job, including processing_ended. | Retrieve partial processed results for a running PostSearch job, including processing_ended. |
Wait For Search Completion wait_for_search_completionPoll GetProcessedMentions until processing_ended is true or the attempt limit is reached. | Poll GetProcessedMentions until processing_ended is true or the attempt limit is reached. |
List Projects list_projectsList BrandMentions projects in the account. | List BrandMentions projects in the account. |
Add Project add_projectCreate a saved BrandMentions project that runs daily or according to project settings. | Create a saved BrandMentions project that runs daily or according to project settings. |
Edit Boolean Project edit_projectEdit an existing BrandMentions project that uses boolean expressions. | Edit an existing BrandMentions project that uses boolean expressions. |
Delete Project delete_projectDelete a BrandMentions project. | Delete a BrandMentions project. |
Get Project Mentions get_project_mentionsRetrieve saved mentions for a BrandMentions project with pagination and filters. | Retrieve saved mentions for a BrandMentions project with pagination and filters. |
Get Project Influencers get_project_influencersRetrieve influencers for a BrandMentions project with pagination and source filters. | Retrieve influencers for a BrandMentions project with pagination and source filters. |
Get Mentions Count get_mentions_countRetrieve total mentions count for a BrandMentions project. | Retrieve total mentions count for a BrandMentions project. |
Run Project Historical run_project_historicalRun historical data retrieval for a BrandMentions project. | Run historical data retrieval for a BrandMentions project. |
Add Review Source To Project add_review_source_to_projectAdd a reviews source URL to an existing BrandMentions project. | Add a reviews source URL to an existing BrandMentions project. |
Get Main Keywords Count get_main_keywords_countEstimate keyword credits consumed by a BrandMentions boolean expression. | Estimate keyword credits consumed by a BrandMentions boolean expression. |
Custom Command custom_commandMake a bounded BrandMentions command.php call using the configured API key. | Make a bounded BrandMentions command.php call using the configured API key. |
Triggers
| Name | Description |
|---|---|
New Project Mention new_project_mentionTriggers when a new BrandMentions project mention appears after the initial baseline. | Triggers when a new BrandMentions project mention appears after the initial baseline. |
New Negative Project Mention new_negative_project_mentionTriggers when a new project mention with negative sentiment appears after the initial baseline. | Triggers when a new project mention with negative sentiment appears after the initial baseline. |
New High Influence Project Mention new_high_influence_project_mentionTriggers when a new mention meets the configured performance, influence, or author reach threshold. | Triggers when a new mention meets the configured performance, influence, or author reach threshold. |
New Project Influencer new_project_influencerTriggers when a new influencer appears for a BrandMentions project after the initial baseline. | Triggers when a new influencer appears for a BrandMentions project after the initial baseline. |
New Processed Search Mention new_processed_search_mentionPoll a PostSearch search_hash and emit newly processed mentions while the job is valid. | Poll a PostSearch search_hash and emit newly processed mentions while the job is valid. |
Mention Count Changed mention_count_changedTriggers when GetMentionsCount changes for a BrandMentions project. | Triggers when GetMentionsCount changes for a BrandMentions project. |
Search Completed search_completedPoll GetProcessedMentions and emit once when processing_ended becomes true. | Poll GetProcessedMentions and emit once when processing_ended becomes true. |
Callback Received callback_receivedReceive parsed BrandMentions callback payloads from PostSearch or AddProject. Official docs do not publish a webhook signature scheme. | Receive parsed BrandMentions callback payloads from PostSearch or AddProject. Official docs do not publish a webhook signature scheme. |
Search Callback Received search_callback_receivedReceive BrandMentions callbacks that include search_hash. | Receive BrandMentions callbacks that include search_hash. |
Project Callback Received project_callback_receivedReceive BrandMentions callbacks that include project_id. | Receive BrandMentions callbacks that include project_id. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('brandmentions', 'get_remaining_credits', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'brandmentions',
input: { /* ... */ },
})Related Integrations
Explore integrations in other categories
Frequently Asked Questions
Is there a BrandMentions MCP server through Weavz?
Yes. Add the BrandMentions integration to a Weavz workspace, enable the actions you need and connect any required account. Weavz provides the workspace MCP endpoint in Tool Mode or Code Mode. The catalog currently lists 16 BrandMentions actions.
What can an AI agent do with BrandMentions?
Available actions include Get Remaining Credits, Post Search, Get Search Mentions, Get Processed Mentions, Wait For Search Completion, and more. Your workspace exposes only the actions you enable. The agent also needs the intended account access and any required input values.
How do I connect BrandMentions to Claude or ChatGPT?
Use a compatible remote MCP client, add the Weavz connector and choose a workspace. Add BrandMentions, connect the required account and review the enabled actions. Client availability and account requirements vary; adding the connector does not authorize every app automatically.
Can I use BrandMentions through an API or SDK?
Yes, supported actions can run through the Weavz REST API, TypeScript SDK or Python SDK. Configure a workspace and the required connections, use scoped access, and pass the intended end-user context when acting for a customer.
What authentication does BrandMentions require?
The catalog lists an API key for BrandMentions. Use Hosted Connect to authorize the intended account. Required permissions, provider app access and available connection methods depend on the integration.
How do I review sensitive BrandMentions actions?
Limit enabled actions, scope credentials to the intended user and configure Human Gates for the operations that need review. A matching policy can pause a send, record change or other sensitive action for an approver before execution.
What limits or costs apply to BrandMentions?
Weavz plan limits apply to the actions and resources you use. The external provider may also require an account, a paid plan, API credits or specific permissions, and may enforce its own rate limits. Check current Weavz pricing and the provider’s terms before rollout.
What BrandMentions triggers are available?
The catalog lists 10 triggers, including New Project Mention, New Negative Project Mention, New High Influence Project Mention, New Project Influencer, New Processed Search Mention, and more. Configure the trigger and your event handler before using incoming events to start work.
Connect BrandMentions in minutes
Get 20,000 free action executions every month. No credit card required.