Newsletter Commerce MCP server

by teamsincetoday·io.github.teamsincetoday/newsletter-commerce-mcp·v0.1.3

No reviews yet

Extract shoppable products from newsletter content with affiliate signals.

C69/100grade C

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

C69/100

full report

Adoption

New

0 stars53 downloads/wk

Reviews

Write one

Nobody has reviewed Newsletter Commerce yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Newsletter Commerce tools (4)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

analyze_newsletter_sponsors
Identify sponsored sections in a newsletter and estimate advertising value: CPM, read-through rate, and sponsor-reader fit score. Returns each sponsor's name, placement type (dedicated section, inline, footer), estimated CPM based on industry benchmarks, and audience fit score. Revenue estimates are benchmark averages — not live ad-platform data. Use for advertising intelligence, sponsor acquisiti
extract_newsletter_products
Extract affiliate links, product recommendations, and sponsored mentions from newsletter content. Pass the newsletter body directly as HTML or plain text — does not fetch content from URLs. Supports Substack, Ghost, and Beehiiv HTML plus plain text. Returns product name, category, affiliate link URL, recommendation strength, and sponsor flag. Call this before analyze_newsletter_sponsors or track_p
generate_newsletter_products_section
Format extracted newsletter products into a 'Products in This Edition' footer section. Returns ready-to-paste markdown or HTML, grouped by endorsement strength (strong/endorsed/mentioned), with affiliate links where resolved. Use after extract_newsletter_products — pass newsletter_id to use cached extraction, or pass products[] directly. Handles null affiliate_link gracefully (plain name, no broke
track_product_trends
Compare affiliate product mentions and brand frequency across multiple newsletter issues to detect rising, stable, and declining trends. Returns trend velocity, mention count per issue, and category breakdown. No AI call — computed from cached extraction data only. Use for affiliate marketing optimization, editorial product tracking, and sponsor category analysis. Requires prior extract_newsletter

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan19 source files scanned; 19 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 173 days ago8/15
Maintainer identityregistry namespace matches repository owner6/10

Overall 69/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Newsletter Commerce compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 69/100; higher than 40% of 2,174 E-commerce servers
Tools: 4; the typical E-commerce server has 6
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 53; more than 51% of 411 E-commerce servers with a package

What its tools let an agent do: 3 read · 1 create

Install Newsletter Commerce in Claude Code, Cursor or VS Code

Runs npx -y newsletter-commerce-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add newsletter-commerce-mcp -- npx -y newsletter-commerce-mcp

Add to Cursor

What the publisher says

From the Newsletter Commerce repository's README, as published. We do not edit it. Read it on GitHub

Newsletter Commerce Intelligence MCP

Turn newsletters into affiliate revenue. Extract sponsored products, brand mentions, and affiliate signals from any Substack, Ghost, or Beehiiv issue. Then auto-generate a shoppable "Products in this edition" section ready to paste into your newsletter. F1=100% on eval suite. Free tier: 200 calls/day.

⭐ If this saves you time, please star the repo — it helps other developers find it.

Live endpoint: https://newsletter-commerce-mcp.sincetoday.workers.dev/mcp · See examples

Extract product mentions, score sponsors, and track affiliate trends from newsletters. Supports Substack, Ghost, Beehiiv, and plain text. Built on x402, the open payment standard backed by Shopify, Google, Microsoft, Visa, and the Linux Foundation.

Tools

Quick Start

# Install
npm install newsletter-commerce-mcp

# Configure
cp .env.example .env
# Edit .env: set OPENAI_API_KEY

# Run (stdio MCP server)
npx newsletter-commerce-mcp

MCP Client Config

{
  "mcpServers": {
    "newsletter-commerce": {
      "command": "npx",
      "args": ["newsletter-commerce-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

Tool Reference

extractnewsletterproducts

{
  "content": "Newsletter HTML or plain text (max 200k chars)",
  "newsletter_id": "optional-cache-key",
  "format": "html",
  "api_key": "optional-paid-key"
}

Returns:

{
  "newsletter_id": "swipe-file-issue-47",
  "products": [
    {
      "name": "Notion AI",
      "category": "saas",
      "mention_context": "running my entire writing workflow through Notion AI",
      "recommendation_strength": "strong",
      "affiliate_link": null,
      "confidence": 0.94,
      "is_sponsored": false
    }
  ],
  "sponsor_sections": [...],
  "_meta": { "processing_time_ms": 1620, "ai_cost_usd": 0.0028, "cache_hit": false }
}

analyzenewslettersponsors

{
  "content": "Newsletter HTML or plain text",
  "newsletter_id": "optional",
  "api_key": "optional"
}

Returns CPM estimate, read-through rate, and sponsor-reader fit score per sponsor section.

trackproducttrends

{
  "newsletter_ids": ["issue-45", "issue-46", "issue-47"],
  "category_filter": ["saas", "books"]
}

Requires prior extractnewsletterproducts calls for each newsletterid. Returns trend data including topcategory, avgrecommendationstrength, and brand per product trend.

generatenewsletterproducts_section

{
  "newsletter_id": "swipe-file-issue-47",
  "format": "markdown",
  "style": "full",
  "api_key": "optional"
}

Formats extracted products into a ready-to-paste 'Products in This Edition' section. Pass newsletter_id (uses cached extraction) or products[] directly. format: markdown (default) or html. style: full (default, grouped by endorsement strength with context quotes) or minimal (compact list).

Example Output

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Newsletter Commerce: common questions

Is Newsletter Commerce MCP server safe?: With care: it is graded C, so read the findings first (69/100). Read the Newsletter Commerce safety report
How do I install Newsletter Commerce?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Newsletter Commerce need an API key?: Yes. The registry entry asks for OPENAI_API_KEY, MCP_API_KEYS.
Is Newsletter Commerce maintained?: The last commit was 210 days ago (2026-04-08). The latest release is v0.1.3.
What can I use instead of Newsletter Commerce?: Servers from other publishers that do the same job: Idea Reality MCP server, Vtex MCP server and Ecommerce Trends MCP server.
How does Newsletter Commerce compare with other E-commerce MCP servers?: safety score 69/100 (higher than 40% of 2,174 E-commerce servers); tools 4 (the typical E-commerce server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Newsletter Commerce

Same job from other publishers: the closest match first, then the best rated.

Idea Reality
Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal.
not reviewed
Established
B
Vtex
MCP server for VTEX — e-commerce, orders, products, inventory, shipping
More from codespar →
not reviewed
Established
B
Ecommerce Trends MCP
Product and category demand trend volume over time, with growth signals. Free key at trendsmcp.ai
not reviewed
Growing
A
Cmssy
Hosted headless CMS with native commerce: pages, media, forms, products, orders, refunds, discounts.
not reviewed
Growing
B
PostHog MCP Server
Official PostHog MCP Server for product analytics, feature flags, experiments, and more.
not reviewed
Established
A

Run it through the gateway

Local package. It runs on your machine, not through the gateway.

Rating: —
Safety grade: C · 69/100
Stars: 0
Downloads/wk: 53
Price: Free
Licence: MIT
Transport: Local · npm
Version: 0.1.3
Category: E-commerce
Last release: 2026-04-08

Credentials it needs

OPENAI_API_KEYsecretOpenAI API key for GPT-4o-mini product extraction (required)
MCP_API_KEYSsecretComma-separated paid API keys for unlimited calls (optional — omit for free tier: 200 calls/day)

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/teamsincetoday-newsletter-commerce-mcp.svg)](https://mcp.market/server/teamsincetoday-newsletter-commerce-mcp)

How the badge works