MCP server
NewsMAN MCP by usefulapi
Read NewsMAN lists, subscribers, segments, newsletter and automation stats; manage…
- Runs
- Remotely
- Version
- 1.16.0
- Listing updated
- 4 days ago
About NewsMAN MCP by usefulapi
NewsMAN MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read NewsMAN lists, subscribers, segments, newsletter and automation stats; manage subscribers.
Install
Run in a terminal
claude mcp add --transport http newsman https://newsman.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://newsman.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"newsman": {
"url": "https://newsman.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"newsman": {
"type": "http",
"url": "https://newsman.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"newsman": {
"serverUrl": "https://newsman.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"newsman": {
"type": "http",
"url": "https://newsman.usefulapi.io/mcp"
}
}
}Tools this server provides (26)
Read directly from the server.
- 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/newsletter/all.
- 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/subscriber/saveSubscribe.
- 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.
NewsMAN MCP by usefulapi FAQ
How do I add NewsMAN MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http newsman https://newsman.usefulapi.io/mcp