Merge pull request #128 from conorbronsdon/release/1.2.1

Release 1.2.1 and add community setup walkthrough

Author: conorbronsdon

.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
       "name": "substack-mcp",
       "source": "./",
       "description": "Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.",
-      "version": "1.2.0"
+      "version": "1.2.1"
     }
   ],
   "description": "Safe Substack creator tools for drafts, Notes, analytics, and consented subscribers, maintained with the server."

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "substack-mcp",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.",
   "author": {
     "name": "Conor Bronsdon",

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "substack-mcp",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.",
   "keywords": [
     "mcp",

.mcp.json

@@ -4,7 +4,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@conorbronsdon/substack-mcp@1.2.0"
+        "@conorbronsdon/substack-mcp@1.2.1"
       ],
       "env": {
         "MCP_TRANSPORT": "stdio"

CHANGELOG.md

@@ -8,6 +8,12 @@ and the git tag history (`v0.1.0`–`v0.5.0`).
 
 ## [Unreleased]
 
+## [1.2.1] - 2026-09-18
+
+### Added
+- Link Jonathan Price's Codex and ChatGPT setup walkthrough from the README and
+  draft-workflow guide (#126), with the version context for its reported bug.
+
 ### Fixed
 - `get_post` retrieves published posts using the numeric-ID endpoint and unwraps
   its `post` response (#125). Previously, numeric IDs were sent to the slug endpoint

README.md

@@ -16,7 +16,7 @@ Create and manage your Substack newsletter from your AI assistant or terminal. P
 
 ---
 
-![Create, search, export, plan and review a draft with substack-mcp](https://raw.githubusercontent.com/conorbronsdon/substack-mcp/dc259c332ec0fc561a75104063a79e816545351a/docs/workflow-demo.gif)
+![Create, search, export, plan and review a draft with substack-mcp](https://raw.githubusercontent.com/conorbronsdon/substack-mcp/7d0e8d675915a867901eca438d98ec066ab6c832/docs/workflow-demo.gif)
 
 The demo runs actual MCP handlers against offline sample data. No live API calls or publication occur. Follow the [draft workflow](docs/workflow.md) to create, find, export and review a post.
 
@@ -59,6 +59,19 @@ For 1.0 setup coverage and account eligibility, see [compatibility](docs/compati
    drafts until you publish them in Substack's editor. `create_note` and
    `create_note_with_link` publish immediately.
 
+## Community walkthrough
+
+Jonathan Price's [I used Codex to connect ChatGPT to Substack. Then it drafted this post.](https://craftandcontext.substack.com/p/i-used-codex-to-connect-chatgpt-to-substack)
+walks through using Codex to install the MCP locally, connecting ChatGPT through
+OpenAI's Secure MCP Tunnel, and creating a private draft for manual publication.
+He used the connection to create the draft of the guide itself.
+
+The guide documents his September 18, 2026 setup with version 1.2.0. Its reported
+`get_post` 404 is fixed in 1.2.1. Client interfaces and access requirements can
+change; use the [setup instructions below](#setup) for this package's current
+configuration. This is a community walkthrough, not a hosted service provided
+by this project.
+
 ## Setup
 
 Requires **Node.js 22 or newer** (CI covers Node 22 and 24). Browser login additionally requires Playwright.

docs/workflow-demo.gif

@@ -1,5 +1,5 @@
 {
-  "version": "1.2.0",
+  "version": "1.2.1",
   "disclosure": "OFFLINE SAMPLE DATA / actual MCP handlers / no live API calls",
   "frames": [
     {

docs/workflow-demo.json

@@ -30,6 +30,19 @@ preflight checks do not prove rendering or publication readiness. The server
 does not publish, schedule or delete long-form posts. The separate Note tools
 publish immediately and are not used in this workflow.
 
+## Community example: Codex and ChatGPT
+
+For a complete installation-to-draft account, read Jonathan Price's
+[I used Codex to connect ChatGPT to Substack. Then it drafted this post.](https://craftandcontext.substack.com/p/i-used-codex-to-connect-chatgpt-to-substack)
+at Craft & Context. He used Codex for local setup, connected ChatGPT through
+OpenAI's Secure MCP Tunnel, and created the guide as a private Substack draft
+before publishing it manually.
+
+His September 18, 2026 walkthrough used 1.2.0 and reported a `get_post` 404;
+that retrieval bug is fixed in 1.2.1. Follow the [current package setup](../README.md#setup)
+for configuration and keep the distinction between private long-form drafts
+and immediately published Notes.
+
 ## Use the CLI for file review
 
 The CLI shares the MCP credential resolution and draft safeguards: