# Brevo — how to use (mcp.ai)

Connect your Brevo account and use 21 tools for email newsletters straight from your AI agent. Connect with your own API key. Brevo (formerly Sendinblue) is an all-in-one email and SMS marketing platform that provides transactional messaging, marketing automation, contact management, and CRM tools to help businesses communicate and engage with their customers.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_brevo?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `brevo_create_a_company`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/brevo`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/brevo/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/brevo/create/a/company` — Creates a new company record in your Brevo CRM. Companies can be used to organize contacts and deals, track business relationships, and manage customer accounts. You can add custom attributes, link ex
  - body: { name: string, attributes?: object, countryCode?: integer, linkedDealsIds?: string[], linkedContactsIds?: integer[] }
- `POST https://api.mcp.ai/api/brevo/create/contact/list` — Creates a new contact list (audience) in Brevo within a specified folder. Contact lists are used to organize and segment contacts for email campaigns, SMS campaigns, and marketing automation workflows
  - body: { name: string, folderId: integer }
- `POST https://api.mcp.ai/api/brevo/create/or/update/email/template` — This tool creates a new email template or updates an existing one in Brevo. If a 'templateId' is provided, it performs an update; otherwise, it creates a new template.
  - body: { tag?: string, sender?: object, htmlUrl?: string, replyTo?: string, subject?: string, toField?: string, isActive?: boolean, templateId?: integer, htmlContent?: string, templateName?: string, attachmentUrl?: string }
- `POST https://api.mcp.ai/api/brevo/create/sms/campaign` — This tool allows you to create a new SMS campaign in Brevo. You can specify the campaign name, sender, content, recipients (by providing list IDs, exclusion list IDs, or segment IDs), and optionally s
  - body: { name: string, sender: string, content: string, recipients?: object, scheduledAt?: string, unicodeEnabled?: boolean, organisationPrefix?: string, unsubscribeInstruction?: string }
- `POST https://api.mcp.ai/api/brevo/delete/company` — Deletes a company from Brevo using its unique identifier.
  - body: { id: string }
- `POST https://api.mcp.ai/api/brevo/delete/contact` — Deletes a contact from Brevo by email, contact ID, external ID, phone number, WhatsApp ID, or landline number. Use the identifier_type parameter to specify the type of identifier when using ext_id, ph
  - body: { identifier: string, identifier_type?: string }
- `POST https://api.mcp.ai/api/brevo/delete/email/template` — This tool deletes an inactive email template from Brevo. You need to provide the 'templateId' of the email template you want to delete. Only inactive templates can be deleted.
  - body: { template_id: integer }
- `POST https://api.mcp.ai/api/brevo/delete/sms/campaign` — This tool deletes an existing SMS campaign.
  - body: { campaign_id: integer }
- `POST https://api.mcp.ai/api/brevo/get/account/info` — Retrieves comprehensive information about the authenticated Brevo account. Returns account details including: - Account holder information (email, first name, last name, company name) - Complete addre
- `POST https://api.mcp.ai/api/brevo/get/all/contacts` — This tool retrieves all contacts from your Brevo account with pagination and filtering based on modification/creation dates, list IDs, segment IDs, and contact attributes. For complete retrieval, iter
  - body: { sort?: string, limit?: integer, offset?: integer, listIds?: integer[], segmentId?: integer, createdSince?: string, modifiedSince?: string }
- `POST https://api.mcp.ai/api/brevo/get/all/email/templates` — This tool retrieves a list of all email templates created in your Brevo account. It corresponds to the GET /v3/smtp/templates endpoint as per the Brevo API documentation, with optional parameters for 
  - body: { sort?: string, limit?: integer, offset?: integer, templateStatus?: boolean }
- `POST https://api.mcp.ai/api/brevo/get/all/senders` — This tool retrieves a list of all senders associated with the Brevo account. Senders are the email addresses or domains that are authorized to send emails through Brevo. This action can be useful for 
  - body: { ip?: string, domain?: string }
- `POST https://api.mcp.ai/api/brevo/get/company/details` — Retrieves detailed information about a specific company from Brevo's CRM. Returns company data including its unique identifier, custom attributes, and lists of linked contact IDs and deal IDs. This is
  - body: { id: string }
- `POST https://api.mcp.ai/api/brevo/get/contact/details` — This tool retrieves detailed information about a specific contact in Brevo. You can identify the contact using their email address (URL-encoded), their unique contact ID, or their SMS attribute value.
  - body: { identifier?: string, mobile_number?: string }
- `POST https://api.mcp.ai/api/brevo/get/contact/lists` — Retrieves all contact lists from your Brevo account with pagination support. Returns list IDs, names, subscriber counts, and folder associations. Use this to discover available lists or obtain list ID
  - body: { sort?: string, limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/brevo/get/email/campaign/details` — Tool to retrieve full configuration and content for a specific email campaign. Use when you need complete campaign details including HTML content, recipients, statistics, and all configuration setting
  - body: { statistics?: string, campaign_id: integer }
- `POST https://api.mcp.ai/api/brevo/get/sms/campaign/details` — Retrieves the details of a specific SMS campaign. This action fetches complete information about an SMS campaign including its status, content, sender, scheduling, recipients, and statistics.
  - body: { campaign_id: integer }
- `POST https://api.mcp.ai/api/brevo/get/sms/campaigns` — Retrieves all SMS campaigns from your Brevo account with optional filtering and pagination. Use this tool to: - List all SMS campaigns with their details (name, status, content, sender, dates) - Filte
  - body: { sort?: string, limit?: integer, offset?: integer, status?: string, endDate?: string, startDate?: string }
- `POST https://api.mcp.ai/api/brevo/list/all/companies` — This action retrieves a list of all companies stored in the Brevo CRM. It supports pagination and filtering by name and other attributes.
  - body: { page?: integer, sort?: string, limit?: integer, sortBy?: string, filters?: string, linkedDealsIds?: string[], linkedContactsIds?: integer[] }
- `POST https://api.mcp.ai/api/brevo/list/email/campaigns` — This tool retrieves a list of all email campaigns associated with the user's Brevo account. It allows filtering by campaign type, status, start date, and end date. The response includes the total coun
  - body: { sort?: string, type?: string, limit?: integer, offset?: integer, status?: string, endDate?: string, startDate?: string, statistics?: string, excludeHtmlContent?: boolean }
- `POST https://api.mcp.ai/api/brevo/update/email/campaign` — Updates an email campaign in Brevo using its unique identifier.
  - body: { tag?: string, name?: string, footer?: string, header?: string, params?: object, sender?: object, htmlUrl?: string, replyTo?: string, subject?: string, toField?: string, subjectA?: string, subjectB?: string, abTesting?: boolean, recurring?: boolean, splitRule?: integer, recipients?: object, campaign_id: integer, htmlContent?: string, previewText?: string, scheduledAt?: string, utmCampaign?: string, winnerDelay?: integer, increaseRate?: integer, initialQuota?: integer, mirrorActive?: boolean, updateFormId?: string, attachmentUrl?: string, ipWarmupEnable?: boolean, sendAtBestTime?: boolean, winnerCriteria?: string, unsubscriptionPageId?: string, inlineImageActivation?: boolean }

## Example prompts
- "What can I do in Brevo?"
- "Show me a summary of my Brevo account"

## More
- Page: https://mcp.ai/brevo
- Agent spec (llms.txt): https://mcp.ai/brevo/llms.txt
- Postman collection: https://mcp.ai/brevo/postman.json