How to Use the Brandwatch MCP in Claude

Q: Can I organize my Brandwatch data from Claude Desktop?

Yes, you can structure your research using createtag and listtags directly in your chat. Claude Desktop instructs the server to apply these tags to your active projects without requiring you to log into the web dashboard.

Q: How do I view my active social listening dashboards?

The listdashboards tool retrieves your configured visual setups. Your agent reads this list to tell you which dashboards are tracking your active queries using the Brandwatch MCP Server.

Get live social mentions and consumer research data from Brandwatch directly inside your Claude Desktop chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Brandwatch MCP to Claude Desktop

Create your Vinkius account to connect Brandwatch to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Brandwatch with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Track social mentions inside Claude Desktop

The `get_mentions` tool lets your agent pull raw social media posts and consumer feedback directly into your Claude Desktop workspace. You do not need to export CSVs or open another browser tab to see what people are saying about your brand. When Claude Desktop has access to this MCP Server, it reads the actual text of these posts instantly. From there, you can ask your agent to categorize the sentiment or summarize the main complaints without manual copy-pasting.

Map Brandwatch projects and queries

The `list_projects` and `list_queries` tools expose your active research setups directly to Claude Desktop. Instead of hunting for project IDs in the web UI, you simply ask your agent to show you what is currently active. This MCP connection allows your agent to pull the exact query configurations using `get_project`. You get instant visibility into your tracking parameters during your normal chat workflow.

Monitor volume spikes in Claude Desktop

The `get_volume_aggregates` tool feeds raw numeric trend data from your Brandwatch queries straight to Claude Desktop. Your agent can immediately plot these numbers or flag sudden spikes in conversation volume. You can also keep your data organized by using `create_tag` and `list_tags` to mark important spikes. This turns Claude Desktop into a control center for organizing incoming public feedback.

Setup guide

Set up Brandwatch MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Brandwatch MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Brandwatch MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under brandwatch-mcp.

json

{
  "mcpServers": {
    "brandwatch-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Brandwatch. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Brandwatch now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Brandwatch MCP in Claude Desktop

Claude Desktop connects to this MCP Server to run tools like `get_mentions` on your behalf. The desktop client sends your local configuration commands to fetch active social posts directly into your active chat window.

Yes, you can structure your research using `create_tag` and `list_tags` directly in your chat. Claude Desktop instructs the server to apply these tags to your active projects without requiring you to log into the web dashboard.

You must have active API credentials for your Brandwatch workspace. Claude Desktop uses your unique credentials to authenticate every tool call, ensuring you only access your own projects.

The `list_dashboards` tool retrieves your configured visual setups. Your agent reads this list to tell you which dashboards are tracking your active queries using the Brandwatch MCP Server.

Your social mentions, query parameters, and project details never pass through third-party databases. All communication runs through a secure, local V8 sandbox that keeps your corporate social listening data private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript