MCP server

NewsMAN MCP by usefulapi

io.usefulapi/newsman

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

26

Token cost

About 5,511 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http newsman https://newsman.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.newsman]
url = "https://newsman.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"newsman":{"httpUrl":"https://newsman.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"newsman":{"url":"https://newsman.usefulapi.io/mcp"}}}

VS Code

{"servers":{"newsman":{"type":"http","url":"https://newsman.usefulapi.io/mcp"}}}

Antigravity

agy mcp add newsman https://newsman.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"newsman","server_url":"https://newsman.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"newsman","server_url":"https://newsman.usefulapi.io/mcp"}

Tools

• newsman_add_subscriber_tags ~168 tokens
  WRITE: add tags to a subscriber (existing tags stay). POST /v2/subscriber/addTags.
• newsman_add_subscriber_to_segment ~180 tokens
  WRITE: add a subscriber to a (static) segment. POST /v2/subscriber/addToSegment.
• newsman_count_list_subscribers ~121 tokens
  The number of active (subscribed) subscribers of a list. GET /v2/list/count.
• newsman_count_segment_subscribers ~131 tokens
  The number of active subscribers in a segment. GET /v2/segment/count.
• newsman_get_automation ~145 tokens
  One automation workflow: name, type, status, version, recurrence, stats and preview links. GET /v2/automation/getWorkflow.
• newsman_get_automation_stats ~324 tokens
  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.
• newsman_get_import_status ~140 tokens
  Status of a background subscriber import by import_id: new, running, finished or error, with times and the last error. GET /v2/import/status.
• newsman_get_list ~149 tokens
  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.
• newsman_get_list_growth ~276 tokens
  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.
• newsman_get_newsletter ~154 tokens
  Properties of one newsletter: subject, sender, status, dates, segments, links to the online view. Long HTML is clipped. GET /v2/newsletter/getProps.
• newsman_get_newsletter_clicked_links ~140 tokens
  The links clicked in one newsletter with the number of clicks and the last click time. GET /v2/newsletter/linksClicked.
• newsman_get_newsletter_stats ~145 tokens
  Delivery and engagement stats of one newsletter: sent, views, clicks, unsubscribes, bounces, spam reports and rates. GET /v2/newsletter/stats.
• newsman_get_subscriber ~162 tokens
  One subscriber of a list by email address: status and dates, name, IP, custom properties and segments. GET /v2/subscriber/getByEmail.
• newsman_get_subscriber_by_id ~137 tokens
  One subscriber by subscriber_id: status and dates, name, IP, custom properties and segments. GET /v2/subscriber/get.
• newsman_get_subscriber_history ~154 tokens
  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.
• newsman_list_automations ~391 tokens
  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.
• newsman_list_lists ~89 tokens
  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.
• newsman_list_newsletters ~426 tokens
  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
• newsman_list_segment_subscribers ~203 tokens
  The subscribers of a segment (subscriber_id and email). Paged (page from 0, up to 1000 per page). GET /v2/segment/getSubscribers.
• newsman_list_segments ~156 tokens
  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.
• newsman_list_subscribers ~337 tokens
  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.
• newsman_remove_subscriber_from_segment ~192 tokens
  WRITE: remove a subscriber from a segment (the subscriber stays on the list). POST /v2/subscriber/removeFromSegment.
• newsman_search_subscribers ~356 tokens
  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.
• newsman_subscribe_email ~393 tokens
  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/s
• newsman_unsubscribe_email ~224 tokens
  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.
• newsman_update_subscriber ~218 tokens
  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.

Browse

• Email
• SMS and text messages
• Email marketing

Related MCP servers

• Buttondown MCP by usefulapi
  Read Buttondown subscribers, emails, analytics and automations; add subscribers; write email drafts.
• MailerLite MCP by usefulapi
  Read subscribers, groups, campaigns, fields, segments, automations, webhooks; safe additive writes.
• Moosend MCP by usefulapi
  Inspect Moosend lists, subscribers, segments and campaign stats, and add or unsubscribe subscribers.
• Mailrith Email Marketing
  Manage Subscribers, Broadcasts, Sequences, Automations, and reporting in Mailrith.
• Mailchimp MCP by usefulapi
  Read audiences, members, campaigns and reports; add, update, tag and archive subscribers.
• Mail Blaze MCP by usefulapi
  Manage Mail Blaze lists, subscribers, templates, campaigns and reports; send transactional email.
• ReferralHero MCP by usefulapi
  Read ReferralHero campaigns, subscribers, referrals and rewards; add subscribers and points.
• Encharge MCP by usefulapi
  Manage Encharge people, tags, segments and fields, and track events for email automation.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/newsman.svg)](https://aptlynx.net/servers/io.usefulapi/newsman)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents