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

Related MCP server: Tushare MCP Server

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:

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.