MailerSend handles transactional email for many product companies — verification emails, password resets, order receipts. Connecting MailerSend to clariBI surfaces every send, bounce, complaint, and template usage stat into your AI analyses.
Why connect MailerSend
Deliverability questions ("did our bounce rate spike after the latest infra change?") usually require dashboard hopping or SQL against an exported log table.
With MailerSend connected, you can ask "What is our 7-day bounce rate by sending domain?", "How many transactional emails went to spam last week?", or "Which templates are sending the most messages?" and the AI engine routes through the hosted MCP.
How the connection works
clariBI talks to MailerSend through its hosted MCP server at https://mcp.mailersend.com/mcp. Authentication uses an OAuth flow that clariBI registers itself for (no developer console setup on your side). Tokens stay encrypted server-side and never leave clariBI in clear form.
sequenceDiagram
actor U as You
participant C as clariBI
participant V as MailerSend
U->>C: Click Authorize with MailerSend
C->>V: Open OAuth authorization
V-->>U: Grant read access?
U->>V: Approve
V-->>C: Authorization code
C->>V: Exchange code for tokens
V-->>C: Access + refresh tokens
C->>C: Encrypt and store credentials
C-->>U: Connection ready
Available tools
clariBI exposes the read-only MailerSend tools that the vendor's MCP server publishes at connection time. Write operations (create, update, delete, send, refund) are filtered out by a name-pattern blocklist before any tool reaches the analysis engine, so connecting MailerSend cannot modify data on the vendor side.
The exact tool inventory depends on the MailerSend features your account has access to. After connecting, try a few natural-language questions to see what MailerSend data clariBI can pull.
Data flow during analysis
When you ask a question that maps to MailerSend, the AI engine routes to the right tool, reads the result, and pairs the answer with a chart you can pin to a dashboard.
sequenceDiagram
actor U as You
participant C as clariBI
participant AI as AI engine
participant V as MailerSend
U->>C: Ask a question about transactional email + deliverability data
C->>AI: Plan the analysis
AI->>V: Call the right tool
V-->>AI: Tool result
AI->>AI: Summarize and chart
C-->>U: Answer plus visual
Setting up the connection
- Open Data Sources in the clariBI sidebar.
- Click Add data source.
- Open the MCP Servers tab.
- Click the MailerSend card.
- Click Authorize with MailerSend.
- Sign in to MailerSend in the popup window and grant the requested read scopes.
- Back in clariBI, give your data source a name.
- Click Finish.
Permissions and data access
OAuth scoping is granted at authorize time. clariBI restricts itself to read-only tools (no sending, no template mutation, no domain changes). Disconnect from MailerSend settings or from clariBI Settings.
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
| "Authorization expired" | OAuth tokens rotate and the refresh failed silently. | Reconnect MailerSend from Settings → Integrations. |