What is Substack Fetcher Mcp

substack-fetcher-mcp is a tool designed to fetch and read articles from the Substack platform, specifically from the Trade Companion newsletter by Adam Mancini.

Use cases

Use cases include reading articles from Trade Companion, automating content fetching for personal use, and enhancing AI interactions with specific newsletter content.

How to use

To use substack-fetcher-mcp, first ensure you have Python 3.8+ and the uv package manager installed. Set up a virtual environment, install dependencies, and configure Substack authentication by exporting your cookies into a JSON file. Finally, integrate it with the Claude AI assistant by modifying its config file.

Key features

Key features include fetching subscriber-only content, easy setup with Python, integration with Claude AI, and a straightforward virtual environment management using the uv package manager.

Where to use

substack-fetcher-mcp can be used in content aggregation, personal reading applications, and AI-assisted reading tools, particularly for users interested in Substack newsletters.

Substack Reader

A tool to fetch and read articles from Trade Companion by Adam Mancini on Substack.

Setup

Prerequisites

1. Python 3.8+
2. uv package manager for Python
3. Claude AI assistant

Installation

1. Install uv package manager if you don’t have it already:

   curl -sSf https://install.ultraviolet.dev | sh
   

2. Create and activate a virtual environment:

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. 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:

1. Install the Cookie-Editor extension for your browser:

   • Chrome Web Store
   • Firefox Add-ons

2. Log in to your Substack account at tradecompanion.substack.com

3. Click on the Cookie-Editor extension icon

4. Click “Export” and select “Export as JSON” (This copies the cookies to your clipboard)

5. Create a file named substack_cookies.json in the root directory of this project

6. 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:

1. 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.

2. When properly configured, Claude will automatically connect to this MCP server when launched.

3. 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.