Skip to content
Weavz
Menu
BrandMentions

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.

16 tools
10 triggers
Use withChatGPTClaudeClaude CodeCursorCodexMCP clientsSetup guide

Get started with BrandMentions

  1. Add BrandMentions to your Weavz workspace and connect the account you want to use.
  2. Review the available tools below and enable the actions your task needs. Check the account permissions before allowing changes.
  3. Connect a compatible AI client to your workspace, or use the actions API from your application.

Tools

Name

Get Remaining Credits

get_remaining_credits

Get remaining PostSearch, AddProject, and Mentions credits for the BrandMentions account.

Post Search

post_search

Create an on-the-spot asynchronous BrandMentions search job and return a search_hash.

Get Search Mentions

get_search_mentions

Retrieve complete results for a PostSearch search_hash. Search hashes are valid for one hour.

Get Processed Mentions

get_processed_mentions

Retrieve partial processed results for a running PostSearch job, including processing_ended.

Wait For Search Completion

wait_for_search_completion

Poll GetProcessedMentions until processing_ended is true or the attempt limit is reached.

List Projects

list_projects

List BrandMentions projects in the account.

Add Project

add_project

Create a saved BrandMentions project that runs daily or according to project settings.

Edit Boolean Project

edit_project

Edit an existing BrandMentions project that uses boolean expressions.

Delete Project

delete_project

Delete a BrandMentions project.

Get Project Mentions

get_project_mentions

Retrieve saved mentions for a BrandMentions project with pagination and filters.

Get Project Influencers

get_project_influencers

Retrieve influencers for a BrandMentions project with pagination and source filters.

Get Mentions Count

get_mentions_count

Retrieve total mentions count for a BrandMentions project.

Run Project Historical

run_project_historical

Run historical data retrieval for a BrandMentions project.

Add Review Source To Project

add_review_source_to_project

Add a reviews source URL to an existing BrandMentions project.

Get Main Keywords Count

get_main_keywords_count

Estimate keyword credits consumed by a BrandMentions boolean expression.

Custom Command

custom_command

Make a bounded BrandMentions command.php call using the configured API key.

Triggers

Name

New Project Mention

new_project_mention

Triggers when a new BrandMentions project mention appears after the initial baseline.

New Negative Project Mention

new_negative_project_mention

Triggers when a new project mention with negative sentiment appears after the initial baseline.

New High Influence Project Mention

new_high_influence_project_mention

Triggers when a new mention meets the configured performance, influence, or author reach threshold.

New Project Influencer

new_project_influencer

Triggers when a new influencer appears for a BrandMentions project after the initial baseline.

New Processed Search Mention

new_processed_search_mention

Poll a PostSearch search_hash and emit newly processed mentions while the job is valid.

Mention Count Changed

mention_count_changed

Triggers when GetMentionsCount changes for a BrandMentions project.

Search Completed

search_completed

Poll GetProcessedMentions and emit once when processing_ended becomes true.

Callback Received

callback_received

Receive parsed BrandMentions callback payloads from PostSearch or AddProject. Official docs do not publish a webhook signature scheme.

Search Callback Received

search_callback_received

Receive BrandMentions callbacks that include search_hash.

Project Callback Received

project_callback_received

Receive BrandMentions callbacks that include project_id.

Quick Start

TypeScript
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.