io.usefulapi/newsman · v1.0.0 · communication
NewsMAN MCP by usefulapi is healthy: it completed an MCP handshake in 1228 ms and exposes 26 tools.
Read NewsMAN lists, subscribers, segments, newsletter and automation stats; manage subscribers.
Endpoint: https://newsman.usefulapi.io/mcp (streamable-http)
Repository · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 26 |
| Latency | 1228 ms |
| Last checked (UTC) | 2026-10-26T12:00:25.065Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-26T12:00:25.065Z | Healthy | 1228 | |
| 2026-10-26T12:00:24.987Z | Healthy | 1170 |
newsman_list_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. |
newsman_get_list | 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_count_list_subscribers | The number of active (subscribed) subscribers of a list. GET /v2/list/count. |
newsman_list_subscribers | 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_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. |
newsman_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. |
newsman_get_subscriber | 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 | One subscriber by subscriber_id: status and dates, name, IP, custom properties and segments. GET /v2/subscriber/get. |
newsman_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. |
newsman_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. |
newsman_count_segment_subscribers | The number of active subscribers in a segment. GET /v2/segment/count. |
newsman_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. |
newsman_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 |
newsman_get_newsletter | 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_stats | Delivery and engagement stats of one newsletter: sent, views, clicks, unsubscribes, bounces, spam reports and rates. GET /v2/newsletter/stats. |
newsman_get_newsletter_clicked_links | The links clicked in one newsletter with the number of clicks and the last click time. GET /v2/newsletter/linksClicked. |
newsman_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. |
newsman_get_automation | One automation workflow: name, type, status, version, recurrence, stats and preview links. GET /v2/automation/getWorkflow. |
newsman_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. |
newsman_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. |
newsman_subscribe_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/s |
newsman_unsubscribe_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. |
newsman_update_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. |
newsman_add_subscriber_tags | WRITE: add tags to a subscriber (existing tags stay). POST /v2/subscriber/addTags. |
newsman_add_subscriber_to_segment | WRITE: add a subscriber to a (static) segment. POST /v2/subscriber/addToSegment. |
newsman_remove_subscriber_from_segment | WRITE: remove a subscriber from a segment (the subscriber stays on the list). POST /v2/subscriber/removeFromSegment. |