vibewatch-mcp

Connect any MCP client to your Vibewatch community-sentiment data.

Vibewatch's MCP server exposes six read-only tools over your organization's data — sentiment overview, message search, daily insights, weekly reports, market context, and org details. This package is a thin stdio bridge to that server: it wraps mcp-remote with the Vibewatch server URL and key handling built in, so agents that speak stdio MCP (Buzz agents, Claude Code, Goose, Codex) connect with one binary and one environment variable.

Install

npm install -g vibewatch-mcp

Requires Node 18+.

Related MCP server: Feedback Synthesis MCP

Get a key

1. In app.vibewatch.io, open Settings → API Access.

2. MCP access is opt-in per organization — an owner or admin enables it there.

3. Mint a key. Keys start with vw_mcp_ and are shown once — store it like a password.

The key is org-scoped and read-only. Revoke it any time from the same screen.

Use with Buzz

Buzz attaches one MCP server binary to every agent it spawns via BUZZ_ACP_MCP_COMMAND (a bare binary path, no arguments — which is why this wrapper exists). Set both variables in the environment your Buzz harness runs in:

export BUZZ_ACP_MCP_COMMAND="$(command -v vibewatch-mcp)"
export VIBEWATCH_MCP_KEY="vw_mcp_..."

Every agent in the workspace can then answer questions from your community data. To set up the full Vibewatch-on-Buzz install — report delivery into a channel plus a ready-made @vibewatch persona — open the Buzz tile under Settings → Reports in app.vibewatch.io and follow the setup walkthrough.

Use with any stdio MCP client

Claude Code:

claude mcp add vibewatch --env VIBEWATCH_MCP_KEY=vw_mcp_... -- vibewatch-mcp

Generic client config (Claude Desktop and compatible):

{
  "mcpServers": {
    "vibewatch": {
      "command": "vibewatch-mcp",
      "env": {
        "VIBEWATCH_MCP_KEY": "vw_mcp_..."
      }
    }
  }
}

Environment variables

Extra CLI arguments (e.g. --debug) pass through to mcp-remote.

The key never appears in the process argument list — the bridge hands mcp-remote a ${VIBEWATCH_MCP_KEY} placeholder and mcp-remote reads the value from the environment.

Tools

License

Apache-2.0