Brandwatch MCP server for your AI

A one call summary of a saved query, by name or id, over days or dates: total mentions, sentiment split, daily trend, top topics, top sites and top authors.

How many mentions match a query and filters in a date range.

Build any chart: an aggregate broken down by two dimensions, the same data as a Brandwatch dashboard.

Several measures on the same breakdown in one call, up to 10, which saves requests over repeated brandwatch_get_chart calls.

The authors behind most of a query's mentions, with volumes.

The links shared most inside a query's mentions, also called X Stories in Brandwatch.

The sites most of a query's mentions come from, with volumes.

What people are talking about: the words, phrases, hashtags, people and more in a query's mentions, like the Word Cloud in Brandwatch.

Share of voice: each saved query's mentions and percent of the total, from queries by name or id, or a query group id.

Save a new keyword query, after checking its boolean search with Brandwatch first.

Delete a saved query.

Get one query's full settings: boolean search, languages, content sources, start date, backfill progress (percentComplete) and whether it is sampled.

List a project's saved queries and channels: id, name, type (monitor, twitter, publicfacebook, instagram), languages, content sources.

Replace a query's settings, including its boolean search.

Change part of a query: its name, display name, or move it from draft to active.

Check a boolean search before saving it.

Create a tag, plain or one that applies itself through rules.

Collect up to 500 mentions of a saved query into one short table: id, date, url, title, short snippet, author, site, sentiment, reach.

Same as brandwatch_list_mentions but with each mention's full text where Brandwatch may share it.

The accepted values for sentiment, account type, gender, subtype and content sources.

Read the mentions a query or query group found in a date range, with snippets, links, authors, sentiment and tags.

List a project's rules: what each one matches (filter), what it does (ruleAction), whether it is on, and which queries it covers.

List a project's tags with their ids, names and automatic rules.

Find location ids by the start of a name, for query, rule and mention filters.

Read mentions for a saved query by NAME or id, with flat filters: days or dates, text, sentiment, content source, language.

Change mentions in Brandwatch: sentiment, tags, categories, priority, status, assignment, checked, starred, location.

Create a category with at least one subcategory, plain or applying itself through rules.

Create an alert that emails people about a query, on a schedule or when volume jumps.

List a project's categories with their subcategories under children.

List a project's custom alerts: name, queries, schedule, thresholds, recipients and when each runs next.

List a project's query groups with the queries in each.

Ask the Analysis API about any keywords for one day, without saving a query, and wait up to about 40 seconds for the answer.

Who is connected: the user, their role and their Brandwatch client in one answer, with the client's query and mention limits.

Get one Brandwatch project with its queries and default language.

List the Brandwatch projects this connection can use: id, name, description, time zone, client.

List a project's workflow options: who mentions can be assigned to, and the priority, status and checked values.

Compare a query's topics between genders: which topics lean to each.

The top demographic breakdown of a query's authors.

The Facebook users behind most of a channel's mentions.

The sites whose links are shared most inside a query's mentions.

The X (Twitter) accounts behind most of a query's mentions, with volumes.

The older topics call, with burst scores and sentiment per topic.

Daily volume for saved date ranges on a query, for comparing periods.

The emoji and emoticons used most in a query's X (Twitter) mentions.

The hashtags used most in a query's X (Twitter) mentions, with volumes.

The accounts named most in a query's X (Twitter) mentions.

The comments in a Facebook channel's data.

The posts in a Facebook channel's data, with their metadata.

The X (Twitter) posts in a channel's data with their metadata.

Save a list of authors.

Save a list of locations.

Save a list of sites.

Delete an author list.

Delete a location list.

Delete a site list.

Get one author list with its authors and sharing.

Get one location list with its places and sharing.

Get one site list with its domains and sharing.

List a project's author lists with the authors in each.

List a project's location lists with the places in each.

List a project's site lists with the domains in each.

Replace an author list.

Replace a location list.

Replace a site list.

Save a new keyword query in a project.

List the saved date ranges on a query, with the ids that brandwatch_get_volume_by_date_ranges takes.

List a project's queries with their full settings, including the boolean search, start date, location and image filters.

Check a boolean search inside one project, needed when contentSources names a custom data source.

Check the search text of a rule, tag or category before saving it.

Create a custom data source to upload your own documents into.

Delete a custom data source.

Delete uploaded documents from a custom data source, a whole batch or up to 1000 by guid or url.

How many documents have been uploaded this month and the monthly limit.

List your custom data sources, the places your own documents such as tickets or surveys go.

Set which projects can use a custom data source.

Upload your own documents, such as reviews or tickets, into a custom data source, up to 1000 a call.

Run a rule over mentions already collected.

Apply a tag's rules to mentions already collected, back to a date.

Create a rule that acts on matching mentions from now on.

Delete a rule so it stops acting on mentions.

Delete a tag from the project.

Find one mention in a query by its url or resourceId.

Get one rule with its filter and action.

Get one tag with its name and automatic rules.

Ready-made exclusions for job adverts, marketplace deals and the like.

The name of every filter that mentions and chart tools accept, beyond the common ones they show.

Logos Brandwatch can spot in images.

Objects and actions Brandwatch can spot in images.

Replace a rule, or turn it on or off with enabled.

Rename a tag or replace its automatic rules.

Apply a category's rules to mentions already collected, back to a date.

Group saved queries so they can be read together.

Subscribe people to Signals on some queries.

Delete a category, its subcategories and their rules.

Delete a custom alert.

Delete a query group.

Delete a Signals subscription.

Get one custom alert with its schedule, thresholds, recipients and filter.

Get one query group with its queries, sharing settings and users.

Get one Signals subscription with its queries and subscribers.

List a project's Signals subscriptions: which queries are watched for unusual changes and who is told.

Rename a category or replace its subcategories.

Change a custom alert, or pause it with enabled.

Replace a query group's name and queries.

Replace a Signals subscription.

Ask the Analysis API about any keywords over at most 24 hours, without saving a query.

Read an Analysis API result.

How much of the Analysis API allowance has been used, month by month.

The connected Brandwatch client, the organization that is billed: name, mention archive size, pricing model, query limits and the rate limit set for it.

The connected Brandwatch user's profile: username, names, role, API roles, client id and products.

List projects with more detail than brandwatch_list_projects: their queries and default language.