PyPI - substack-api-mcp - Versions diffs - 1.0.2__tar.gz → 1.0.3__tar.gz - Mend

substack-api-mcp 1.0.2tar.gz → 1.0.3tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (101) hide show

{substack_api_mcp-1.0.2 → substack_api_mcp-1.0.3}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: substack-api-mcp
-Version: 1.0.2
+Version: 1.0.3
 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,6 +21,8 @@ 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:
@@ -37,11 +39,10 @@ It is for technical people who want to run it themselves, **for noncommercial us
 [![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
@@ -97,7 +109,7 @@ With [uv](https://docs.astral.sh/uv/): `uv venv && uv pip install -e .`, then `u
 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.
-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"]
     }
   }
 }
@@ -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

{substack_api_mcp-1.0.2 → substack_api_mcp-1.0.3}/README.md RENAMED Viewed

@@ -1,5 +1,7 @@
 # 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:
@@ -16,11 +18,10 @@ It is for technical people who want to run it themselves, **for noncommercial us
 [![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
@@ -76,7 +88,7 @@ With [uv](https://docs.astral.sh/uv/): `uv venv && uv pip install -e .`, then `u
 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.
-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"]
     }
   }
 }
@@ -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

substack_api_mcp-1.0.3/mcp.json ADDED Viewed

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

{substack_api_mcp-1.0.2 → substack_api_mcp-1.0.3}/pyproject.toml RENAMED Viewed

@@ -1,6 +1,6 @@
 [project]
 name = "substack-api-mcp"
-version = "1.0.2"
+version = "1.0.3"
 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.3}/substack_api_mcp/__init__.py RENAMED Viewed

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

substack_api_mcp-1.0.2/mcp.json DELETED Viewed

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