
Reletter
com.reletterPublished by reletter.comOfficial publisherv0.1.0Updated Oct 27, 2026
Search and analyze 7M+ newsletters, issues, contacts, and chart rankings from Reletter.
Overview
Remote MCP server that lets an assistant search and analyze Reletter's index of 7M+ newsletters, issues, contacts and chart rankings.
- What you can do
- Search newsletters by topic, title or author, with keyword autocomplete and a language reference list
- Full-text search newsletter issue bodies, list a publication's recent issues and pull a single issue's body text
- Read publication metadata such as subscribers, engagement, socials, rankings and SEO reach
- Retrieve email contacts, contact pages and social accounts for a newsletter
- Browse chart platforms and categories and fetch the latest chart rankings
- Check the API request quota and monthly usage
- When to use it
- Useful for media research, PR and sponsorship work: finding newsletters to pitch or partner with, building target lists with verified contacts, monitoring brand or keyword mentions, and tracking newsletter chart rankings.
- Requirements
- A remote endpoint at mcp.reletter.com with OAuth authentication; a Reletter API key is entered when the connector is added. No local runtime is needed for normal use. Forking or self-hosting requires Node.js and, for deployment, a Cloudflare account.
Installation
In SourceWeft
- Open Reletter in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/com.reletter%2Freletter/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"reletter": {
"type": "http",
"url": "https://mcp.reletter.com/"
}
}
}README
Reletter MCP Server
Give AI agents and LLMs access to newsletter data from Reletter. Search 7M+ email newsletters across Substack, LinkedIn, Ghost, Beehiiv, and Kit. Fetch metadata, contacts, issues, and chart rankings.
This is a remote Model Context Protocol (MCP) server that connects AI assistants like Claude, ChatGPT, and Cursor to the Reletter API.
Use cases
- Read and analyze newsletter issues — pull the full body text of any indexed issue into your AI workflow
- Search and discover newsletters — find newsletters by topic, platform, or audience size
- Find newsletters to pitch — get your product, tool, or book featured. Filter by audience size, topic, or platform, then pull verified contact emails in one pass
- Build sponsorship, cross-promotion, and PR target lists — pull verified contacts and export them to your CRM
- Monitor brand or keyword mentions — track when your brand, competitors, or clients are mentioned across newsletters
- Track chart rankings — daily Substack / LinkedIn / Kit / Reletter chart data
Tools
- search_publications — Search for newsletters by topic, title, or author with filters
- search_issues — Full-text search across newsletter issue bodies
- autocomplete — Suggested keywords and matching newsletters for a partial query
- get_publication — Full metadata for a newsletter (subscribers, engagement, social, rankings, SEO reach)
- list_issues — Recent issues for a publication
- get_issue — A single issue with body text
- contacts — Email contacts, contact pages, social accounts for a newsletter
- chart_categories — Available chart platforms and categories
- chart_rankings — Latest chart rankings for a platform / category
- list_languages — Reference list of languages
- api_quota — Your API request quota and usage for the month
Setup
You need a Reletter API key. Get one here.
For autonomous agents that want to provision a key without a human in the loop, Reletter implements the Machine Payments Protocol. Hit POST https://api.reletter.com/api/payments/buy/ to get a 402 challenge, pay with a Stripe Shared Payment Token or with USDC on Tempo, and the response carries an API key tied to a freshly-provisioned account. Current bundle tiers: GET https://api.reletter.com/api/payments/bundles/. See https://reletter.com/llms-full.txt for the full flow.
ChatGPT
- Go to Settings → Apps → Advanced settings and enable Developer mode
- Click Create app
- Enter Name:
Reletter - Enter MCP Server URL:
https://mcp.reletter.com - Click Create and enter your Reletter API key when prompted
Claude.ai
- Go to Settings → Connectors
- Click Add custom connector and enter name
Reletterand MCP server URLhttps://mcp.reletter.com - Click Add and enter your Reletter API key when prompted
Claude Desktop
Add to your config file and restart Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Claude Code
Add to your project's .mcp.json:
Cursor
Go to Settings → MCP → Add new MCP server. Set type to URL and enter https://mcp.reletter.com.
Development
If you want to fork or customize this MCP server for your own needs, here is how you can run or deploy it.
Prerequisites
- Node.js
- A Cloudflare account (for deployment)
Local dev
The server runs at http://localhost:8789. Test with the MCP Inspector:
Type-check
Regenerate Cloudflare types
After changing wrangler.jsonc:
Source: README.md at commit 2ff99d0
Tools
0Version history
1- v0.1.0LatestSep 16, 2026
Score
85% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts