ReachDirect MCP
OfficialReachDirect MCP lets an MCP client such as Claude Desktop or Cursor perform and track one-to-one personal outreach.
Preview personalized messages by filling
{{first_name}},{{name}},{{company}}, and custom placeholders, including fallbacks.Send one email through Brevo, with optional dry-run validation plus sender and reply-to fields.
Send one WhatsApp message through WhatsApp Web using international phone numbers.
Append outreach contacts to an Excel log and list recent rows.
Record do-not-contact entries so future sends to that email or phone are refused.
Apply safeguards: refuse unfilled placeholders, validate emails/phones, and enforce daily send caps.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ReachDirect MCP Draft an intro email to Marie at Laurent Remorques, show it before sending"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ReachDirect MCP
Live demo: https://reach-direct-mcp.vercel.app (mock mode, nothing is sent) · deploys automatically on every push to main
An MCP server that lets Claude Desktop, Cursor or any MCP client do personal outreach for you: send an email through Brevo, send a WhatsApp message through WhatsApp Web, and log every contact to an Excel file. You state your name, sender address and message in the chat. Your assistant fills in the template, shows you the final text, and sends it once you say yes.
MCP server | Python 3.10+ · FastMCP · httpx (Brevo v3 API) · Playwright (WhatsApp Web) · openpyxl · phonenumbers |
Web demo | React 18 · TypeScript · Tailwind CSS · Vite, deployed on Vercel |
Tools
Tool | What it does |
| Fills |
| Sends one email through the Brevo transactional API over HTTPS. You need no SMTP setup or password, only |
| Opens WhatsApp Web in a browser and sends one message. On first use, a QR code is saved as an auto-refreshing |
| Appends Date, Name, Company, Email, Phone, Channel, Status and Notes to |
| Shows the latest rows of the log. |
| Records someone who asked not to be contacted. Later sends to that address or number are refused. |
Built-in safeguards:
Messages with unfilled
{{placeholders}}are refused.Email addresses are validated, and phone numbers must parse in international format.
Sends are capped per channel per day (
REACHDIRECT_DAILY_LIMIT, default 50).WhatsApp messages are URL-encoded, so
&,#and line breaks arrive intact.
Related MCP server: mcp-leadgen-orchestrator
Install
git clone https://github.com/weblinkify/reach-direct-mcp
cd reach-direct-mcp
python -m venv .venv && source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e .
playwright install chromiumMCP client config:
{
"mcpServers": {
"reachdirect": {
"command": "/ABSOLUTE/PATH/reach-direct-mcp/.venv/bin/reachdirect",
"env": {
"BREVO_API_KEY": "xkeysib-your-key",
"REACHDIRECT_OUTPUT_DIR": "~/Desktop",
"REACHDIRECT_DAILY_LIMIT": "50"
}
}
}
}Variable | Default | Purpose |
| — | Brevo → Settings → SMTP & API → API keys. The free plan sends 300 emails/day. |
| Desktop, else |
|
|
| WhatsApp browser profile, daily counters, do-not-contact list. |
|
| Max sends per channel per day. |
| bundled Chromium | Use |
Before the first email, verify your sender address or domain in Brevo (Senders, domains & IPs) and set up SPF/DKIM. Otherwise Brevo rejects the send, and the tool tells you why.
Example prompt
I'm Daniel Weber (daniel@weber-parts.example). Write to Marie Laurent
(marie.laurent@laurent-remorques.example, +33 6 12 34 56 78) at Laurent Remorques
about our trailer axle range.
1. preview_message with a short intro, then show me the text.
2. After I approve: send_email, then send_whatsapp with a one-line heads-up.
3. save_outreach_contact for Marie with channel "email+whatsapp".Web demo
cd frontend
npm install
npm run dev # http://localhost:5173You can pick a fictional contact and a template, edit the placeholders and see the email or WhatsApp preview. A mock "send" applies the same validation, do-not-contact and daily-limit rules as the server and logs the attempt. Nothing leaves the browser.
Vercel: import the repo and set Root Directory to frontend; frontend/vercel.json does the rest.
Development
make install # dependencies and git hooks
make check # lint, types, tests and build: everything CI runs before merge
make audit # pip-audit and npm auditResponsible use
Send one-to-one messages to people with a reason to hear from you, honour opt-outs (add_do_not_contact)
and follow the rules where you operate (GDPR / ePrivacy, CAN-SPAM, KVKK). WhatsApp's terms restrict
automated and bulk messaging; misuse can get your number banned. This tool sends one approved message
per call on purpose.
License
MIT
Available Tools
6 toolsadd_do_not_contactAdd Do Not ContactB
Record that someone asked not to be contacted. Future sends to them are refused.
Inputs: email_or_phone (required). Returns: result
list_outreach_contactsList Outreach ContactsC
Latest rows of the outreach log.
Inputs: limit. Returns: result
preview_messagePreview MessageD
Fill {{first_name}}, {{name}}, {{company}} and any extra {{placeholders}} (fallbacks: {{first_name|there}}).
Inputs: template (required), extra, company, recipient_name. Returns: result
save_outreach_contactSave Outreach ContactB
Append a row to outreach_contacts.xlsx (Date, Name, Company, Email, Phone, Channel, Status, Notes).
Inputs: name (required), email, notes, phone, +3 more. Returns: result
send_emailSend EmailB
Send one email through Brevo (needs BREVO_API_KEY and a sender verified in Brevo).
Inputs: message (required), subject (required), sender_name (required), sender_email (required), +4 more. Returns: result
send_whatsappSend WhatsappA
Send one WhatsApp message through WhatsApp Web (a browser window opens; first run asks for a QR scan).
Inputs: message (required), phone_number (required), default_region. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a distinct action target: listing rows, previewing templates, sending via two clearly separated channels, appending rows, and recording DNC. Minor blur between list_outreach_contacts (outreach log) and save_outreach_contact (outreach_contacts.xlsx), which appear to touch the same data under different resource names.
All six names are snake_case verb_noun (list_, preview_, send_, save_, add_) with predictable patterns, including the parallel send_email/send_whatsapp pair.
Six tools cover the core read/send/save/suppress flow without bloat. The set is slightly thin — there is no status-update or lookup tool — but each tool clearly earns its place.
The surface handles listing, templating, sending on two channels, saving, and DNC, but the Status field in the saved row has no update tool, there is no way to remove or inspect DNC entries, and no contact lookup/search or reply tracking. These gaps will leave agents unable to close the loop after a send.
Maintenance
Related MCP Connectors
Run LinkedIn, email, WhatsApp and iMessage outreach from any MCP client.
Run multi-channel outreach: campaigns, contacts, conversations, and AI-drafted messages.
Unified inbox MCP for WhatsApp, Telegram, Email, voice — read/send messages, search, AI agents.
Hosted MCP server for MuntuAI outreach campaigns, leads, senders, domains, and analytics.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables sending WhatsApp messages through Claude Desktop and other MCP-compatible LLMs. Supports single and bulk messaging, phone number validation, and session management via the zapr.link service.MIT
- FlicenseNot gradedqualityDmaintenanceEnables automated lead generation, AI enrichment, personalized messaging, and outreach orchestration through MCP tools and n8n workflows.-
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients such as Claude, ChatGPT, and Cursor to read and search Instagram, WhatsApp, and LinkedIn conversations, find contacts, and spot prospects left without a reply. It can also prepare or send follow-ups, but only within permissions a human grants, and nothing goes out without human approval.CC BY-4.0
- AlicenseNot gradedqualityBmaintenanceThis MCP server lets coding agents research and score leads, draft cold emails, run every message through CAN-SPAM and deliverability gates, and hold them for human approval while logging why each lead was contacted. It enforces caps, warmup ramps, and a Tuesday/Wednesday send window, and by default never sends anything.10 npmMIT