verbo-mcp-server

AI-powered WhatsApp agent for developers. Set up your agent, connect WhatsApp, send messages, and manage conversations — all from Claude Code, Cursor, or any MCP client.

Quick Start

1. Get your API key

Sign up at verbolab.co/developers and create an API key.

2. Install

claude mcp add verbo -e VERBO_API_KEY=vb_live_... -- npx verbo-mcp-server

3. Use it

Open Claude Code and ask:

Set up a Verbo agent for meusite.com.br, connect WhatsApp, and send a test message to +5511999999999

Available Tools

Setup

| Tool | Description | |------|-------------| | verbo_setup_crawl | Crawl a website to auto-configure the agent (name, FAQ, hours, tone) | | verbo_setup_connect | Start WhatsApp connection — returns URL to scan QR code | | verbo_setup_status | Check setup progress (account, config, whatsapp, agent) | | verbo_setup_disconnect | Disconnect WhatsApp, free the phone number |

Operations

| Tool | Description | |------|-------------| | verbo_send_message | Send WhatsApp text or image message | | verbo_list_conversations | List recent conversations (filter by status) | | verbo_get_conversation | Get conversation details and messages | | verbo_agent_status | Check WhatsApp connection + agent config | | verbo_configure_agent | Update greeting, FAQ, business hours |

REST API

All tools are backed by a REST API you can call directly:

# Crawl website to configure agent
curl -X POST https://verbolab.co/api/v1/setup/crawl \
  -H "Authorization: Bearer vb_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "meusite.com.br"}'

# Connect WhatsApp
curl -X POST https://verbolab.co/api/v1/setup/connect \
  -H "Authorization: Bearer vb_live_..."

# Check setup status
curl https://verbolab.co/api/v1/setup/status \
  -H "Authorization: Bearer vb_live_..."

# Send message
curl -X POST https://verbolab.co/api/v1/messages \
  -H "Authorization: Bearer vb_live_..." \
  -H "Content-Type: application/json" \
  -d '{"to": "+5511999999999", "message": "Hello!"}'

# Disconnect WhatsApp
curl -X POST https://verbolab.co/api/v1/setup/disconnect \
  -H "Authorization: Bearer vb_live_..."

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | VERBO_API_KEY | Yes | Your API key from verbolab.co/developers | | VERBO_API_URL | No | Custom API URL (default: https://verbolab.co) |