# Brevo MCP MCP

> Brevo MCP connects your AI agent directly to Brevo's powerful communication and CRM tools. Send transactional emails or SMS messages instantly; build new contacts, update attributes, and manage entire campaign lists—all without logging into a separate marketing console.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** transactional-email, sms-marketing, contact-management, smtp-routing, marketing-campaigns, customer-communication

## Description

You can use this connection to run critical communications workflows right from your chat window. Need to send an immediate password reset email? Done. Need to text a client about ticket resolution? It's handled. You can also treat the system like a mini-CRM, letting your agent automatically create new user profiles or update contact details with specific metadata attributes. This means you don't have to jump between tools just to execute basic marketing operations or keep an audience list current. When you use Vinkius, this MCP lets your AI client handle these complex communications pipelines through natural conversation.

## Tools

### create_contact_list
Establishes a new empty list folder within the Brevo CRM for organizing campaigns.

### create_crm_contact
Builds and adds a completely new contact record into the Brevo CRM database.

### delete_crm_contact
Permanently removes a specific contact profile from the CRM, ensuring compliance.

### get_contact_attributes
Retrieves detailed metadata and specific attributes for a given contact's email address.

### get_smtp_account_details
Checks the current status, quota usage, and plan details of your Brevo sending account.

### list_contact_folders
Retrieves a full list of all existing contact groups and campaign segments in the CRM.

### list_crm_contacts
Pulls a comprehensive list of every contact stored within your Brevo CRM.

### send_transactional_email
Dispatches an immediate, richly formatted email payload via the Brevo SMTP API.

### send_transactional_sms
Sends an automated, transactional SMS message directly to a cellular phone number.

### update_contact_attributes
Modifies existing custom fields or metadata parameters for a specific CRM contact.

## Prompt Examples

**Prompt:** 
```
Send a transactional email to test@domain.com saying hello.
```

**Response:** 
```
I've sent the transactional email! The robust Brevo SMTP infrastructure accepted the HTML payload safely. You can track open metrics internally.
```

**Prompt:** 
```
Create contact john.doe@mail.com and map their name as John.
```

**Response:** 
```
John's contact record was securely configured inside your CRM architecture! I passed the FIRSTNAME attribute properly over JSON and assigned them neutrally to the general list.
```

**Prompt:** 
```
Can you text message 'Server requires reboot' to my admin phone?
```

**Response:** 
```
The SMS alert has been handed off to the Brevo gateway. It normally delivers under ~200ms depending on explicit telco routes. Logs reflect an affirmative dispatch signal.
```

## Capabilities

### Send transactional emails
The agent sends rich HTML messages instantly for alerts like password resets or status updates.

### Dispatch SMS messages
You can send automated, time-sensitive text notifications to verified phone numbers globally.

### Manage contact records
The agent creates new user profiles in the CRM and updates specific attributes for existing contacts.

### Audit audience lists
You can list all available campaign segments or retrieve metadata on any given contact's profile.

## Use Cases

### The support team needs immediate follow-up on a ticket.
A customer's issue is solved, but they need confirmation. The agent sends an SMS alert using `send_transactional_sms` to the client’s phone number immediately, confirming resolution and closing the loop without opening any external apps.

### The SDR qualifies a lead during a call.
Instead of making notes in a spreadsheet, the agent calls `create_crm_contact` to build the new record and uses `update_contact_attributes` to map the source (e.g., 'Webinar Attendee') right into the contact's profile.

### The IT department needs a critical alert broadcast.
A server goes down. The administrator prompts the agent, which then executes `send_transactional_email` to all relevant internal staff addresses with service-down details.

## Benefits

- Stop logging into heavy marketing consoles. You can send anything—from a password reset email to an SMS alert—just by talking to your agent.
- Automatically update customer records. After a support interaction, the system lets you call `update_contact_attributes` to add notes or change lead status instantly.
- Streamline data gathering. Instead of manual searches, use `get_contact_attributes` to pull specific metadata about a user before making an offer.
- Build and organize your audience structure. You can use `create_contact_list` to segment new leads right after they sign up for a service.
- Test complex workflows. Developers bypass Postman by directly triggering functional API payloads using the MCP, ensuring reliable delivery.
- Check account health quickly. Use `get_smtp_account_details` anytime to verify your current sending quota and plan status.

## How It Works

The bottom line is, you keep working in your chat environment instead of jumping through multiple web interfaces.

1. Activate this MCP integration and provide your Brevo API Key.
2. Instruct your AI client to perform a task, for example: 'Send an alert email to X address.'
3. The system executes the communication payload using Brevo's backend infrastructure.

## Frequently Asked Questions

**How do I send an email with the Brevo MCP?**
Just tell the agent to use `send_transactional_email`. You provide the recipient and the content; the MCP handles formatting and sending via the SMTP API.

**What if I need to update a contact's details using the Brevo MCP?**
Use `update_contact_attributes`. You specify the contact ID, the field name, and the new value you want to write over the old data.

**Can I check my sending quota with get_smtp_account_details?**
Yes. Running `get_smtp_account_details` pulls your current plan status and how much of your daily sending capacity you've used so far.

**What is the difference between list_crm_contacts and list_contact_folders?**
Use `list_crm_contacts` to pull a raw list of every single person in your database. Use `list_contact_folders` if you want to see what structured campaign segments or audience groupings you have set up.

**How do I use `get_contact_attributes` to retrieve specific metadata about a user?**
It pulls detailed profile data for an email. You can grab niche attributes, like last purchase dates or custom tags, that aren't visible in a simple contact list view.

**What is the purpose of using `create_contact_list`?**
This tool creates empty audience folders inside Brevo. You should run this first to organize your campaign segments before you start adding leads or contacts to them.

**When do I need to use the `delete_crm_contact` tool?**
Use this when a contact profile needs permanent removal for compliance reasons. The action is irreversible, so always confirm the details before running the deletion command.

**How quickly does `send_transactional_sms` deliver notifications?**
Delivery speed depends on carrier routes but generally happens within minutes. It sends alerts directly to cellular hardware via the Brevo gateway, bypassing standard web clients entirely.