Skip to main content
Glama
ambo-sk

mcp-brandwatch

by ambo-sk
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

mcp-brandwatch

MCP server for the Brandwatch Consumer Research API, Data Upload API and Analysis API.

📋 Reviewing this? Start with IT-REVIEW.md — architecture, auth model, risk assessment, tool inventory and the open decisions. This README is the operator quick-reference.

Two flavours:

  • worker/ — remote server on Cloudflare Workers (connector URL). Primary.

  • server.py — local stdio server (subset). Legacy/local use.

Remote server (Cloudflare Worker)

Deployed at: https://mcp-brandwatch.gtm-ai.workers.dev

Connector URL (secret path — treat as a credential, it is in worker/.mcp-secret):

https://mcp-brandwatch.gtm-ai.workers.dev/<MCP_SECRET>/mcp

/sse also available for legacy SSE clients. Requests without the secret prefix get 404.

Secrets

cd worker
npx wrangler secret put BW_TOKEN        # long-lived API token — preferred
# or:
npx wrangler secret put BW_USERNAME
npx wrangler secret put BW_PASSWORD
npx wrangler secret put MCP_SECRET      # URL path key (already set)

Only "Regular" or "Admin" Brandwatch accounts can use the API. Tokens come from POST https://api.brandwatch.com/oauth/token (grant_type=api-password, client_id=brandwatch-api-client) and last ~1 year.

Deploy / dev

cd worker
npm install --legacy-peer-deps
npm run deploy      # or: npm run dev

Related MCP server: delta-mcp-prototype

Tools (55)

Group

Tools

Account

me, get_user, get_client

Projects

list_projects, get_project

Queries

list_queries, get_query, validate_query, create_query, update_query, delete_query

Query groups

list_query_groups, delete_query_group

Tags

list_tags, create_tag, delete_tag, backfill_tag

Categories

list_categories, create_category, delete_category, backfill_category

Rules

list_rules, get_rule, delete_rule

Author/site/location lists

list_groups, create_group, delete_group

Workflow & alerts

get_workflow, list_alerts, get_alert, create_alert, update_alert, delete_alert

Mentions

get_mentions (paged + cursor, fulltext), count_mentions, update_mentions

Charts & insights

chart, multi_aggregate_chart, topics, data_insights (hashtags/emoticons/urls/mentionedauthors/sharedsites)

Metadata

list_filters, list_metrics, search_locations, list_exclusion_snippets

Data Upload

list_content_sources, create_content_source, update_content_source, delete_content_source, upload_documents, delete_documents, content_upload_usage

Analysis (billed per query)

analysis_submit, analysis_result, analysis_usage

Escape hatch

brandwatch_request (any method, any path)

Rate limit & optimisations baked in

  • Consumer Research API: 30 calls / 10 min per client (x-rate-limit headers). The worker appends _rateLimit to responses once usage hits 70% so the model backs off.

  • Metadata endpoints (tags, categories, lists, filters, metrics, locations, exclusion snippets) cached in-memory 5 min — Brandwatch's own recommended practice.

  • multi_aggregate_chart and count_mentions exist specifically to spend fewer calls.

  • OAuth token cached per isolate; auto-refresh once on 401.

  • Dates: ISO 8601 (2024-01-01 or 2024-01-01T00:00:00.000+0000). Analysis API ranges max 24h. Mentions pagination caps at 10,000 — use cursor beyond.

Refs: https://developers.brandwatch.com/llms.txt, Python client BrandwatchLtd/bcr-api.

This server cannot be installed

F
license - not found
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • instagram-mcp

    yeswanthreddyk
    A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for organic Instagram analytics via the Meta Graph API, providing read-only tools for profiles, media, insights, audience, and optional publishing.
    GPL 3.0

  • delta-mcp-prototype

    rilexus
    A
    license
    A
    quality
    C
    maintenance
    MCP server that wraps the UMT media monitoring API, enabling search and retrieval of media mentions with filters such as date range, language, sentiment, and tags.
    2
    20
    ISC

  • PostLake

    PostLake
    A
    license
    Not graded
    quality
    B
    maintenance
    Publish, schedule and read analytics across every major social network from one MCP server. 15+ tools covering publishing, scheduling, validation, media upload and normalised cross-platform analytics.
    MIT

  • sprout-mcp

    shauryasa0
    F
    license
    A
    quality
    C
    maintenance
    Read-only MCP server for the Sprout Social public API, exposing profile and post analytics as tools with raw JSON passthrough.
    5

View all related MCP servers

Related MCP Connectors

  • DATPAQ

    34 production API tools over one hosted MCP endpoint.

  • HasData

    All HasData scraping tools in one MCP server: Google, TikTok, Instagram, maps, e-commerce and more.

  • One

    Search, document and execute authenticated API calls across 700+ apps via one MCP server

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ambo-sk/mcp-brandwatch'

If you have feedback or need assistance with the MCP directory API, please join our Discord server