list-contactsLABSCO SUMMARY
Campaigns drafted, never sent by accident.
Campaigns are created as drafts, so an assistant can assemble the broadcast, the sequence or the flow and leave the decision to send with a person.
What it is
A Mailtani client that exposes a marketing account as tools: contacts and lists, segments built from conditions, campaigns as broadcasts, sequences and flows, transactional sends, tags, custom fields and event tracking.
What you get
- Contacts listed, created or upserted, updated and deleted
- Lists created and listed, with contacts added to and removed from them
- Segments built from conditions, and the contacts currently matching one
- Campaigns created as drafts — broadcast, sequence or flow — and listed back
- Sent emails listed, and a one-off transactional email sent
- Tags and custom fields created, listed and deleted
- A custom event tracked against a contact, which is what triggers a flow
Requirements
A Mailtani API key and your project id, sent as two headers on every call. The server is hosted at mailtani.com — nothing to install, and clients connect over HTTP.
Setup effort
One command plus a key — claude mcp add --transport http mailtani https://mailtani.com/mcp --header "Authorization: Bearer mk_YOUR_API_KEY" --header "X-Project-Id: YOUR_PROJECT_ID"
USE CASES
Getting a new signup into the right list
Create or upsert the contact, then put them on the list that drives the welcome flow.
Building the audience for a send
Create the list, work through the contacts, and add the ones that belong on it.
Cleaning up a list before a campaign
Correct the records that are wrong and take off the ones that should not receive it.
Honouring a deletion request
Remove the contact outright rather than only unsubscribing them.
Finding out what a project already has
The lists that exist and who is on them, before creating another one by mistake.
23 tools
Listed in project docs. Your client may show a different list.
create-contactupdate-contactdelete-contactlist-listscreate-listadd-contact-to-listremove-contact-from-listlist-segmentscreate-segmentget-segment-contactslist-campaignscreate-broadcastcreate-sequencecreate-flowlist-emailssend-emaillist-tagscreate-tagdelete-taglist-custom-fieldscreate-custom-fieldtrack-eventBEFORE YOU INSTALL
What to know first
Tools you get
23 tools named in the project's documentation.
Requires
- A client that can reach a remote MCP server over HTTP
- A Mailtani API key (Settings → API Keys), sent as Authorization: Bearer mk_…
- Your project ID (Settings → API), sent as the X-Project-Id header
INSTALLATION
Connect your client
Server setup
claude mcp add
Claude Code
claude mcp add --transport http mailtani https://mailtani.com/mcp \
--header "Authorization: Bearer <YOUR_API_KEY>" \
--header "X-Project-Id: <YOUR_PROJECT_ID>"Hosted endpoint
https://mailtani.com/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Cursor
{
"mcpServers": {
"mailtani": {
"type": "http",
"url": "https://mailtani.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>",
"X-Project-Id": "<YOUR_PROJECT_ID>"
}
}
}
}