How to Use the BrandMentions MCP in Claude

Q: Can I manage my active tracking campaigns from Claude Desktop?

Yes. You can use listprojects to see what you are currently tracking, and add new ones using addproject directly from the chat.

Q: How does Claude Desktop show me top social accounts for my BrandMentions projects?

Claude Desktop calls the getinfluencers tool for your specific project ID. It then parses the list of accounts and displays their reach directly in your conversation.

Q: How do I keep track of my API limits?

Ask your agent to check your remaining balance. It runs getremainingcredits to show you exactly how many queries you have left for the month.

Track social listening data and keywords directly from Claude Desktop using this dedicated MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BrandMentions MCP to Claude Desktop

Create your Vinkius account to connect BrandMentions 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 BrandMentions with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Instant Web Searches in Claude Desktop

The `post_search` tool kicks off immediate keyword scans across the web right inside your chat window. You don't have to open a separate dashboard or wait for daily reports when you need to know what people are saying about your brand right now. Once your search starts, you can check progress with `get_processed_mentions` to pull in partial results immediately, or wait and use `get_mentions` to grab the complete dataset. This MCP connection lets you analyze real-time sentiment changes inside Claude Desktop without manually exporting CSV files.

Manage BrandMentions Projects via Claude

The `add_project` tool lets you spin up new tracking campaigns for specific keywords or competitors directly from your chat interface. You can set up daily tracking parameters without navigating the web app UI, keeping your market research pipeline moving. When projects run their course, clean up your workspace using `delete_project` and list what's active with `list_projects`. Your Claude Desktop client handles the API calls so you can focus on analyzing the actual data trends.

Identify Key Influencers and Monitor Usage

The `get_influencers` tool extracts a list of high-impact accounts talking about your tracked keywords directly into your workspace. Instead of manually sorting through social noise, your desktop agent filters the top voices for your outreach campaigns. Keep an eye on your consumption limits using `get_remaining_credits` before launching massive search queries. This MCP Server integration ensures you never hit unexpected API blocks while gathering social listening intelligence.

Setup guide

Set up BrandMentions 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 BrandMentions 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 BrandMentions 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 brandmentions-mcp.

json

{
  "mcpServers": {
    "brandmentions-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 BrandMentions. 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 BrandMentions 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 BrandMentions MCP in Claude Desktop

Just tell Claude Desktop to search for a specific keyword. It calls `post_search` to run an on-the-spot job and then retrieves the results using `get_mentions` once the scan finishes.

Yes. You can use `list_projects` to see what you are currently tracking, and add new ones using `add_project` directly from the chat.

Claude Desktop calls the `get_influencers` tool for your specific project ID. It then parses the list of accounts and displays their reach directly in your conversation.

Ask your agent to check your remaining balance. It runs `get_remaining_credits` to show you exactly how many queries you have left for the month.

Vinkius runs the server in an ephemeral, zero-trust V8 sandbox. Your tracked keywords, project setups, and social mention data never persist on our servers; they only pass through to your local Claude Desktop app.

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