NewsMAN MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.12.4Updated Nov 7, 2026

Read NewsMAN lists, subscribers, segments, newsletter and automation stats; manage subscribers.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableCommunication & CollaborationData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for NewsMAN email marketing: read lists, subscribers, segments, newsletter and automation stats, and manage subscribers.

What you can do
  • List and inspect email/SMS lists, their properties, subscriber counts and daily growth
  • Browse, search and page through subscribers, and read one subscriber's status, custom properties, segments and last 100 actions
  • List segments and their subscriber counts and members
  • List newsletters and read one newsletter's properties, delivery and engagement stats, and clicked links
  • List automation workflows and read their details and daily stats, plus background import status
  • Write operations: subscribe or unsubscribe an email, update name/email, add tags, add or remove a subscriber from a segment
When to use it
Useful when you want an assistant to answer questions about a NewsMAN account — list sizes, who is subscribed, how recent campaigns and automations performed — or to make small subscriber changes such as tagging, segmenting or unsubscribing without opening the NewsMAN dashboard.
Requirements
Remote MCP endpoint added by URL only; no API key or Authorization header in the client config. Sign-in is via OAuth, and on first connect you paste your NewsMAN Authorization token, which is validated and stored per user. A NewsMAN account is required; the free plan allows 50 tool calls per month.
Before you install
Six tools write to NewsMAN data: subscribing (active immediately, no confirmation email), unsubscribing, updating subscriber details, adding tags, and adding or removing segment membership. Only subscribe people who gave consent. The server also exposes billing tools that return Stripe Checkout links for paid plans and can cancel a subscription, so paid calls spend money. Your NewsMAN token is stored by the third-party host.

Installation

In SourceWeft

  1. Open NewsMAN MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fnewsman/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "newsman-by-usefulapi": {
      "type": "http",
      "url": "https://newsman.usefulapi.io/mcp"
    }
  }
}

README

NewsMAN MCP by usefulapi

Live endpoint: https://newsman.usefulapi.io/mcp

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://newsman.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http newsman https://newsman.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "newsman": {      "url": "https://newsman.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your NewsMAN credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/newsman/

On first connect you will paste your NewsMAN Authorization token. It is validated, stored per-user, and scoped to you. No keys in config files.

Tools

ToolTypeWhat it does
newsman_list_listsreadList subscriber lists
newsman_get_listreadGet list properties
newsman_count_list_subscribersreadCount list subscribers
newsman_list_subscribersreadList subscribers by status
newsman_get_list_growthreadGet list growth
newsman_search_subscribersreadSearch subscribers
newsman_get_subscriberreadGet subscriber by email
newsman_get_subscriber_by_idreadGet subscriber by id
newsman_get_subscriber_historyreadGet subscriber history
newsman_list_segmentsreadList segments
newsman_count_segment_subscribersreadCount segment subscribers
newsman_list_segment_subscribersreadList segment subscribers
newsman_list_newslettersreadList newsletters
newsman_get_newsletterreadGet newsletter
newsman_get_newsletter_statsreadGet newsletter stats
newsman_get_newsletter_clicked_linksreadGet newsletter clicked links
newsman_list_automationsreadList automations
newsman_get_automationreadGet automation
newsman_get_automation_statsreadGet automation stats
newsman_get_import_statusreadGet import status
newsman_subscribe_emailwriteSubscribe an email
newsman_unsubscribe_emailwriteUnsubscribe an email
newsman_update_subscriberwriteUpdate a subscriber
newsman_add_subscriber_tagswriteAdd tags to a subscriber
newsman_add_subscriber_to_segmentwriteAdd a subscriber to a segment
newsman_remove_subscriber_from_segmentwriteRemove a subscriber from a segment
newsman_usage_statusmetaUsage status (free-tier meter)
newsman_request_featuremetaRequest a missing feature
newsman_upgrademetaUpgrade to Pro or Pro+
newsman_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per account)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with newsman_upgrade (it returns a Stripe Checkout link). Cancel any time with newsman_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running newsman_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

Source: servers/newsman/README.md at commit 4046075

Tools

26

newsman_list_lists

List subscriber lists

All email lists (and SMS lists) this key can access, each with list_id, list_name and list_type. Start here: most other tools need a list_id. GET /v2/list/all.

Takes no parameters.

newsman_get_list

Get list properties

Properties of one list: sender name and email, owner contact details, site, link parameters, send rate. The list secret is never returned. GET /v2/list/getProps.

Parameterslist_idrequired

newsman_count_list_subscribers

Count list subscribers

The number of active (subscribed) subscribers of a list. GET /v2/list/count.

Parameterslist_idrequired

newsman_list_subscribers

List subscribers by status

Subscribers of a list with a given status (subscribed, unsubscribed, bounced, spam, inactivated), optionally only those who joined since a UTC date. Each item has subscriber_id, email and the date of that status. Paged (page from 0, up to 1000 per page). GET /v2/list/getSubscribers.

Parameterspagelimitsincestatusrequiredlist_idrequired

newsman_get_list_growth

Get list growth

Daily evolution of a list: total and eligible subscribers, unsubscribes, spam reports and hard bounces per day. Give `days` (last N days) OR start_date/stop_date; the period is at most 90 days. GET /v2/list/subscribersEvolution.

Parametersdayslist_idrequiredstop_datestart_date

newsman_search_subscribers

Search subscribers

Search the subscribers of a list by keywords (email or name) and status, optionally only those who joined since a UTC date. Paged (page from 0, up to 1000 per page). GET /v2/subscriber/search.

Parameterspagelimitsincestatuslist_idrequiredkeywordsrequired

newsman_get_subscriber

Get subscriber by email

One subscriber of a list by email address: status and dates, name, IP, custom properties and segments. GET /v2/subscriber/getByEmail.

Parametersemailrequiredlist_idrequired

newsman_get_subscriber_by_id

Get subscriber by id

One subscriber by subscriber_id: status and dates, name, IP, custom properties and segments. GET /v2/subscriber/get.

Parameterssubscriber_idrequired

newsman_get_subscriber_history

Get subscriber history

The last 100 actions of a subscriber: subscribe, unsubscribe, send, view, click, bounce, spam, each with a date and metadata (newsletter, link). GET /v2/subscriber/history.

Parameterssubscriber_idrequired

newsman_list_segments

List segments

The segments of a list with segment_id, segment_name, subscriber count and status (0 idle, 1 import running, 2 counting, 3 searching). NewsMAN allows 20 calls a minute for this method. GET /v2/segment/all.

Parameterslist_idrequired

newsman_count_segment_subscribers

Count segment subscribers

The number of active subscribers in a segment. GET /v2/segment/count.

Parameterssegment_idrequired

newsman_list_segment_subscribers

List segment subscribers

The subscribers of a segment (subscriber_id and email). Paged (page from 0, up to 1000 per page). GET /v2/segment/getSubscribers.

Parameterspagelimitsegment_idrequired

newsman_list_newsletters

List newsletters

Newsletters (campaigns) of a list with newsletter_id, subject, status, dates, segments and headline stats. Filter by status (-1 cancelled, 0 new, 1 confirmed, 2 sending, 3 paused, 4 resumed, 5 sent; or a comma list such as 1,5; default all), by creation date range, or the last N days. Paged. GET /v2/newsletter/all.

Parametersdayspagelimitstatuslist_idrequiredstop_datestart_date

newsman_get_newsletter

Get newsletter

Properties of one newsletter: subject, sender, status, dates, segments, links to the online view. Long HTML is clipped. GET /v2/newsletter/getProps.

Parametersnewsletter_idrequired

newsman_get_newsletter_stats

Get newsletter stats

Delivery and engagement stats of one newsletter: sent, views, clicks, unsubscribes, bounces, spam reports and rates. GET /v2/newsletter/stats.

Parametersnewsletter_idrequired

newsman_list_automations

List automations

Automation workflows of a list with workflow_id, name, type, status (0 inactive, 1 active), version and stats. Filter by name, status and last-updated range. GET /v2/automation/all.

Parametersnametypestatuslist_idrequiredstop_datestart_date

newsman_get_automation

Get automation

One automation workflow: name, type, status, version, recurrence, stats and preview links. GET /v2/automation/getWorkflow.

Parametersworkflow_idrequired

newsman_get_automation_stats

Get automation stats

Daily stats of the automations of a list: sends, opens, clicks, purchases, bounces, unsubscribes. Optionally for given workflows and a period (last N days, or start_date/stop_date; at most 90 days). GET /v2/automation/stats.

Parametersdayslist_idrequiredstop_datestart_dateworkflow_ids

newsman_get_import_status

Get import status

Status of a background subscriber import by import_id: new, running, finished or error, with times and the last error. GET /v2/import/status.

Parametersimport_idrequired

newsman_subscribe_email

Subscribe an email

WRITE: subscribe an email address to a list (or update it if it exists), with optional name and custom properties. A property key with the tag_ prefix sets a tag. Only use for people who gave consent. The subscriber is active at once, with no confirmation email. Returns the subscriber_id. POST /v2/subscriber/saveSubscribe.

Parametersipemailrequiredpropslist_idrequiredlastnamefirstname

newsman_unsubscribe_email

Unsubscribe an email

WRITE: unsubscribe an email address from a list, so it no longer receives campaigns from that list. Returns the subscriber_id. POST /v2/subscriber/saveUnsubscribe.

Parametersipemailrequiredlist_idrequired

newsman_update_subscriber

Update a subscriber

WRITE: change the email, first name or last name of a subscriber. Give only the fields to change; the others are left as they are. POST /v2/subscriber/update.

Parametersemaillastnamefirstnamesubscriber_idrequired

newsman_add_subscriber_tags

Add tags to a subscriber

WRITE: add tags to a subscriber (existing tags stay). POST /v2/subscriber/addTags.

Parameterstagsrequiredsubscriber_idrequired

newsman_add_subscriber_to_segment

Add a subscriber to a segment

WRITE: add a subscriber to a (static) segment. POST /v2/subscriber/addToSegment.

Parameterssegment_idrequiredsubscriber_idrequired

newsman_remove_subscriber_from_segment

Remove a subscriber from a segment

WRITE: remove a subscriber from a segment (the subscriber stays on the list). POST /v2/subscriber/removeFromSegment.

Parameterssegment_idrequiredsubscriber_idrequired

Version history

12
  1. v1.12.4LatestNov 7, 2026
  2. v1.11.3Nov 5, 2026
  3. v1.11.2Nov 5, 2026
  4. v1.11.1Nov 4, 2026
  5. v1.11.0Nov 3, 2026
  6. v1.10.1Nov 3, 2026
  7. v1.9.0Nov 1, 2026
  8. v1.7.0Oct 31, 2026
  9. v1.6.0Oct 31, 2026
  10. v1.5.2Oct 30, 2026
  11. v1.5.0Oct 30, 2026
  12. v1.0.0Oct 26, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026