How to Use the Brandwatch MCP in Cursor

Q: How does Cursor handle Brandwatch API rate limits?

Cursor executes tool calls like getvolumeaggregates only when you explicitly ask it to. This prevents your development environment from making unnecessary requests that could exhaust your API quota.

Q: Can Cursor write code to automate my Brandwatch tagging?

Yes, your agent uses createtag to test tagging logic directly inside your codebase with this MCP Server. You can write scripts in Cursor that categorize incoming social mentions based on your custom rules.

Q: How do I list my active projects in the editor?

You can use listprojects to fetch your active workspaces. Your agent reads this list to help you configure your local environment variables correctly.

Write code using real-time Brandwatch social metrics and project data directly in Cursor.

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 Cursor

Create your Vinkius account to connect Brandwatch to Cursor 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Inject live social data into your Cursor code

The `get_mentions` tool lets your agent pull real social media posts directly into the files you are editing in Cursor. You can write and test parsing algorithms using real-world data instead of relying on outdated mock JSON files. Having this MCP Server active in your editor means you can instantly verify how your application handles different social media formats. Your agent writes the code, executes it against live API responses, and fixes bugs on the fly.

Sync Cursor code with Brandwatch dashboards

The `list_dashboards` and `list_projects` tools provide the exact structure of your active marketing campaigns directly to Cursor. Your agent reads your actual dashboard setups to scaffold matching UI components in your codebase. This direct link eliminates the guesswork of matching API keys to UI charts. You build front-end dashboards that align perfectly with your actual backend tracking setup using this MCP connection.

Verify Brandwatch queries in your editor

The `list_queries` and `list_tags` tools give your Cursor agent access to your exact tracking filters. You can write scripts that automatically check if your code references the correct query IDs. If you need to create new categories programmatically, your agent uses `create_tag` to update your workspace. This keeps your local development environment perfectly in sync with your live social listening setup.

Setup guide

Set up Brandwatch MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Brandwatch MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Brandwatch transactions." If the MCP tools are loaded correctly, Cursor will call the Brandwatch tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/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 Cursor

Yes, Cursor can run these tools directly through its agent chat mode. The editor uses the MCP Server to pull your active social listening data straight into your workspace.

Cursor executes tool calls like `get_volume_aggregates` only when you explicitly ask it to. This prevents your development environment from making unnecessary requests that could exhaust your API quota.

Yes, your agent uses `create_tag` to test tagging logic directly inside your codebase with this MCP Server. You can write scripts in Cursor that categorize incoming social mentions based on your custom rules.

You can use `list_projects` to fetch your active workspaces. Your agent reads this list to help you configure your local environment variables correctly.

Your query configurations and brand mentions are handled via an isolated local connection in Cursor. No external servers store your proprietary research queries or social listening data.

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