# NewsMAN MCP by usefulapi

> NewsMAN MCP by usefulapi is an MCP server. Read NewsMAN lists, subscribers, segments, newsletter and automation stats; manage subscribers. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/newsman/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/newsman
- **MCP Registry name:** io.usefulapi/newsman
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://newsman.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "newsman": {
      "serverUrl": "https://newsman.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/newsman-mcp-by-usefulapi
