Skip to main content
Glama
Meser10 MCP Server

Meser10 MCP Server

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/

MCP Registry

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=meser10

Two 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-server

MESER10_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.

MESER10_MODE

Adds

Tools

read (default)

the Get* family

16

write

contacts, groups, campaign drafts

+27

send

delivers to real recipients, spends credit

+13

destructive

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. oLogin and iUserID are stripped from every tool schema and filled in by the server. A model cannot see, guess, or leak them. CLoginInfo does accept UserName/Password, and this server deliberately never populates them - ApiKey only.

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 stdio

The 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 tools
get_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_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

    C2.5/5.0

    Scored across 14 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables agents to create and manage durable email workflows, templates, contacts, and enrollments over MCP.
      2
      AGPL 3.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables sending transactional email and campaigns, managing contacts and templates, and reading delivery reports and wallet usage from any MCP client.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      3
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      5
      352 npm
      MIT