Vibeads MCP Server

by vibeadsio.github.chiranj/mcpv0.2.4

Google Ads for local service businesses: account scoring, wasted-spend detection, campaign drafting and optimization, with human approval before spending.

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Deprecated2d ago

Install Vibeads MCP server

claude mcp add vibeads -e VIBEADS_API_KEY='<vibeads-api-key>' -- npx -y @vibeads/mcp

{
  "mcpServers": {
    "vibeads": {
      "command": "npx",
      "args": [
        "-y",
        "@vibeads/mcp"
      ],
      "env": {
        "VIBEADS_API_KEY": "<vibeads-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "vibeads": {
      "command": "npx",
      "args": [
        "-y",
        "@vibeads/mcp"
      ],
      "env": {
        "VIBEADS_API_KEY": "<vibeads-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "vibeads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@vibeads/mcp"
      ],
      "env": {
        "VIBEADS_API_KEY": "<vibeads-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "vibeads": {
      "command": "npx",
      "args": [
        "-y",
        "@vibeads/mcp"
      ],
      "env": {
        "VIBEADS_API_KEY": "<vibeads-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
VIBEADS_API_KEY	yes	yes	Your VibeAds MCP API key (generate at getvibeads.com/app/settings/mcp)

Freshness

Deprecated — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-07 · 2d ago · GitHub
Latest release
2026-04-13 · 6mo ago · GitHub · v0.1.0
Package published
no data · npm/PyPI
Registry entry updated
2026-07-18 · 3mo ago · official registry · v0.2.4

FAQ

›How do I install the Vibeads MCP server in Claude Code?

Run: claude mcp add vibeads -e VIBEADS_API_KEY='<vibeads-api-key>' -- npx -y @vibeads/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Vibeads require an API key?

Yes. It expects VIBEADS_API_KEY, of which 1 is a secret.

›Can I use Vibeads as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Vibeads in the official MCP registry?

Yes, as io.github.chiranj/mcp.