diff --git a/docs/distribution.md b/docs/distribution.md index 43eda27..22b537a 100644 --- a/docs/distribution.md +++ b/docs/distribution.md @@ -1,7 +1,8 @@ # Distribution inventory -Maintainer: Conor Bronsdon. Directory listings were rechecked on September 14, -2026 UTC; other rows retain their September 8 verification. This is a dated +Maintainer: Conor Bronsdon. Package artifacts reflect the verified 1.2.0 release +and directory listings were rechecked on September 14, 2026 UTC; other rows retain +their September 8 verification. This is a dated status record, not a promise that third-party indexes have refreshed. npm remains the canonical package. Release artifacts are verified by the Publish workflow; directory admission and social publication are tracked separately in @@ -12,10 +13,10 @@ workflow; directory admission and social publication are tracked separately in | Destination / identity | Current status | Update or verification route | | --- | --- | --- | -| [npm: @conorbronsdon/substack-mcp](https://www.npmjs.com/package/@conorbronsdon/substack-mcp) | Published; canonical install. `latest` was 1.1.0 on September 14, with `gitHead` matching the release merge commit | Publish workflow; verify version, integrity and installed package | -| MCP Registry: `io.github.conorbronsdon/substack-mcp` | Published; version updates automated. 1.1.0 was the active latest registry entry on September 14 | Publish workflow; query registry identity/version after release | +| [npm: @conorbronsdon/substack-mcp](https://www.npmjs.com/package/@conorbronsdon/substack-mcp) | Published; canonical install. `latest` is 1.2.0 (verified September 14, 23:14 UTC), with `gitHead` matching release merge commit `85030e4` | Publish workflow; verify version, integrity and installed package | +| MCP Registry: `io.github.conorbronsdon/substack-mcp` | Published; version updates automated. 1.2.0 is the active latest entry (published September 14, 23:11 UTC) | Publish workflow; query registry identity/version after release. The search index can lag a few minutes | | [GitHub releases](https://github.com/conorbronsdon/substack-mcp/releases) | Published; automated version releases | Verify tag source and release notes | -| GHCR: `ghcr.io/conorbronsdon/substack-mcp` | 1.1.0, `latest` and the source-commit alias published and anonymously readable on September 14; the 1.1.0 attestation job is tracked separately | Publish workflow, package visibility and anonymous digest check; [guide](containers.md) | +| GHCR: `ghcr.io/conorbronsdon/substack-mcp` | `1.2.0`, `latest` and the source-commit alias resolve to `sha256:dd413f3390c2…` and are anonymously readable; SLSA provenance and SPDX SBOM attestations verify against the release commit. 1.1.1 is also attested; the 1.1.0 image has no attestations | Publish workflow, package visibility, anonymous digest check and `gh attestation verify`; [guide](containers.md) | | Docker Hub | No image advertised; follow-up destination | Maintainer must choose namespace and verify publication before listing an image | | [Product documentation](https://github.com/conorbronsdon/substack-mcp#readme) | Maintained with source | README, [workflow tutorial](workflow.md), demo and compatibility checks | | Claude Code | Repository marketplace and plugin available | [Plugin installation](plugins.md); synchronized manifest and connection check | @@ -27,20 +28,22 @@ workflow; directory admission and social publication are tracked separately in ## Directory listings (checked September 14, 2026 UTC) -Checks used unauthenticated HTTPS fetches of each public page; MCP Market and -Smithery were then rechecked in a browser because fetches could not render them. +Checks used unauthenticated HTTPS fetches of each public page. Earlier on +September 14, MCP Market and Smithery were also checked in a browser; the +late recheck after the 1.2.0 release (about 23:15 UTC) used plain fetches only, +so client-rendered pages are marked where their content could not be read. Observations describe the displayed content only; login-gated content was not inspected. | Directory | Listing and identity | Observed version | Transport and authentication wording | Status | Correction route | | --- | --- | --- | --- | --- | --- | -| [Glama](https://glama.ai/mcp/servers/conorbronsdon/substack-mcp) | Exact repository; links the npm package | Not displayed | Current README text: browser login or `SUBSTACK_*` variables; stdio and self-hosted HTTP. Lists 24 tools, matching the current catalog | Current | Request reindex through listing management if README or tools change | -| [PulseMCP](https://www.pulsemcp.com/servers/conorbronsdon-substack) | Exact repository and registry name `io.github.conorbronsdon/substack-mcp`; links the registry `server.json` | Not displayed | Not displayed in the fetched page; the summary says long-form posts are draft-only and Notes publish immediately. The displayed GitHub star count is out of date | Confirmed listing; identity current, setup wording unverified | Registry ingestion from `server.json`; no correction submitted | -| [LobeHub](https://lobehub.com/mcp/conorbronsdon-substack-mcp) | Exact repository and npm package | 0.1.0, dated August 31, 2026; marked Unvalidated | npx stdio setup with three environment variables; no browser login, profiles or multi-publication setup | Update needed | Maintainer claim or resubmission through LobeHub; use the correction text below | -| [MCP Market](https://mcpmarket.com/server/substack-4) | Listed under `conorbronsdon`; confirmed in a browser on September 14 after plain fetches hit an HTTP 429 checkpoint | Not displayed | Summary: reads publication data, creates and updates drafts, uploads images, publishes Notes immediately; long-form posts cannot be published or deleted. No browser login, consented subscribers, multi-publication support or CLI. Displays 10 GitHub stars | Confirmed listing; content predates 1.0 | Maintainer correction through MCP Market using the submission text below | -| [Smithery](https://smithery.ai/servers/@conorbronsdon/substack-mcp) | Not listed at the identity URL: in a browser on September 14 it redirected to `/servers/conorbronsdon/substack-mcp` and rendered "404: Server Not Found or Removed" | None | None | Not listed at this URL; other listings not established | Evaluate local configuration and secret handling before any authorized submission | -| MCP.so | Not observed in the server-rendered results for "substack"; the guessed `/server/substack-mcp/conorbronsdon` path returned 404 | None | None | Submission candidate; absence not established | Directory submission form after confirming no existing listing | -| mcpservers.org | Not observed in the server-rendered results for "substack" | None | None | Submission candidate; absence not established | Directory submission form after confirming no existing listing | +| [Glama](https://glama.ai/mcp/servers/conorbronsdon/substack-mcp) | Exact repository; links the npm package | Not displayed | Current README text (browser login or `SUBSTACK_*` variables; stdio and self-hosted HTTP; mentions `image_url` and footnotes). Lists 24 tools; its tool history was last updated September 8, so `rank_posts` from 1.2.0 is not shown | Reindex needed for 1.2.0 | Request reindex through listing management (maintainer sign-in) | +| [PulseMCP](https://www.pulsemcp.com/servers/conorbronsdon-substack) | Exact repository and registry name `io.github.conorbronsdon/substack-mcp`; links the registry `server.json` | Not displayed | The late recheck received a client-rendered page with no readable version or setup text; the earlier summary said long-form posts are draft-only and Notes publish immediately | Confirmed listing; identity current, setup wording unverified | Registry ingestion from `server.json`; no correction submitted | +| [LobeHub](https://lobehub.com/mcp/conorbronsdon-substack-mcp) | Exact repository and npm package | 0.1.0, dated August 31, 2026; still marked Unvalidated after the 1.2.0 release | npx stdio setup with three environment variables; no browser login, profiles or multi-publication setup | Update needed | Maintainer claim or resubmission through LobeHub; use the correction text below | +| [MCP Market](https://mcpmarket.com/server/substack-4) | Listed under `conorbronsdon`; confirmed in a browser on September 14 | Not displayed | Browser observation from earlier on September 14: reads publication data, creates and updates drafts, uploads images, publishes Notes immediately; long-form posts cannot be published or deleted. No browser login, consented subscribers, multi-publication support or CLI. The late plain fetch hit a Vercel security checkpoint (HTTP 429) | Confirmed listing; content predates 1.0 | Maintainer correction through MCP Market using the submission text below | +| [Smithery](https://smithery.ai/servers/@conorbronsdon/substack-mcp) | Earlier on September 14 the identity URL rendered "404: Server Not Found or Removed" in a browser. The late plain fetch of `/servers/conorbronsdon/substack-mcp` returned a client-rendered shell with no server details | None | None | Not listed at this URL; other listings not established | Evaluate local configuration and secret handling before any authorized submission | +| MCP.so | Not in the server-rendered search results for "substack" (17 results on the late recheck, none from this repository); the guessed `/server/substack-mcp/conorbronsdon` path returned 404 earlier | None | None | Submission candidate; absence not established | Directory submission form after confirming no existing listing | +| mcpservers.org | Not in the server-rendered search results for "substack" on the late recheck (no `conorbronsdon` entry) | None | None | Submission candidate; absence not established | Directory submission form after confirming no existing listing | | Curated lists | Coverage reconciliation pending | — | — | Pending | Search exact repository URL, check list contribution rules and existing entries before proposing additions | Search failures do not establish that a listing is absent. Before marking any @@ -55,12 +58,13 @@ Submissions and corrections are maintainer actions; this text is prepared, not sent. Replace the version with the current npm release when submitting. > **substack-mcp** — MCP server and CLI for Substack newsletter creators: rich -> Markdown drafts, Notes, analytics, archive search and consented free-subscriber +> Markdown drafts with footnotes, image upload by file or URL, Notes, post +> rankings and analytics, archive search and consented free-subscriber > management across one or more publications. Long-form posts stay drafts for > review in Substack; Notes publish immediately. > > - Repository: https://github.com/conorbronsdon/substack-mcp -> - Package: `@conorbronsdon/substack-mcp` (npm, version 1.1.0) +> - Package: `@conorbronsdon/substack-mcp` (npm, version 1.2.0) > - MCP Registry name: `io.github.conorbronsdon/substack-mcp` > - Transport: local stdio (`npx -y @conorbronsdon/substack-mcp`); optional > self-hosted Streamable HTTP