SubstackSAFE
🤖 MCP Server for Substack integration with Claude AI Desktop. Download and parse Substack posts directly in your Claude conversations.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
A Model Context Protocol (MCP) server for downloading and parsing Substack posts. Works with Claude.ai desktop app.
Installation
- Install dependencies:
npm install
- Configure Claude desktop app:
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"mcp-substack": {
"command": "/opt/homebrew/bin/node",
"args": ["/path/to/mcp-substack/lib/index.mjs"],
"methods": {
"download_substack": {
"description": "Download and parse content from a Substack post"
}
}
}
}
}- Start the server:
npm start
Usage
In Claude desktop app, use:
Could you download and summarize this Substack post: [URL]
Features
- Downloads and parses Substack posts
- Extracts title, author, subtitle, and content
- Works with public Substack posts
- Integrates with Claude.ai desktop app
Requirements
- Node.js v18+
- Claude desktop app
License
MIT
3f9250eff4ceOBSERVED · 2026-10-10Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add mcp-substack -- npx -y [email protected]
{
"mcpServers": {
"mcp-substack": {
"command": "npx",
"args": [
"-y",
"[email protected]"
]
}
}
}Exposed tools (1)
0 read · 1 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
download_substack | write | Download and parse content from a Substack post |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (1 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (2)
@modelcontextprotocol/sdk, cheerio, node-fetch, undici
Gates applied: no_behavioural_pass, no_license.
3f9250eff4cefull audit observations/trust-audit/mcp-server/michalnaka__substack.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-10 | 3f9250eff4ce | SAFE | B | 89 | first audit |
Questions
What is the Substack MCP server?
🤖 MCP Server for Substack integration with Claude AI Desktop. Download and parse Substack posts directly in your Claude conversations.
What tools does Substack expose?
1 in total: 0 read-only, 1 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Substack safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does Substack need?
No credential environment variables were found in its source, so it appears to need none.
How does Substack run?
It speaks stdio, so it runs as a local process your client starts. It is published on npm as mcp-substack at 0.1.0.
How current is this page?
The grade is for one exact copy of the source (3f9250eff4ce), read on 2026-10-10. The repository is watched and re-audited when it changes.