io.usefulapi/newsman

up checked 2026-11-11T05:38:35.944Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

NewsMAN MCP by usefulapi

Publisher-provided description

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

Summary by lookupd

Read email lists, subscribers, segments, newsletter and automation stats; add, update, unsubscribe and segment subscribers.

Install

Claude Code, remote (streamable-http)

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

Codex, remote (streamable-http)

codex mcp add newsman --url https://newsman.usefulapi.io/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (26 tools)

Publisher-provided text

• 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 h
• 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_dat
• 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 p
• 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/subscri
• 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
• 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
• 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. GE
• 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 s
• 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 ta
• 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/saveUnsubscri
• 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.

Details

• Version: 1.13.3
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 497 ms
• First indexed: 2026-11-01T10:05:28.320Z
• Last seen in registry: 2026-11-11T00:17:30.244Z
• Repository: https://github.com/m190/usefulapi-mcp
• Website: https://usefulapi.io/newsman/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.usefulapi/newsman.svg)](https://lookupd.com/servers/io.usefulapi/newsman)

• 62092 servers
• Last crawl: 2026-11-11T17:17:22.074Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp