Meser10 MCP Server
This MCP server lets you query Meser10 email/SMS platform data read-only by default, with optional opt-in modes for writing, sending, and deleting.
List mailing lists/groups and campaigns.
Get campaign summaries, per-recipient details, link-click stats, and results by date range.
Query transactional message results by date range or message IDs.
Check coupon status.
Retrieve unsubscribed and bounced addresses for suppression lists.
Optional modes add writing contacts/groups/drafts, sending to real recipients (with a recipient cap), and permanent deletes.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Meser10 MCP Server list my contact groups in Meser10"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Meser10 MCP Server
Connect the Meser10 email & SMS platform to any MCP client (Claude, Cursor, or your own agent).
תיעוד בעברית, כולל התקנה מודרכת: https://www.meser10.co.il/features/mcp-server/
Listed in the official MCP Registry since 19 September 2026 as io.github.meser10/meser10-mcp
(v1.0.2, MIT). Verify independently, no account needed:
https://registry.modelcontextprotocol.io/v0/servers?search=meser10Two Israeli email/SMS marketing platforms appear in the official registry. This is the only one of the two published as open source and installable as a package; the other is a remote endpoint with no repository and no package.
Tools are generated from the live WSDL. Nobody hand-writes 61 tool definitions here, which means the server covers every API capability by construction and does not drift when the platform ships a new operation.
Quick start
export MESER10_API_KEY=... # issued in the Meser10 UI
export MESER10_USER_ID=... # your account number - optional, see below
npx @meser10/mcp-serverMESER10_USER_ID is optional at start-up. 17 of the 61 operations are authenticated by the key
alone; the other 44 carry an explicit account number, and those fail with a clear message if it is
not set. Set it unless you know you only need the first group. The account number is an identifier,
not a secret - it is visible in the Meser10 UI.
Claude Desktop / Claude Code:
{
"mcpServers": {
"meser10": {
"command": "npx",
"args": ["-y", "@meser10/mcp-server"],
"env": { "MESER10_API_KEY": "...", "MESER10_USER_ID": "..." }
}
}
}Related MCP server: maacgo-email
Safety model
The server starts read-only. Nothing that spends money, messages a real person, or deletes a record is reachable until you opt in.
| Adds | Tools |
| the | 16 |
| contacts, groups, campaign drafts | +27 |
| delivers to real recipients, spends credit | +13 |
| permanent deletes | +5 |
Two more guards:
MESER10_MAX_RECIPIENTS(default 100) refuses any single send that targets more addresses than the cap. A model that misreads a prompt cannot mail your whole list.Credentials are injected, never exposed.
oLoginandiUserIDare stripped from every tool schema and filled in by the server. A model cannot see, guess, or leak them.CLoginInfodoes acceptUserName/Password, and this server deliberately never populates them -ApiKeyonly.
The one thing to know about errors
Every operation returns HTTP 200, including failures. Success lives in the Result field of
CCallResult, not in the status code. This server reads Result, throws on anything that is not
Success or PartialSuccess, and attaches a remedy:
LoginFailed: bad key - MESER10_API_KEY was rejected. Reissue the key in the Meser10 UI and restart.PartialSuccess is surfaced as a warning rather than silent success, because it means some records
in a batch did not land.
Design notes
Legacy variants are hidden. The contract exposes five Ex/Ex2 families (15 operations for 5
capabilities). Offering all of them makes a model choose between near-identical tools and pick
wrong. The richest variant is exposed; the rest are hidden behind MESER10_EXPOSE_LEGACY=true.
Names are written for callers. GetGroupsList is what the platform calls it. list_groups is
what a developer reaches for. The underlying operation name is always in the description, so
nothing is hidden.
Hungarian prefixes become type hints. saGroups is an array of strings, eLang is an enum,
iUserID is an int. The generator uses that to produce better schemas and human titles.
Troubleshooting
LoginFailed on a key that worked five minutes ago. The platform blocks the calling IP
after a few failed authentications, and the block is long - measured at over three and three
quarter hours. It reports itself as Incorrect user name or password, which is indistinguishable
from a wrong key, so the instinct to reissue the key and retry makes it worse: the new key is
blocked too, because the block is not on the key.
If this happens: stop calling, wait, and do not put a retry loop around authentication. Never retry an auth failure automatically - retrying is what creates the block, and on a shared server it takes down every other integration sending from the same address.
NotEnoughPermissions. Either the key belongs to a different account than the
MESER10_USER_ID you set, or that account is real but out of your key's reach. An account number
the platform cannot resolve at all fails differently, as ApplicationError, so this message does
mean the number exists.
A tool returns a status and no data. Fixed in 1.0.0. Upgrade.
PartialSuccess. Part of a batch did not land. The server surfaces it as a warning rather
than silent success; check which records are missing before you retry the whole batch.
Support
support@meser10.co.il · 03-7440020 · Sunday to Thursday, 9:00-17:00 Israel time.
Include the operation name and the Result value you got back. Never include your API key, and
if one has been shared anywhere, reissue it.
Development
npm install && npm run build
npm test # 43 unit tests + 12 end-to-end tests over real MCP stdioThe e2e suite runs a local stand-in for the platform, so it needs no credentials and sends nothing.
Status
Verified against the production endpoint on 2026-09-12, in read mode: authentication with ApiKey
only, tool listing, and four operations returning live data through the whole chain.
Also verified locally: WSDL parsing, schema generation, safety gate, envelope construction, credential injection, error mapping, recipient cap, and the MCP protocol over stdio.
Write, send and delete operations are implemented and covered by tests against a stand-in, and have deliberately never been executed against a live account by this project.
Available Tools
14 toolsget_campaignC
Calls GetCampaign on the Meser10 platform. Read-only. SOAP operation: GetCampaign.
Inputs: iCampaignID (required).
get_campaign_detailsC
Per-recipient outcome for one campaign. Read-only. SOAP operation: GetCampaignResultDetails.
Inputs: iCampaignID (required), eMessageStatus (required).
get_campaign_link_clicksD
Calls GetCampaignLinkClicks on the Meser10 platform. Read-only. SOAP operation: GetCampaignLinkClicks.
Inputs: iCampaignID (required).
get_campaign_link_clicks_by_dateD
Calls GetCampaignLinkClicksBetweenDates on the Meser10 platform. Read-only. SOAP operation: GetCampaignLinkClicksBetweenDates.
Inputs: iCampaignID (required), dToDateAndTime, dFromDateAndTime.
get_campaign_results_by_dateD
Calls GetCampaignResultsBetweenDates on the Meser10 platform. Read-only. SOAP operation: GetCampaignResultsBetweenDates.
Inputs: iCampaignID (required), eMessageStatus (required), dToDateAndTime, dFromDateAndTime.
get_campaign_summaryB
Totals for one campaign: sent, opened, clicked, bounced. Read-only. SOAP operation: GetCampaignResultSummary.
Inputs: iCampaignID (required).
get_coupon_statusD
Calls GetCouponStatus on the Meser10 platform. Read-only. SOAP operation: GetCouponStatus.
Inputs: sCouponCode.
get_groupsC
Calls GetGroups on the Meser10 platform. Read-only. SOAP operation: GetGroups.
Inputs: no named parameters.
get_transactional_results_by_dateD
Calls GetSingleMessagesResultsBetweenDatesEx on the Meser10 platform. Read-only. SOAP operation: GetSingleMessagesResultsBetweenDatesEx.
Inputs: eMessageStatus (required), dToDateAndTime, dFromDateAndTime.
get_transactional_results_by_idC
Calls GetSingleMessagesResultsByIds on the Meser10 platform. Read-only. SOAP operation: GetSingleMessagesResultsByIds.
Inputs: iaMessageIDs.
list_bounced_addressesB
Addresses that hard-bounced. Feed these back into your own suppression list. Read-only. SOAP operation: GetBouncedAddresses.
Inputs: dToDateAndTime (required), dFromDateAndTime (required).
list_campaignsC
Calls GetCampaignsBasicInfo on the Meser10 platform. Read-only. SOAP operation: GetCampaignsBasicInfo.
Inputs: no named parameters.
list_groupsA
List the mailing lists on the account, with their ids. Start here - most other calls take a group. Read-only. SOAP operation: GetGroupsList.
Inputs: no named parameters.
list_unsubscribed_addressesB
Addresses that asked to be removed. Never re-add these. Read-only. SOAP operation: GetRemovedEMailAddresses.
Inputs: dToDateAndTime (required), dFromDateAndTime (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools have distinct scopes by campaign, date range, link clicks, transactional results, or suppression lists. However list_groups and get_groups appear to overlap heavily, both returning groups/lists, which creates a real selection ambiguity. The many campaign-result variants are mostly differentiated by descriptions.
Names are consistently snake_case and use recognizable get_/list_ verb prefixes for read-only operations. The main inconsistency is list_groups versus get_groups, where one resource is named with two different verb conventions.
14 tools is a reasonable size for a reporting-focused email marketing integration. The count is slightly inflated by near-duplicates like list_groups/get_groups and several campaign-result variants that could potentially be consolidated.
The surface covers campaign reporting, transactional results, link clicks, groups, coupon status, and suppression lists. But it is entirely read-only, so sending, creating, updating, and suppression-list management are absent if the server is meant as a full platform integration.
Maintenance
Related MCP Connectors
Read lists, contacts, campaign stats; add contacts; draft, schedule and send campaigns and SMS.
Send transactional email and manage domains, audiences, and broadcasts from any MCP client.
Marketing MCP: social, email, SMS, CRM, paid ads, analytics. OAuth; confirm before send/spend.
Read Mailnaptic campaigns, lists, contacts and results and draft campaigns. Sending needs your OK.
Related MCP Servers
AlicenseNot gradedqualityBmaintenanceEnables agents to create and manage durable email workflows, templates, contacts, and enrollments over MCP.2AGPL 3.0- AlicenseNot gradedqualityCmaintenanceEnables sending transactional email and campaigns, managing contacts and templates, and reading delivery reports and wallet usage from any MCP client.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to connect and warm up sending mailboxes, build and launch outbound campaigns, manage leads and replies, and handle suppressions, analytics, and webhooks through policy-gated MCP tools.3Apache 2.0
- AlicenseAqualityBmaintenanceEnables MCP clients to send individual and batch emails through a public API, including attachments and inline images read from local files, URLs, or base64 content. Also supports retrieving and listing emails and sending events.5352 npmMIT