substack-api-mcp 1.0.2__tar.gz → 1.0.4__tar.gz

{substack_api_mcp-1.0.2 → substack_api_mcp-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: substack-api-mcp
-Version: 1.0.2
+Version: 1.0.4
 Summary: Self-hosted Substack API and MCP server on your own Chrome session. Noncommercial use (PolyForm Noncommercial 1.0.0).
 Project-URL: Homepage, https://cotlet.dev/integrations/substack-api-mcp-server
 Project-URL: Source, https://github.com/cotletdev/substack-api-mcp-server
@@ -21,27 +21,28 @@ Description-Content-Type: text/markdown
 
 # Substack API and MCP server, self-hosted
 
+<!-- mcp-name: dev.cotlet/substack -->
+
 A **Substack API** and a **Substack MCP server** you run on your own computer, in Python, on the session of your own Google Chrome. All 50 Substack tools we run in production at [Cotlet](https://cotlet.dev/integrations/substack-api-mcp-server): posts and drafts from Markdown, publishing and scheduling, Notes, comments, subscribers, stats, recommendations and direct messages.
 
 Substack has no public API to write posts, publish Notes or manage subscribers, and no official MCP server. This repo gives you both:
 
 - **MCP server** for Claude Code, Claude Desktop, Cursor, Codex and any MCP client, over stdio or HTTP. [Setup](#mcp-server)
 - **REST API** on `http://127.0.0.1:8787/api/v1/substack`, with OpenAPI docs at `/docs`. [Setup](#rest-api)
-- **Python**: `call("list_posts", status="draft")`, plus 14 ready scripts in [`examples/`](examples/).
+- **Python**: `call("list_posts", status="draft")`, plus 14 ready scripts in [`examples/`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/).
 
 It is for technical people who want to run it themselves, **for noncommercial use only** ([license](#license)). If you want it running 24/7 on a server, kept working when Substack changes its site, for a team or a business, use the [hosted version at cotlet.dev](https://cotlet.dev/integrations/substack-api-mcp-server).
 
 [![Substack MCP server](https://img.shields.io/badge/Substack%20MCP-50%20tools-ff6719)](#all-50-tools)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-141318)](#requirements)
-[![License: PolyForm Noncommercial 1.0.0](https://img.shields.io/badge/license-PolyForm%20Noncommercial-141318)](LICENSE)
+[![License: PolyForm Noncommercial 1.0.0](https://img.shields.io/badge/license-PolyForm%20Noncommercial-141318)](https://github.com/cotletdev/substack-api-mcp-server/blob/main/LICENSE)
 [![MCP Badge](https://lobehub.com/badge/mcp/cotletdev-substack-api-mcp-server)](https://lobehub.com/mcp/cotletdev-substack-api-mcp-server)
 
 ```bash
-git clone https://github.com/cotletdev/substack-api-mcp-server.git && cd substack-api-mcp-server
-python3 -m venv .venv && . .venv/bin/activate && pip install -e .
+uv tool install substack-api-mcp                  # or: pip install substack-api-mcp
 substack-mcp connect                               # reads your Substack session from Chrome
 substack-mcp call list_posts
-claude mcp add substack -- "$PWD/.venv/bin/substack-mcp" mcp
+claude mcp add substack -- uvx substack-api-mcp mcp
 ```
 
 ## Contents
@@ -84,6 +85,17 @@ Substack's session cookie (`substack.sid`) lasts about three months. When Substa
 
 ## Install
 
+From [PyPI](https://pypi.org/project/substack-api-mcp/):
+
+```bash
+uv tool install substack-api-mcp       # or: pipx install substack-api-mcp, or: pip install substack-api-mcp
+substack-mcp --version
+```
+
+MCP clients can also run it with no install: `uvx substack-api-mcp mcp`.
+
+From source:
+
 ```bash
 git clone https://github.com/cotletdev/substack-api-mcp-server.git
 cd substack-api-mcp-server
@@ -95,9 +107,9 @@ substack-mcp --version
 
 With [uv](https://docs.astral.sh/uv/): `uv venv && uv pip install -e .`, then `uv run substack-mcp ...`.
 
-Setting it up with an AI agent (Claude Code, Codex, Cursor)? Open it in this folder and ask it to set up the repo: [`AGENTS.md`](AGENTS.md) tells it every step, and it asks you only for the steps in Chrome.
+Setting it up with an AI agent (Claude Code, Codex, Cursor)? Open it in this folder and ask it to set up the repo: [`AGENTS.md`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/AGENTS.md) tells it every step, and it asks you only for the steps in Chrome.
 
-To update: `git pull && pip install -e .`. We copy every change of the hosted Substack tools into this repo.
+To update: `uv tool upgrade substack-api-mcp` (or `pip install -U substack-api-mcp`), from source `git pull && pip install -e .`. We copy every change of the hosted Substack tools into this repo.
 
 ## Connect your Chrome
 
@@ -164,9 +176,9 @@ The MCP server lists every tool with its input schema, a description written for
 ### Claude Code
 
 ```bash
-claude mcp add substack -- /path/to/substack-api-mcp-server/.venv/bin/substack-mcp mcp
+claude mcp add substack -- uvx substack-api-mcp mcp
 # read only:
-claude mcp add substack -- /path/to/substack-api-mcp-server/.venv/bin/substack-mcp mcp --read-only
+claude mcp add substack -- uvx substack-api-mcp mcp --read-only
 ```
 
 ### Claude Desktop
@@ -177,8 +189,8 @@ claude mcp add substack -- /path/to/substack-api-mcp-server/.venv/bin/substack-m
 {
   "mcpServers": {
     "substack": {
-      "command": "/path/to/substack-api-mcp-server/.venv/bin/substack-mcp",
-      "args": ["mcp"]
+      "command": "uvx",
+      "args": ["substack-api-mcp", "mcp"]
     }
   }
 }
@@ -186,7 +198,7 @@ claude mcp add substack -- /path/to/substack-api-mcp-server/.venv/bin/substack-m
 
 ### Cursor
 
-`~/.cursor/mcp.json`, the same block as Claude Desktop. A ready copy is in [`mcp.json`](mcp.json).
+`~/.cursor/mcp.json`, the same block as Claude Desktop. A ready copy is in [`mcp.json`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/mcp.json).
 
 ### Codex
 
@@ -194,8 +206,8 @@ claude mcp add substack -- /path/to/substack-api-mcp-server/.venv/bin/substack-m
 
 ```toml
 [mcp_servers.substack]
-command = "/path/to/substack-api-mcp-server/.venv/bin/substack-mcp"
-args = ["mcp"]
+command = "uvx"
+args = ["substack-api-mcp", "mcp"]
 ```
 
 ### Over HTTP
@@ -265,24 +277,24 @@ call("schedule_post", post_id=draft["post_id"], publish_at="2026-11-03T08:00:00-
 
 Or one tool from the shell: `substack-mcp call get_post_stats post_id=148213977`, or with a JSON object.
 
-Ready scripts in [`examples/`](examples/). Each prints JSON, takes `--out file.csv` or `--out file.json` where it makes sense, and `--help`:
+Ready scripts in [`examples/`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/). Each prints JSON, takes `--out file.csv` or `--out file.json` where it makes sense, and `--help`:
 
 | Script | What it does |
 |---|---|
-| [`draft_from_markdown.py`](examples/draft_from_markdown.py) | A `.md` file to a draft: the first heading is the title, headings, links and lists are kept. `--publish-at` schedules it. |
-| [`schedule_post.py`](examples/schedule_post.py) | Schedules a draft for a set time, or `--cancel` takes it back to drafts. |
-| [`publish_note.py`](examples/publish_note.py) | A Note now or at a set time, `--link-latest` adds a link card to your newest post. |
-| [`list_posts.py`](examples/list_posts.py) | Published, draft or scheduled posts: title, audience, dates, URL. |
-| [`get_post.py`](examples/get_post.py) | One post saved as a Markdown file. |
-| [`weekly_report.py`](examples/weekly_report.py) | New and paid subscribers, cancellations, revenue, and each new post's opens and new subscribers. |
-| [`post_stats.py`](examples/post_stats.py) | Opens, open rate, views, likes, restacks and new subscribers for your last N posts. |
-| [`daily_stats.py`](examples/daily_stats.py) | Subscribers, paid subscribers, followers and views day by day. |
-| [`traffic_sources.py`](examples/traffic_sources.py) | Where your visitors came from, most views first. |
-| [`unanswered_comments.py`](examples/unanswered_comments.py) | Comments on your last N posts that you have not replied to. |
-| [`reply_to_comment.py`](examples/reply_to_comment.py) | A reply under one comment. |
-| [`list_subscribers.py`](examples/list_subscribers.py) | Subscribers by plan or join date, with activity rating. |
-| [`export_subscribers.py`](examples/export_subscribers.py) | The full list as the CSV that Export gives in the dashboard. |
-| [`add_subscribers.py`](examples/add_subscribers.py) | Adds emails from a text or CSV file as free subscribers, after asking you. |
+| [`draft_from_markdown.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/draft_from_markdown.py) | A `.md` file to a draft: the first heading is the title, headings, links and lists are kept. `--publish-at` schedules it. |
+| [`schedule_post.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/schedule_post.py) | Schedules a draft for a set time, or `--cancel` takes it back to drafts. |
+| [`publish_note.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/publish_note.py) | A Note now or at a set time, `--link-latest` adds a link card to your newest post. |
+| [`list_posts.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/list_posts.py) | Published, draft or scheduled posts: title, audience, dates, URL. |
+| [`get_post.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/get_post.py) | One post saved as a Markdown file. |
+| [`weekly_report.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/weekly_report.py) | New and paid subscribers, cancellations, revenue, and each new post's opens and new subscribers. |
+| [`post_stats.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/post_stats.py) | Opens, open rate, views, likes, restacks and new subscribers for your last N posts. |
+| [`daily_stats.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/daily_stats.py) | Subscribers, paid subscribers, followers and views day by day. |
+| [`traffic_sources.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/traffic_sources.py) | Where your visitors came from, most views first. |
+| [`unanswered_comments.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/unanswered_comments.py) | Comments on your last N posts that you have not replied to. |
+| [`reply_to_comment.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/reply_to_comment.py) | A reply under one comment. |
+| [`list_subscribers.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/list_subscribers.py) | Subscribers by plan or join date, with activity rating. |
+| [`export_subscribers.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/export_subscribers.py) | The full list as the CSV that Export gives in the dashboard. |
+| [`add_subscribers.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/add_subscribers.py) | Adds emails from a text or CSV file as free subscribers, after asking you. |
 
 ```bash
 python examples/draft_from_markdown.py essay.md --publish-at 2026-11-03T08:00:00-05:00
@@ -495,7 +507,7 @@ The source is public, the license is not an open source license: noncommercial u
 
 ## License
 
-[PolyForm Noncommercial License 1.0.0](LICENSE). In short:
+[PolyForm Noncommercial License 1.0.0](https://github.com/cotletdev/substack-api-mcp-server/blob/main/LICENSE). In short:
 
 - **Allowed:** noncommercial use: you, for your own personal purposes with your own Substack account, or a charity, school, public research or government body. Changing the code, and sharing it under the same license.
 - **Not allowed:** any commercial use, your own business included; client work; selling or offering it, or a service built on it.
@@ -508,7 +520,7 @@ Earlier versions of this repo (the scripts for the hosted API, up to commit 4399
   <a href="https://cotlet.dev">
     <picture>
       <source media="(prefers-color-scheme: dark)" srcset="assets/logo-white.svg">
-      <img src="assets/logo.svg" alt="Cotlet" width="120">
+      <img src="https://raw.githubusercontent.com/cotletdev/substack-api-mcp-server/main/assets/logo.svg" alt="Cotlet" width="120">
     </picture>
   </a>
 </p>

{substack_api_mcp-1.0.2 → substack_api_mcp-1.0.4}/README.md

@@ -1,26 +1,27 @@
 # Substack API and MCP server, self-hosted
 
+<!-- mcp-name: dev.cotlet/substack -->
+
 A **Substack API** and a **Substack MCP server** you run on your own computer, in Python, on the session of your own Google Chrome. All 50 Substack tools we run in production at [Cotlet](https://cotlet.dev/integrations/substack-api-mcp-server): posts and drafts from Markdown, publishing and scheduling, Notes, comments, subscribers, stats, recommendations and direct messages.
 
 Substack has no public API to write posts, publish Notes or manage subscribers, and no official MCP server. This repo gives you both:
 
 - **MCP server** for Claude Code, Claude Desktop, Cursor, Codex and any MCP client, over stdio or HTTP. [Setup](#mcp-server)
 - **REST API** on `http://127.0.0.1:8787/api/v1/substack`, with OpenAPI docs at `/docs`. [Setup](#rest-api)
-- **Python**: `call("list_posts", status="draft")`, plus 14 ready scripts in [`examples/`](examples/).
+- **Python**: `call("list_posts", status="draft")`, plus 14 ready scripts in [`examples/`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/).
 
 It is for technical people who want to run it themselves, **for noncommercial use only** ([license](#license)). If you want it running 24/7 on a server, kept working when Substack changes its site, for a team or a business, use the [hosted version at cotlet.dev](https://cotlet.dev/integrations/substack-api-mcp-server).
 
 [![Substack MCP server](https://img.shields.io/badge/Substack%20MCP-50%20tools-ff6719)](#all-50-tools)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-141318)](#requirements)
-[![License: PolyForm Noncommercial 1.0.0](https://img.shields.io/badge/license-PolyForm%20Noncommercial-141318)](LICENSE)
+[![License: PolyForm Noncommercial 1.0.0](https://img.shields.io/badge/license-PolyForm%20Noncommercial-141318)](https://github.com/cotletdev/substack-api-mcp-server/blob/main/LICENSE)
 [![MCP Badge](https://lobehub.com/badge/mcp/cotletdev-substack-api-mcp-server)](https://lobehub.com/mcp/cotletdev-substack-api-mcp-server)
 
 ```bash
-git clone https://github.com/cotletdev/substack-api-mcp-server.git && cd substack-api-mcp-server
-python3 -m venv .venv && . .venv/bin/activate && pip install -e .
+uv tool install substack-api-mcp                  # or: pip install substack-api-mcp
 substack-mcp connect                               # reads your Substack session from Chrome
 substack-mcp call list_posts
-claude mcp add substack -- "$PWD/.venv/bin/substack-mcp" mcp
+claude mcp add substack -- uvx substack-api-mcp mcp
 ```
 
 ## Contents
@@ -63,6 +64,17 @@ Substack's session cookie (`substack.sid`) lasts about three months. When Substa
 
 ## Install
 
+From [PyPI](https://pypi.org/project/substack-api-mcp/):
+
+```bash
+uv tool install substack-api-mcp       # or: pipx install substack-api-mcp, or: pip install substack-api-mcp
+substack-mcp --version
+```
+
+MCP clients can also run it with no install: `uvx substack-api-mcp mcp`.
+
+From source:
+
 ```bash
 git clone https://github.com/cotletdev/substack-api-mcp-server.git
 cd substack-api-mcp-server
@@ -74,9 +86,9 @@ substack-mcp --version
 
 With [uv](https://docs.astral.sh/uv/): `uv venv && uv pip install -e .`, then `uv run substack-mcp ...`.
 
-Setting it up with an AI agent (Claude Code, Codex, Cursor)? Open it in this folder and ask it to set up the repo: [`AGENTS.md`](AGENTS.md) tells it every step, and it asks you only for the steps in Chrome.
+Setting it up with an AI agent (Claude Code, Codex, Cursor)? Open it in this folder and ask it to set up the repo: [`AGENTS.md`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/AGENTS.md) tells it every step, and it asks you only for the steps in Chrome.
 
-To update: `git pull && pip install -e .`. We copy every change of the hosted Substack tools into this repo.
+To update: `uv tool upgrade substack-api-mcp` (or `pip install -U substack-api-mcp`), from source `git pull && pip install -e .`. We copy every change of the hosted Substack tools into this repo.
 
 ## Connect your Chrome
 
@@ -143,9 +155,9 @@ The MCP server lists every tool with its input schema, a description written for
 ### Claude Code
 
 ```bash
-claude mcp add substack -- /path/to/substack-api-mcp-server/.venv/bin/substack-mcp mcp
+claude mcp add substack -- uvx substack-api-mcp mcp
 # read only:
-claude mcp add substack -- /path/to/substack-api-mcp-server/.venv/bin/substack-mcp mcp --read-only
+claude mcp add substack -- uvx substack-api-mcp mcp --read-only
 ```
 
 ### Claude Desktop
@@ -156,8 +168,8 @@ claude mcp add substack -- /path/to/substack-api-mcp-server/.venv/bin/substack-m
 {
   "mcpServers": {
     "substack": {
-      "command": "/path/to/substack-api-mcp-server/.venv/bin/substack-mcp",
-      "args": ["mcp"]
+      "command": "uvx",
+      "args": ["substack-api-mcp", "mcp"]
     }
   }
 }
@@ -165,7 +177,7 @@ claude mcp add substack -- /path/to/substack-api-mcp-server/.venv/bin/substack-m
 
 ### Cursor
 
-`~/.cursor/mcp.json`, the same block as Claude Desktop. A ready copy is in [`mcp.json`](mcp.json).
+`~/.cursor/mcp.json`, the same block as Claude Desktop. A ready copy is in [`mcp.json`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/mcp.json).
 
 ### Codex
 
@@ -173,8 +185,8 @@ claude mcp add substack -- /path/to/substack-api-mcp-server/.venv/bin/substack-m
 
 ```toml
 [mcp_servers.substack]
-command = "/path/to/substack-api-mcp-server/.venv/bin/substack-mcp"
-args = ["mcp"]
+command = "uvx"
+args = ["substack-api-mcp", "mcp"]
 ```
 
 ### Over HTTP
@@ -244,24 +256,24 @@ call("schedule_post", post_id=draft["post_id"], publish_at="2026-11-03T08:00:00-
 
 Or one tool from the shell: `substack-mcp call get_post_stats post_id=148213977`, or with a JSON object.
 
-Ready scripts in [`examples/`](examples/). Each prints JSON, takes `--out file.csv` or `--out file.json` where it makes sense, and `--help`:
+Ready scripts in [`examples/`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/). Each prints JSON, takes `--out file.csv` or `--out file.json` where it makes sense, and `--help`:
 
 | Script | What it does |
 |---|---|
-| [`draft_from_markdown.py`](examples/draft_from_markdown.py) | A `.md` file to a draft: the first heading is the title, headings, links and lists are kept. `--publish-at` schedules it. |
-| [`schedule_post.py`](examples/schedule_post.py) | Schedules a draft for a set time, or `--cancel` takes it back to drafts. |
-| [`publish_note.py`](examples/publish_note.py) | A Note now or at a set time, `--link-latest` adds a link card to your newest post. |
-| [`list_posts.py`](examples/list_posts.py) | Published, draft or scheduled posts: title, audience, dates, URL. |
-| [`get_post.py`](examples/get_post.py) | One post saved as a Markdown file. |
-| [`weekly_report.py`](examples/weekly_report.py) | New and paid subscribers, cancellations, revenue, and each new post's opens and new subscribers. |
-| [`post_stats.py`](examples/post_stats.py) | Opens, open rate, views, likes, restacks and new subscribers for your last N posts. |
-| [`daily_stats.py`](examples/daily_stats.py) | Subscribers, paid subscribers, followers and views day by day. |
-| [`traffic_sources.py`](examples/traffic_sources.py) | Where your visitors came from, most views first. |
-| [`unanswered_comments.py`](examples/unanswered_comments.py) | Comments on your last N posts that you have not replied to. |
-| [`reply_to_comment.py`](examples/reply_to_comment.py) | A reply under one comment. |
-| [`list_subscribers.py`](examples/list_subscribers.py) | Subscribers by plan or join date, with activity rating. |
-| [`export_subscribers.py`](examples/export_subscribers.py) | The full list as the CSV that Export gives in the dashboard. |
-| [`add_subscribers.py`](examples/add_subscribers.py) | Adds emails from a text or CSV file as free subscribers, after asking you. |
+| [`draft_from_markdown.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/draft_from_markdown.py) | A `.md` file to a draft: the first heading is the title, headings, links and lists are kept. `--publish-at` schedules it. |
+| [`schedule_post.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/schedule_post.py) | Schedules a draft for a set time, or `--cancel` takes it back to drafts. |
+| [`publish_note.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/publish_note.py) | A Note now or at a set time, `--link-latest` adds a link card to your newest post. |
+| [`list_posts.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/list_posts.py) | Published, draft or scheduled posts: title, audience, dates, URL. |
+| [`get_post.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/get_post.py) | One post saved as a Markdown file. |
+| [`weekly_report.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/weekly_report.py) | New and paid subscribers, cancellations, revenue, and each new post's opens and new subscribers. |
+| [`post_stats.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/post_stats.py) | Opens, open rate, views, likes, restacks and new subscribers for your last N posts. |
+| [`daily_stats.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/daily_stats.py) | Subscribers, paid subscribers, followers and views day by day. |
+| [`traffic_sources.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/traffic_sources.py) | Where your visitors came from, most views first. |
+| [`unanswered_comments.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/unanswered_comments.py) | Comments on your last N posts that you have not replied to. |
+| [`reply_to_comment.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/reply_to_comment.py) | A reply under one comment. |
+| [`list_subscribers.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/list_subscribers.py) | Subscribers by plan or join date, with activity rating. |
+| [`export_subscribers.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/export_subscribers.py) | The full list as the CSV that Export gives in the dashboard. |
+| [`add_subscribers.py`](https://github.com/cotletdev/substack-api-mcp-server/blob/main/examples/add_subscribers.py) | Adds emails from a text or CSV file as free subscribers, after asking you. |
 
 ```bash
 python examples/draft_from_markdown.py essay.md --publish-at 2026-11-03T08:00:00-05:00
@@ -474,7 +486,7 @@ The source is public, the license is not an open source license: noncommercial u
 
 ## License
 
-[PolyForm Noncommercial License 1.0.0](LICENSE). In short:
+[PolyForm Noncommercial License 1.0.0](https://github.com/cotletdev/substack-api-mcp-server/blob/main/LICENSE). In short:
 
 - **Allowed:** noncommercial use: you, for your own personal purposes with your own Substack account, or a charity, school, public research or government body. Changing the code, and sharing it under the same license.
 - **Not allowed:** any commercial use, your own business included; client work; selling or offering it, or a service built on it.
@@ -487,7 +499,7 @@ Earlier versions of this repo (the scripts for the hosted API, up to commit 4399
   <a href="https://cotlet.dev">
     <picture>
       <source media="(prefers-color-scheme: dark)" srcset="assets/logo-white.svg">
-      <img src="assets/logo.svg" alt="Cotlet" width="120">
+      <img src="https://raw.githubusercontent.com/cotletdev/substack-api-mcp-server/main/assets/logo.svg" alt="Cotlet" width="120">
     </picture>
   </a>
 </p>

substack_api_mcp-1.0.4/mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "substack": {
+      "command": "uvx",
+      "args": [
+        "substack-api-mcp",
+        "mcp"
+      ]
+    }
+  }
+}

{substack_api_mcp-1.0.2 → substack_api_mcp-1.0.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "substack-api-mcp"
-version = "1.0.2"
+version = "1.0.4"
 description = "Self-hosted Substack API and MCP server on your own Chrome session. Noncommercial use (PolyForm Noncommercial 1.0.0)."
 readme = "README.md"
 license = "PolyForm-Noncommercial-1.0.0"
@@ -24,6 +24,7 @@ Source = "https://github.com/cotletdev/substack-api-mcp-server"
 
 [project.scripts]
 substack-mcp = "substack_api_mcp.cli:main"
+substack-api-mcp = "substack_api_mcp.cli:main"
 
 [build-system]
 requires = ["hatchling>=1.27"]

{substack_api_mcp-1.0.2 → substack_api_mcp-1.0.4}/substack_api_mcp/__init__.py

@@ -11,7 +11,7 @@ from __future__ import annotations
 import asyncio
 from typing import Any
 
-__version__ = "1.0.2"
+__version__ = "1.0.4"
 
 
 def call(tool: str, args: dict[str, Any] | None = None, **kwargs: Any) -> Any:

substack_api_mcp-1.0.2/mcp.json

@@ -1,8 +0,0 @@
-{
-  "mcpServers": {
-    "substack": {
-      "command": "/path/to/substack-api-mcp-server/.venv/bin/substack-mcp",
-      "args": ["mcp"]
-    }
-  }
-}