How to Use the BrandMentions MCP in Claude Code

Run headless social listening with Claude Code and the BrandMentions 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 Code

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Claude Code handles mentions in your pipeline

Integrate social data into your CI/CD flow by running `post_search` via the terminal. Claude Code executes the call and streams the JSON output to your logs. You can pipe the response into other scripts or store it in your database. It is built for headless automation where speed matters.

Automate project monitoring with Claude Code

Use `list_projects` to verify your active tracking status from the command line. Claude Code parses the output so you can run conditional logic based on your campaign count. It is the fastest way to check your status without opening a browser. You get clear, text-based feedback immediately.

Track API usage via Claude Code

Keep your DevOps scripts informed by polling `get_remaining_credits`. Claude Code provides the data you need to trigger alerts if your usage spikes. It prevents unexpected service interruptions. You can automate your entire monitoring stack using these terminal-based tools.

Setup guide

Set up BrandMentions MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see brandmentions-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest BrandMentions transactions." It will automatically discover and invoke the available BrandMentions tools.

Terminal

claude mcp add --transport http brandmentions-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the BrandMentions MCP

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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "brandmentions-mcp": {
      "type": "url",
      "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 Code

Use the add command with your specific endpoint URL. Claude Code will then auto-discover all 9 tools for your terminal sessions.

Yes, because it operates headlessly. You can schedule a script that triggers `post_search` to keep your data fresh every hour.

Security is enforced at the transport layer using Vinkius authentication. Only the specific mention strings retrieved from the API are handled by the agent process.

The server returns raw data to your terminal. You can use tools like jq to filter the `get_mentions` output for your specific requirements.

It supports every tool exposed by the server. You can list them all by running the help command within your terminal.

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