Stop building newsletter features from scratch.

![MCPize](https://img.shields.io/badge/MCPize-live-brightgreen) ![License: MIT](https://img.shields.io/badge/License-MIT-blue)

# Newsletter Tools

A utility MCP server with 10 tools for newsletter operators, developers, and content teams.

## Quick Start

Add this to your `claude_desktop_config.json` or MCP client config:

```json
{
  "mcpServers": {
    "newsletter-tools": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://YOUR_CLOUD_RUN_URL/mcp"]
    }
  }
}
```

## Before / After

**Input:** `subject_line_variants` with subject `"5 ways to grow your email list"`, issue_number `42`

**Output:**
```json
{
  "original": "5 ways to grow your email list",
  "curiosity": "This week: 5 ways to grow your email list",
  "question": "5 ways to grow your email list?",
  "urgency": "[Just published] 5 ways to grow your email list",
  "numbered": "Issue #42: 5 ways to grow your email list",
  "personal": "5 ways to grow your email list (a quick note)"
}
```

## Tools

| Tool | What it does |
|------|--------------|
| `slugify_text` | Convert any text to a URL-safe slug |
| `estimate_read_time` | Estimate reading time at 238 wpm |
| `extract_plain_text` | Strip HTML tags to return clean plain text |
| `generate_preview_text` | Extract a preheader snippet from content |
| `word_count_stats` | Return word, sentence, paragraph, and char counts |
| `validate_email_address` | Check email address format |
| `format_newsletter_date` | Format an ISO date into a readable header date |
| `extract_links` | Extract all URLs from HTML or plain text |
| `truncate_text` | Truncate to a word count with clean sentence boundary |
| `subject_line_variants` | Generate 6 subject line style variants |

## Who is this for?

- Newsletter operators automating workflows with Claude
- Developers building newsletter platforms and needing utility functions via MCP
- Content teams using AI assistants to prep, audit, and optimize issues before sending

## Health Check

```
GET /health
```

```json
{ "status": "ok", "server": "newsletter-tools", "version": "1.0.0", "tools": 10 }
```

## Built with MCPize

Built by [Mastermind HQ](https://mastermindshq.business)

## License

MIT