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.