substack-fetcher-mcp
If you are the rightful owner of substack-fetcher-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A tool to fetch and read articles from Trade Companion by Adam Mancini on Substack.
Substack Reader
A tool to fetch and read articles from Trade Companion by Adam Mancini on Substack.
Setup
Prerequisites
- Python 3.8+
- uv package manager for Python
- Claude AI assistant
Installation
-
Install uv package manager if you don't have it already:
curl -sSf https://install.ultraviolet.dev | sh -
Create and activate a virtual environment:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate -
Install dependencies using the pyproject.toml file:
uv pip install -e .
Setting up Substack Authentication
To access subscriber-only content, you'll need to provide your Substack cookies:
-
Install the Cookie-Editor extension for your browser:
-
Log in to your Substack account at tradecompanion.substack.com
-
Click on the Cookie-Editor extension icon
-
Click "Export" and select "Export as JSON" (This copies the cookies to your clipboard)
-
Create a file named
substack_cookies.jsonin the root directory of this project -
Paste the copied cookies into this file and save
Usage with Claude
This tool is designed to be used with Claude AI assistant. To set it up:
- Configure Claude to use this MCP server by adding the following to your Claude config file:
{
"mcpServers": {
"substack_reader": {
"command": "uv",
"args": [
"--directory",
"/path/to/substack_reader",
"run",
"substack_reader.py"
]
}
},
"globalShortcut": "Ctrl+Space"
}
Replace /path/to/substack_reader with the actual path to your substack_reader directory.
-
When properly configured, Claude will automatically connect to this MCP server when launched.
-
You can then ask Claude to fetch the latest Trade Companion article.
Features
- Fetches the latest Trade Companion articles by Adam Mancini
- Extracts article content in plain text format
- Preserves headings, paragraphs, and list items
- Excludes the "My Trade Methodology Fundamentals" article
Privacy Note
Your Substack cookies are stored locally in the substack_cookies.json file and are only used to authenticate requests to Substack. They are not sent anywhere else or exposed in any way.
