Brevo FastMCP

A FastMCP server for integrating with the Brevo API. It allows GitHub Copilot to manage Brevo contacts and import/export leads using TSV files.

---

Features

• List Brevo contacts
• Create or update Brevo contacts
• Export Brevo contacts to TSV
• Import TSV contacts into Brevo
• Pydantic models
• Logging
• FastMCP Integration
• GitHub Copilot MCP

---

Project Structure

brevo-fastmcp-v2/
│
├── server.py
├── requirements.txt
├── README.md
├── .env
│
└── src/
    ├── __init__.py
    ├── brevo.py
    ├── config.py
    ├── models.py
    ├── tools.py
    ├── tsv.py
    └── utils.py

---

Requirements

• Python 3.12+
• Git
• VS Code
• GitHub Copilot
• Brevo Account
• Brevo API Key

---

Installation

Clone Repository

git clone <repository-url>

Go to the project directory

cd brevo-fastmcp-v2

---

Create Virtual Environment

Windows

python -m venv .venv

Activate

Command Prompt

.venv\Scripts\activate

PowerShell

.\.venv\Scripts\Activate.ps1

---

Install Dependencies

pip install -r requirements.txt

or

pip install fastmcp requests python-dotenv pydantic

---

Verify Installation

python --version

pip --version

fastmcp version

---

Environment Variables

Create a file named

.env

Add

BREVO_API_KEY=your_brevo_api_key

---

Verify API Key

python -c "import os,requests; from dotenv import load_dotenv; load_dotenv(); r=requests.get('https://api.brevo.com/v3/account', headers={'api-key': os.getenv('BREVO_API_KEY'),'accept':'application/json'}); print(r.status_code); print(r.text)"

Expected

200

---

Run MCP Server

python server.py

Expected Output

FastMCP 3.x.x

Starting MCP server 'Brevo FastMCP'

Discovered 4 tools

---

Available MCP Tools

Tool	Description
list_contacts	List Brevo contacts
add_contact	Create or update a contact
export_brevo_to_tsv	Export Brevo contacts to TSV
import_tsv_to_brevo	Import TSV contacts into Brevo

---

Example Prompts

List Contacts

List my Brevo contacts

---

Add Contact

Create a contact

Email: john@example.com
First Name: John
Last Name: Doe

---

Export Contacts

Export all Brevo contacts to contacts.tsv

---

Import Contacts

Import contacts from contacts.tsv

---

Troubleshooting

Unauthorized (401)

If you receive

401 Unauthorized

Run

python -c "import os,requests; from dotenv import load_dotenv; load_dotenv(); r=requests.get('https://api.brevo.com/v3/account', headers={'api-key': os.getenv('BREVO_API_KEY'),'accept':'application/json'}); print(r.status_code); print(r.text)"

If the response says

Unrecognised IP Address

Go to

Brevo
→ Settings
→ Security
→ Authorized IPs

Add your current public IP address.

Restart the MCP server.

---

Useful Commands

Activate Virtual Environment

.venv\Scripts\activate

Deactivate

deactivate

Upgrade pip

python -m pip install --upgrade pip

Upgrade FastMCP

pip install --upgrade fastmcp

List Installed Packages

pip list

Check FastMCP Version

fastmcp version

Run Server

python server.py

---

Tech Stack

• Python 3.12
• FastMCP
• Brevo REST API
• Pydantic
• Requests
• Python Dotenv
• GitHub Copilot MCP
• TSV (Tab Separated Values)

---

Author

Harish Nethi#� �b�r�e�v�o�-�m�c�p� � �#� �b�r�e�v�o�-�m�c�p� � �