{"_id":"@conorbronsdon/substack-mcp","_rev":"19-b1bc8a4d13c2055ded36ad7e2df9f43d","name":"@conorbronsdon/substack-mcp","dist-tags":{"latest":"1.4.0"},"versions":{"0.2.0":{"name":"@conorbronsdon/substack-mcp","version":"0.2.0","keywords":["mcp","substack","newsletter","ai","claude"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@0.2.0","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js"},"dist":{"shasum":"b4d2b380436ea4d44c0d8d7dead6ee659b7914fe","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-0.2.0.tgz","fileCount":24,"integrity":"sha512-9P7fL9qNnLHUQX7rmhNT5yZq46a9Ooqyg/fPVRtN38tj1eE8WNZPtg96w73p/sNckWA0GYazSMBGk3rEqAPJHw==","signatures":[{"sig":"MEUCIGy5nbDZTUeZcDmwZgtDTeFsM6iSustY6UteDC+4Q8P7AiEAgFbauvyXbSuCamDMyTGDbUwRXRGxK2hPIGsUeUVCE9I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62524},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"a27c5bc292ecce4371cbee3cc4a45e4a5baceb83","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"conorbronsdon","email":"hello@conorbronsdon.com"},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Substack — read posts, manage drafts. No publish or delete by design.","directories":{},"_nodeVersion":"22.17.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_0.2.0_1773383127431_0.2839451731910745","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@conorbronsdon/substack-mcp","version":"0.2.1","keywords":["mcp","substack","newsletter","ai","claude"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@0.2.1","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js"},"dist":{"shasum":"a17b893c2133bb0b460094dd6f4ff08496cba3ed","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-0.2.1.tgz","fileCount":24,"integrity":"sha512-Xb7ddKlcsNch+cOC8W44tOtuM520BNBL2znYc0tc5k0FS5xBpyctvIZBkJcneOMVJnhjAFnS5HdYyRxpEghkiw==","signatures":[{"sig":"MEQCID09YEcJ9nyYvwGsk9Qdott0tGraQMBjgKx6vYxUEiu6AiA/ZfF1GVFPhg2vgNPHKZroPjgCq9J/FASN8aidlwWBNA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62273},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"85f5092c9d27bc089605c1e50a9944e9886060b5","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"conorbronsdon","email":"hello@conorbronsdon.com"},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Substack — read posts, manage drafts. No publish or delete by design.","directories":{},"_nodeVersion":"22.17.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_0.2.1_1773386636257_0.4784946429225483","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@conorbronsdon/substack-mcp","version":"0.2.2","keywords":["mcp","substack","newsletter","ai","claude"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@0.2.2","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js"},"dist":{"shasum":"c538412c728d585722beb4ca3f08cb4ffa0b602b","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-0.2.2.tgz","fileCount":34,"integrity":"sha512-apwEExAoVEEps+XYr/aM2aO8Tfa7aVBoa0SHh2PtJ/upv7VDiY4FvHlxXI/ajQhiO2LCxsc2v1YXtLBzJ8L+BQ==","signatures":[{"sig":"MEQCIG4KKjVmzTpMDxslUGWE8Lk6XbjZOiFjxAAIzqrAycFJAiBBXJkR9tgGmiLgQzknbV3s8TWmG322U4QrszM/0FeYWg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":84891},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"283f37e30d794ba80836b5a6d139d394faa1bd5a","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"conorbronsdon","email":"hello@conorbronsdon.com"},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Substack — read posts, manage drafts. No publish or delete by design.","directories":{},"_nodeVersion":"22.17.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","vitest":"^4.1.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_0.2.2_1774077151440_0.589151867009253","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@conorbronsdon/substack-mcp","version":"0.3.0","keywords":["mcp","substack","newsletter","ai","claude"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@0.3.0","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js"},"dist":{"shasum":"f002a35fd7e9d533a5ac3850d808282cc8041435","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-0.3.0.tgz","fileCount":43,"integrity":"sha512-kS1A5wsJ8JTEl/UHu09ELsflgUMmuDRl6M8FL/uUrLEiXttC+phtjB+vyp08qp1HAceXrvq2zSondjrfXPk5Zw==","signatures":[{"sig":"MEYCIQDDLNqzZ6xLInwyUlyLrEOlaVN/HXWrvQZEpG9yc7a/igIhAKQSRm/k78q9V8CM1BqJ3r5yIbCOZdESaMpp/jSuKz6f","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":200597},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"6ad9f1563c1bef9ff1d54fab17a23761cb6e84b2","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"conorbronsdon","email":"hello@conorbronsdon.com"},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"MCP server for Substack — read posts, manage drafts, publish Notes. Long-form posts are draft-only by design (no publish, no delete); Notes publish immediately.","directories":{},"_nodeVersion":"22.17.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","vitest":"^4.1.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_0.3.0_1781241779850_0.16294431461432235","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@conorbronsdon/substack-mcp","version":"0.4.0","keywords":["mcp","substack","newsletter","ai","claude"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@0.4.0","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js"},"dist":{"shasum":"a415465d05f5e77fbf2b181d9d4882dae70f050f","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-0.4.0.tgz","fileCount":44,"integrity":"sha512-ZFPT6p3n/J6LqCjtSK+MBt1K13Vz9Wtdx7jPIBsMyt3ueQCyKKyzGf4ZZPMKU2OLhYVZQ+PfHHmB7i8qZeG2TA==","signatures":[{"sig":"MEQCIACnal+O5vlRis+K7RxrjU/7CHYRjY1AVqStL0k3fIGVAiAnwihGXRxkPE5YRXuzdxABgHD6ZHfgvm8eCnrjxu1qzg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":236280},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"ae94fcc3599971f5bfe80f5dc068153cfb20c1d9","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.18.0","description":"MCP server for Substack — read posts, manage drafts, publish Notes. Long-form posts are draft-only by design (no publish, no delete); Notes publish immediately.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","vitest":"^4.1.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_0.4.0_1783497816841_0.3338887769391168","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@conorbronsdon/substack-mcp","version":"0.5.0","keywords":["mcp","substack","newsletter","ai","claude"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@0.5.0","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"dist":{"shasum":"c9a3f07b46d78324443ac4b11db1984531dcb130","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-0.5.0.tgz","fileCount":59,"integrity":"sha512-ovJG5zgLDPUdIwvIwDQV/iSIy5gT8Sr2oMX8sqj6TEGf+A7okiD+63Lof0d7ibaJuVIi46pufvj/gyRkF8bO/Q==","signatures":[{"sig":"MEUCIH0nbPsuINEF2zBTid2aNCxoS/BsUOhYUjtJtfA3Lw3fAiEA11egqaaxf4GRWQb50kgOHeNGKuXAq4yRDi8TFHuDsZ8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@0.5.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":316708},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"9aa0cb908f03c240842e777cf91b96be5aa572c7","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.16.0","description":"MCP server for Substack — read posts, manage drafts, publish Notes. Long-form posts are draft-only by design (no publish, no delete); Notes publish immediately.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","vitest":"^4.1.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_0.5.0_1783637861866_0.1114565375678851","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"@conorbronsdon/substack-mcp","version":"0.6.0","keywords":["mcp","substack","newsletter","ai","claude"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@0.6.0","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"dist":{"shasum":"a55e94a38ffa70f59178b82a9ba7b1cf55547118","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-0.6.0.tgz","fileCount":68,"integrity":"sha512-1cugawrQU5FNY1NUzh5gwFMIkF0tCLoTPOWXRmHVUGZGa4txjawQtjaYJhQGazdAuqxd8xQSB5baHuCLxwElgA==","signatures":[{"sig":"MEUCIQCfGUDAokTSPFfrbI7aAGUHu4s7DYvIac3jQG4Dgt+x6wIgF51qi7+l6SxdSxMdnbJhWS139PsFzPk/s9+IzM8TRwk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@0.6.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":336060},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"d1d10064439c798d7a78ca8035541239261dc42d","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.16.0","description":"MCP server for Substack — read posts, manage drafts, publish Notes. Long-form posts are draft-only by design (no publish, no delete); Notes publish immediately.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","vitest":"^4.1.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_0.6.0_1783711811462_0.49306794169749524","host":"s3://npm-registry-packages-npm-production"}},"0.6.1":{"name":"@conorbronsdon/substack-mcp","version":"0.6.1","keywords":["mcp","substack","newsletter","ai","claude"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@0.6.1","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"dist":{"shasum":"4161b38087909a3cbfcab1c837b87406b7ba5641","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-0.6.1.tgz","fileCount":74,"integrity":"sha512-4Kco9VTlV+Ok2+ju1iZiwMabGNyD0pDrLCI2Mk3nYsUqjEeYQ24K4Ip99kXpRDlx8pqDitL/opOr5gdYfP8j6g==","signatures":[{"sig":"MEYCIQC82r9kMLJM06/OEV2DoW+fGqTgDpeUFu7tRpupkGBGpgIhALX0oz6SUDmoobUZcXBzz30f7o0nd142fQWi7wTZtYA0","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@0.6.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":377634},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"10138b8dace3fe815ff43c4cb5002737d3438a26","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.16.0","description":"MCP server for Substack — read posts, manage drafts, publish Notes. Long-form posts are draft-only by design (no publish, no delete); Notes publish immediately.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","vitest":"^4.1.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_0.6.1_1785747041821_0.9027932924134026","host":"s3://npm-registry-packages-npm-production"}},"0.6.2":{"name":"@conorbronsdon/substack-mcp","version":"0.6.2","keywords":["mcp","substack","newsletter","ai","claude"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@0.6.2","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"dist":{"shasum":"eddedad38ff0049b396a89ca67233d7b94f895fa","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-0.6.2.tgz","fileCount":50,"integrity":"sha512-6btxnUKJPlsDeCAZBHknkBeaa5yGFratxLmUftAV0t/zK/PxwoUy67jJoay+qkDjxCsNdkr4ryPPmuOO2VtsOA==","signatures":[{"sig":"MEQCIH1kHbSM68uE9xPsFeeJ40/R3o3lxpvSKPsQKBU8H59qAiBYcvM+yee1/7UskVrjERPv71NhMwBOhbJvAtYLRN0F3w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@0.6.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":265760},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"e6aaf72586becbf7e2712c3181534ce9abac244a","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit -p tsconfig.lint.json","test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.16.0","description":"MCP server for Substack — read posts, manage drafts, publish Notes. Long-form posts are draft-only by design (no publish, no delete); Notes publish immediately.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","vitest":"^4.1.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_0.6.2_1785750493590_0.5350650445996454","host":"s3://npm-registry-packages-npm-production"}},"0.7.0":{"name":"@conorbronsdon/substack-mcp","version":"0.7.0","keywords":["mcp","substack","newsletter","ai","claude"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@0.7.0","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"dist":{"shasum":"b595527726dd86153f5f44b48c4dff6679cb7ac9","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-0.7.0.tgz","fileCount":40,"integrity":"sha512-rEzIgQqoAY7DlQKg6mxETjD383r8eWUhsxfju9lA0PiKk1mqTsnnhid158mSbVFomYN4DAABASWcOWsfrx4nmg==","signatures":[{"sig":"MEQCIBQN1Rb6MRgWPd2++DyrF8RGP4J8tnV+qnHKXUAWPsqDAiBof5n614g51tpzouhZl43c3IFASmO+Ebwd4hBPdQtNrA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@0.7.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":211975},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"e575542cfa88d5b1ad4fd8a4591908f511091e5f","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit -p tsconfig.lint.json","test":"vitest run src/__tests__","build":"tsc","start":"node dist/index.js","version":"npm run sync:release && npm run check:release && git add package-lock.json server.json .codex-plugin/plugin.json .mcp.json","lint:cloud":"wrangler types --config cloud/wrangler.jsonc cloud/worker-configuration.d.ts && tsc -p cloud/tsconfig.json && tsc -p cloud/test/tsconfig.json","test:cloud":"vitest run --config cloud/vitest.config.ts","build:cloud":"wrangler deploy --config cloud/wrangler.jsonc --dry-run","sync:release":"node scripts/sync-release-metadata.mjs","test:package":"npm run build && node scripts/test-package.mjs","test:release":"node --test scripts/check-release-order.controls.mjs scripts/check-release-metadata.controls.mjs","check:release":"node scripts/check-release-metadata.mjs","prepublishOnly":"npm run check:release && npm run lint && npm test && npm run test:package"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","semver":"^7.8.5","vitest":"^4.1.0","wrangler":"^4.129.0","typescript":"^5.7.0","@types/node":"^22.0.0","@cloudflare/vitest-plugin":"^1.1.4"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_0.7.0_1788807251745_0.2584955747110327","host":"s3://npm-registry-packages-npm-production"}},"0.8.0":{"name":"@conorbronsdon/substack-mcp","version":"0.8.0","keywords":["mcp","substack","newsletter","ai","claude"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@0.8.0","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"dist":{"shasum":"6bac27a6b9a129ce4c22f1cb674dac0c123a0c7a","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-0.8.0.tgz","fileCount":46,"integrity":"sha512-uCxTAlTcGoDzviR/ySOLP8KoeFdkfv1LTfKqCjGIYvUDcAve5yogQcQ7EzA6ECXx5grCWi1ETBcnYehJB22Tvg==","signatures":[{"sig":"MEUCIH3vHRy0B3mEsnGrSO2NYW+p5GAYh0r6INmzCWegAxuxAiEA/4jUEAmHvnBE+YWC5hcjGdJAK5q6efX7jZ5MdtIA0T4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@0.8.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":234418},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"3889036326413caedc4b113c627597e3e71c12f4","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit -p tsconfig.lint.json","test":"vitest run src/__tests__","build":"tsc","start":"node dist/index.js","version":"npm run sync:release && npm run check:release && git add package-lock.json server.json .codex-plugin/plugin.json .mcp.json","lint:cloud":"wrangler types --config cloud/wrangler.jsonc cloud/worker-configuration.d.ts && tsc -p cloud/tsconfig.json && tsc -p cloud/test/tsconfig.json","test:cloud":"vitest run --config cloud/vitest.config.ts","build:cloud":"wrangler deploy --config cloud/wrangler.jsonc --dry-run","sync:release":"node scripts/sync-release-metadata.mjs","test:package":"npm run build && node scripts/test-package.mjs","test:release":"node --test scripts/check-release-order.controls.mjs scripts/check-release-metadata.controls.mjs","check:release":"node scripts/check-release-metadata.mjs","prepublishOnly":"npm run check:release && npm run lint && npm test && npm run test:package"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","semver":"^7.8.5","vitest":"^4.1.0","wrangler":"^4.129.0","typescript":"^5.7.0","@types/node":"^22.0.0","@cloudflare/vitest-plugin":"^1.1.4"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_0.8.0_1788810526759_0.44840649106125485","host":"s3://npm-registry-packages-npm-production"}},"0.9.0":{"name":"@conorbronsdon/substack-mcp","version":"0.9.0","keywords":["mcp","substack","newsletter","ai","claude"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@0.9.0","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"dist":{"shasum":"093cbd066774ee568f2350d1ed638b34c31feec5","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-0.9.0.tgz","fileCount":68,"integrity":"sha512-bzX1+3VKiYtCGAIOUxsBSZGNFAQQBtPNBb4xBTt3NEodiaqjZsei/Ov4N/s4r1bcfEs2NZ4xRxSfi0ahcj5Q3g==","signatures":[{"sig":"MEUCIEfe8j1qubvvewW+XBdVb6lVKxr1GL170JY2VP6zdQj8AiEAgOTcyorqCTJwOfuwNoO9ESY0I0X0ISwiz3kAkNyQE8I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@0.9.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":391415},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"473f338bf542a51edbacd658188ae9e79823518b","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit -p tsconfig.lint.json","test":"vitest run src/__tests__","build":"tsc","start":"node dist/index.js","version":"npm run sync:release && npm run check:release && git add package-lock.json server.json .codex-plugin/plugin.json .mcp.json","lint:cloud":"wrangler types --config cloud/wrangler.jsonc cloud/worker-configuration.d.ts && tsc -p cloud/tsconfig.json && tsc -p cloud/test/tsconfig.json","test:cloud":"vitest run --config cloud/vitest.config.ts","build:cloud":"wrangler deploy --config cloud/wrangler.jsonc --dry-run","sync:release":"node scripts/sync-release-metadata.mjs","test:package":"npm run build && node scripts/test-package.mjs && node scripts/workflow-demo.mjs","test:release":"node --test scripts/check-release-order.controls.mjs scripts/check-release-metadata.controls.mjs scripts/release-state.controls.mjs","check:release":"node scripts/check-release-metadata.mjs","prepublishOnly":"npm run check:release && npm run lint && npm test && npm run test:package"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^3.24.0","mdast-util-gfm":"3.1.0","mdast-util-to-markdown":"2.1.2","micromark-extension-gfm":"3.0.0","mdast-util-from-markdown":"2.0.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","semver":"^7.8.5","vitest":"^4.1.0","wrangler":"^4.129.0","typescript":"^5.7.0","@types/node":"^22.0.0","@types/mdast":"4.0.4","@cloudflare/vitest-plugin":"^1.1.4"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_0.9.0_1788837738401_0.5887268461790482","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@conorbronsdon/substack-mcp","version":"1.0.0","keywords":["mcp","substack","newsletter","ai","claude"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@1.0.0","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"dist":{"shasum":"52a8f84d02b61b32d2acacf9baf32a0925c4de14","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-1.0.0.tgz","fileCount":82,"integrity":"sha512-neRFbx+PB2v9wnjAGBmos519RB7Nybno8gTTbbYa/jvBR/6KdBcs6C6YUNQ7+0F4n+nfqWfUDq0YnYgpsTzazA==","signatures":[{"sig":"MEUCIEsJdybPXLp6R8suhqZxv0+96STnQ1332zANjyjIBhLLAiEAieVORuqYY/qbp9WnnStjPipSSkLWE17R82swZ8vpqPA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":454231},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"b5aeb403c6d01f9bf762828e99aa3cabc7798810","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit -p tsconfig.lint.json","test":"vitest run src/__tests__","build":"tsc","start":"node dist/index.js","version":"npm run sync:release && npm run check:release && git add package-lock.json server.json .codex-plugin/plugin.json .claude-plugin/plugin.json .claude-plugin/marketplace.json .mcp.json","lint:cloud":"wrangler types --config cloud/wrangler.jsonc cloud/worker-configuration.d.ts && tsc -p cloud/tsconfig.json && tsc -p cloud/test/tsconfig.json","test:cloud":"vitest run --config cloud/vitest.config.ts","build:cloud":"wrangler deploy --config cloud/wrangler.jsonc --dry-run","sync:release":"node scripts/sync-release-metadata.mjs","test:package":"npm run build && node scripts/test-package.mjs && node scripts/workflow-demo.mjs","test:release":"node --test scripts/check-release-order.controls.mjs scripts/check-release-metadata.controls.mjs scripts/release-state.controls.mjs scripts/probe-contract.controls.mjs scripts/publish-container.controls.mjs","check:release":"node scripts/check-release-metadata.mjs","prepublishOnly":"npm run check:release && npm run lint && npm test && npm run test:package","probe:contract":"node scripts/probe-contract.mjs --read-only"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^3.24.0","mdast-util-gfm":"3.1.0","mdast-util-to-markdown":"2.1.2","micromark-extension-gfm":"3.0.0","mdast-util-from-markdown":"2.0.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","semver":"^7.8.5","vitest":"^4.1.0","wrangler":"^4.129.0","typescript":"^5.7.0","@types/node":"^22.0.0","@types/mdast":"4.0.4","@cloudflare/vitest-plugin":"^1.1.4"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_1.0.0_1788850943090_0.9382507703782637","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@conorbronsdon/substack-mcp","version":"1.1.0","keywords":["mcp","substack","newsletter","ai","claude","mcp-server","model-context-protocol","cli","markdown","newsletter-automation","content-creation"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@1.1.0","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"dist":{"shasum":"eae557f4619d3073764b2793b594934a04474bb2","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-1.1.0.tgz","fileCount":88,"integrity":"sha512-GGqBQkQvaZ1YrQ7OsYdXlooFhmLocVPt+3p5nvMUI6WuPCsoFyC8UW47RaxC5TBAFHalluHsSr0oPJtRe17O2w==","signatures":[{"sig":"MEUCIHMO9K8RabKLO9QWGIsV+LCNBVp+EHHhlQsm4XSxad9AAiEAm6q4S+EpgghlTh4N2mjqet6x4DtvFeF1Tr8hcr/Ib3o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":488052},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"a3ff1e1a645946e7d39d363896b7e9158ec5920d","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit -p tsconfig.lint.json","test":"vitest run src/__tests__","build":"tsc","start":"node dist/index.js","version":"npm run sync:release && npm run check:release && git add package-lock.json server.json .codex-plugin/plugin.json .claude-plugin/plugin.json .claude-plugin/marketplace.json .mcp.json","lint:cloud":"wrangler types --config cloud/wrangler.jsonc cloud/worker-configuration.d.ts && tsc -p cloud/tsconfig.json && tsc -p cloud/test/tsconfig.json","test:cloud":"vitest run --config cloud/vitest.config.ts","build:cloud":"wrangler deploy --config cloud/wrangler.jsonc --dry-run","sync:release":"node scripts/sync-release-metadata.mjs","test:package":"npm run build && node scripts/test-package.mjs && node scripts/workflow-demo.mjs","test:release":"node --test scripts/check-release-order.controls.mjs scripts/check-release-metadata.controls.mjs scripts/release-state.controls.mjs scripts/probe-contract.controls.mjs scripts/publish-container.controls.mjs","check:release":"node scripts/check-release-metadata.mjs","prepublishOnly":"npm run check:release && npm run lint && npm test && npm run test:package","probe:contract":"node scripts/probe-contract.mjs --read-only"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^3.24.0","mdast-util-gfm":"3.1.0","mdast-util-to-markdown":"2.1.2","micromark-extension-gfm":"3.0.0","mdast-util-from-markdown":"2.0.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","semver":"^7.8.5","vitest":"^4.1.0","wrangler":"^4.129.0","typescript":"^5.7.0","@types/node":"^22.0.0","@types/mdast":"4.0.4","@cloudflare/vitest-plugin":"^1.1.4"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_1.1.0_1789404609170_0.0003945026521996464","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@conorbronsdon/substack-mcp","version":"1.1.1","keywords":["mcp","substack","newsletter","ai","claude","mcp-server","model-context-protocol","cli","markdown","newsletter-automation","content-creation"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@1.1.1","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"dist":{"shasum":"ad6f687481c3792ac5dcfc1069aadbd42bc7675c","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-1.1.1.tgz","fileCount":88,"integrity":"sha512-XqMIlkqpd+Ah5lutqgeHQq9lCGoX1iRhsXCUwe9rQOsTOywmYkniX5LbyXJh5PWErnkMM4lBqCP3udGp1X35aA==","signatures":[{"sig":"MEQCICvURATb9bNSRUTHM6SvTbvj2iiI2xOvvZQE2uJ0pH3yAiAlRMXRa9ilnrpuJUg3CcvQQKq7BNF/KzTtFKwGtGoaNg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCV9ycJuhbR4mYIxjA13hNM7G2vW6DfiqiutvyOBs4EbgIhAPyDCmmSywl5KbfuAmci+Q/GqqbqI1OO8fmicU2SJ3X6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@1.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":488938},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"924c453a07e7ce5cde8283758485d0e3ed8740a6","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit -p tsconfig.lint.json","test":"vitest run src/__tests__","build":"tsc","start":"node dist/index.js","version":"npm run sync:release && npm run check:release && git add package-lock.json server.json .codex-plugin/plugin.json .claude-plugin/plugin.json .claude-plugin/marketplace.json .mcp.json","lint:cloud":"wrangler types --config cloud/wrangler.jsonc cloud/worker-configuration.d.ts && tsc -p cloud/tsconfig.json && tsc -p cloud/test/tsconfig.json","test:cloud":"vitest run --config cloud/vitest.config.ts","build:cloud":"wrangler deploy --config cloud/wrangler.jsonc --dry-run","sync:release":"node scripts/sync-release-metadata.mjs","test:package":"npm run build && node scripts/test-package.mjs && node scripts/workflow-demo.mjs","test:release":"node --test scripts/check-release-order.controls.mjs scripts/check-release-metadata.controls.mjs scripts/release-state.controls.mjs scripts/probe-contract.controls.mjs scripts/publish-container.controls.mjs","check:release":"node scripts/check-release-metadata.mjs","prepublishOnly":"npm run check:release && npm run lint && npm test && npm run test:package","probe:contract":"node scripts/probe-contract.mjs --read-only"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^3.24.0","mdast-util-gfm":"3.1.0","mdast-util-to-markdown":"2.1.2","micromark-extension-gfm":"3.0.0","mdast-util-from-markdown":"2.0.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","semver":"^7.8.5","vitest":"^4.1.0","wrangler":"^4.129.0","typescript":"^5.7.0","@types/node":"^22.0.0","@types/mdast":"4.0.4","@cloudflare/vitest-plugin":"^1.1.4"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_1.1.1_1789410757720_0.674382164904666","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@conorbronsdon/substack-mcp","version":"1.2.0","keywords":["mcp","substack","newsletter","ai","claude","mcp-server","model-context-protocol","cli","markdown","newsletter-automation","content-creation"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@1.2.0","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"dist":{"shasum":"e315ddc76e186574d7f7e394cb1c332c03a58639","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-1.2.0.tgz","fileCount":98,"integrity":"sha512-BULVKPZRbehfXH8LnbI/f4nqLnRtY2LRaLeIxBgKa/QOwuYnosEJMTnxQn16Tbbbkt4tVH6BIDyuqGf2OrUYig==","signatures":[{"sig":"MEUCIQCzawpKoiQlUxyma9wqRJ8wpYGUEtzs7iuxpl5bf+M8QgIgcl9RRawpPYGQs5vqK5UhFkVsGHjfPSzS2tQCs2zJGMY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCICbriXNmG10Fo58UdlYanVWPDsv4ArH09xyJhlKHvGg/AiEA9x8MPSdEgPK1rbbvBDFr/E4dGNj2XoKj5p7rQVsDjwg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":558034},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"85030e46731b95291ddd5c8c8addca1dfa3c073f","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit -p tsconfig.lint.json","test":"vitest run src/__tests__","build":"tsc","start":"node dist/index.js","version":"npm run sync:release && npm run check:release && git add package-lock.json server.json .codex-plugin/plugin.json .claude-plugin/plugin.json .claude-plugin/marketplace.json .mcp.json","lint:cloud":"wrangler types --config cloud/wrangler.jsonc cloud/worker-configuration.d.ts && tsc -p cloud/tsconfig.json && tsc -p cloud/test/tsconfig.json","test:cloud":"vitest run --config cloud/vitest.config.ts","build:cloud":"wrangler deploy --config cloud/wrangler.jsonc --dry-run","sync:release":"node scripts/sync-release-metadata.mjs","test:package":"npm run build && node scripts/test-package.mjs && node scripts/workflow-demo.mjs","test:release":"node --test scripts/check-release-order.controls.mjs scripts/check-release-metadata.controls.mjs scripts/release-state.controls.mjs scripts/probe-contract.controls.mjs scripts/publish-container.controls.mjs","check:release":"node scripts/check-release-metadata.mjs","prepublishOnly":"npm run check:release && npm run lint && npm test && npm run test:package","probe:contract":"node scripts/probe-contract.mjs --read-only"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^3.24.0","mdast-util-gfm":"3.1.0","mdast-util-to-markdown":"2.1.2","micromark-extension-gfm":"3.0.0","mdast-util-from-markdown":"2.0.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","semver":"^7.8.5","vitest":"^4.1.0","wrangler":"^4.129.0","typescript":"^5.7.0","@types/node":"^22.0.0","@types/mdast":"4.0.4","@cloudflare/vitest-plugin":"^1.1.4"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_1.2.0_1789427414710_0.5470318420429043","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@conorbronsdon/substack-mcp","version":"1.2.1","keywords":["mcp","substack","newsletter","ai","claude","mcp-server","model-context-protocol","cli","markdown","newsletter-automation","content-creation"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@1.2.1","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"dist":{"shasum":"a1d02d1fa4691deb76da2b683c92d0256416ef67","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-1.2.1.tgz","fileCount":98,"integrity":"sha512-8ephjFX8sAofOzMEHllygCd7k+/9iCpvbSD9x9+zCSpmYoQwgOI17dZZTvmpezTuPDq+3XNQvscvDCPgGRDFNQ==","signatures":[{"sig":"MEUCIQCK6rfuFhGx2EOSESgJp16mfIP9GU+ksHrAxjA/6OdK7AIgD6qfjA7gfhldsu+tfTepRdneuXuWR73OaYHu/Z6kyTg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQC0KIiFq7jtoF3ZgUaMKsfwj3uf/3OhC/Q8qaXTPXEvmwIga5J5zSLslLCbcWJbnsqM91tbSupZyUjX1wU2ibJJsVY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@1.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":561414},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"c4582e13f9ed8614bf07d913b3384a2c4b6c9181","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit -p tsconfig.lint.json","test":"vitest run src/__tests__","build":"tsc","start":"node dist/index.js","version":"npm run sync:release && npm run check:release && git add package-lock.json server.json .codex-plugin/plugin.json .claude-plugin/plugin.json .claude-plugin/marketplace.json .mcp.json","lint:cloud":"wrangler types --config cloud/wrangler.jsonc cloud/worker-configuration.d.ts && tsc -p cloud/tsconfig.json && tsc -p cloud/test/tsconfig.json","test:cloud":"vitest run --config cloud/vitest.config.ts","build:cloud":"wrangler deploy --config cloud/wrangler.jsonc --dry-run","sync:release":"node scripts/sync-release-metadata.mjs","test:package":"npm run build && node scripts/test-package.mjs && node scripts/workflow-demo.mjs","test:release":"node --test scripts/check-release-order.controls.mjs scripts/check-release-metadata.controls.mjs scripts/release-state.controls.mjs scripts/probe-contract.controls.mjs scripts/publish-container.controls.mjs","check:release":"node scripts/check-release-metadata.mjs","prepublishOnly":"npm run check:release && npm run lint && npm test && npm run test:package","probe:contract":"node scripts/probe-contract.mjs --read-only"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^3.24.0","mdast-util-gfm":"3.1.0","mdast-util-to-markdown":"2.1.2","micromark-extension-gfm":"3.0.0","mdast-util-from-markdown":"2.0.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","semver":"^7.8.5","vitest":"^4.1.0","wrangler":"^4.129.0","typescript":"^5.7.0","@types/node":"^22.0.0","@types/mdast":"4.0.4","@cloudflare/vitest-plugin":"^1.1.4"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_1.2.1_1789747018501_0.6145882061589656","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@conorbronsdon/substack-mcp","version":"1.3.0","keywords":["mcp","substack","newsletter","ai","claude","mcp-server","model-context-protocol","cli","markdown","newsletter-automation","content-creation"],"author":{"name":"Conor Bronsdon"},"license":"MIT","_id":"@conorbronsdon/substack-mcp@1.3.0","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"dist":{"shasum":"2f28ca038b578e2d7ccbf36ab899c6d38df495a3","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-1.3.0.tgz","fileCount":109,"integrity":"sha512-wKAHgioqUDoVQO5fIBo10MbOUltGLAGBkMnM4s2vmCyCqPKy6twPSec0kId3BIG7enZ6X5OjuJusfytu3STVHA==","signatures":[{"sig":"MEYCIQD2F5zbSYmor3tCg5opinUCBLe6yWHuERlELLgSAF0IDAIhAK587WHtUqmSXrDXaxRELDMTHcUh3oQnfBxPTmYEf38H","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIB7mc70vwyllOQ0E0kqll2AP3rVoDb3EqBMVijkqa0wnAiEAjxRP6c8M1/h3BDpN79ogmLx6i43zdXrKDPCSlp/h5hQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":732365},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"767e89e365359569d1c5d23cd79056ce9f478780","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit -p tsconfig.lint.json","test":"vitest run src/__tests__","build":"tsc","start":"node dist/index.js","version":"npm run sync:release && npm run check:release && git add package-lock.json server.json .codex-plugin/plugin.json .claude-plugin/plugin.json .claude-plugin/marketplace.json .mcp.json","lint:cloud":"wrangler types --config cloud/wrangler.jsonc cloud/worker-configuration.d.ts && tsc -p cloud/tsconfig.json && tsc -p cloud/test/tsconfig.json","test:cloud":"vitest run --config cloud/vitest.config.ts","build:cloud":"wrangler deploy --config cloud/wrangler.jsonc --dry-run","sync:release":"node scripts/sync-release-metadata.mjs","test:package":"npm run build && node scripts/test-package.mjs && node scripts/workflow-demo.mjs","test:release":"node --test scripts/check-release-order.controls.mjs scripts/check-release-metadata.controls.mjs scripts/release-state.controls.mjs scripts/probe-contract.controls.mjs scripts/publish-container.controls.mjs","check:release":"node scripts/check-release-metadata.mjs","prepublishOnly":"npm run check:release && npm run lint && npm test && npm run test:package","probe:contract":"node scripts/probe-contract.mjs --read-only"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ac947915-8e25-4840-9160-2a84f4dbcea8"}},"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"^3.24.0","mdast-util-gfm":"3.1.0","mdast-util-to-markdown":"2.1.2","micromark-extension-gfm":"3.0.0","mdast-util-from-markdown":"2.0.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","semver":"^7.8.5","vitest":"^4.1.0","wrangler":"^4.129.0","typescript":"^5.7.0","@types/node":"^22.0.0","@types/mdast":"4.0.4","@cloudflare/vitest-plugin":"^1.1.4"},"_npmOperationalInternal":{"tmp":"tmp/substack-mcp_1.3.0_1790217270894_0.5484849787241208","host":"s3://npm-registry-packages-npm-production"}},"1.4.0":{"_id":"@conorbronsdon/substack-mcp@1.4.0","bin":{"substack-mcp":"dist/index.js","substack-mcp-login":"dist/login.js"},"bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"dist":{"shasum":"07c5921125fe3b5410d522ebfbe6bc63e8b1c114","tarball":"https://registry.npmjs.org/@conorbronsdon/substack-mcp/-/substack-mcp-1.4.0.tgz","fileCount":131,"integrity":"sha512-FLwh7ThdaKDojGVUGmnJLdueinvnXE0KqtzCReaETjRRH7d3GuI9JnueGsVuLJ29FlomKlmqMa+dfailf4aAPw==","signatures":[{"sig":"MEYCIQDDKvAeWh3ON9xQGkII7JH6TppBBVkbEARha6gW7IYq8AIhALZxh3HnX/dBLkwnlGlTlauU8V01/R+7LFfcDmrVjKni","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBoQazuPFoOhIinrjzdfoJb6+YHqN98OesxwTMsoAfiUAiEAtApYk0/Q0oJ8N73yUrqIElNTowXJ3pJdr0YnkrjO0xU="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@conorbronsdon%2fsubstack-mcp@1.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":949155},"name":"@conorbronsdon/substack-mcp","type":"module","author":{"name":"Conor Bronsdon"},"engines":{"node":">=22.0.0"},"gitHead":"d9cd784e43a1627e6d02a5e26837b53695e93f9f","license":"MIT","mcpName":"io.github.conorbronsdon/substack-mcp","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit -p tsconfig.lint.json","test":"vitest run src/__tests__","build":"tsc","start":"node dist/index.js","version":"npm run sync:release && npm run check:release && git add package-lock.json server.json .codex-plugin/plugin.json .claude-plugin/plugin.json .claude-plugin/marketplace.json .mcp.json","lint:cloud":"wrangler types --config cloud/wrangler.jsonc cloud/worker-configuration.d.ts && tsc -p cloud/tsconfig.json && tsc -p cloud/test/tsconfig.json","test:cloud":"vitest run --config cloud/vitest.config.ts","build:cloud":"wrangler deploy --config cloud/wrangler.jsonc --dry-run","sync:release":"node scripts/sync-release-metadata.mjs","test:package":"npm run build && node scripts/test-package.mjs && node scripts/workflow-demo.mjs","test:release":"node --test scripts/check-release-order.controls.mjs scripts/check-release-metadata.controls.mjs scripts/release-state.controls.mjs scripts/probe-contract.controls.mjs scripts/publish-container.controls.mjs","check:release":"node scripts/check-release-metadata.mjs","prepublishOnly":"npm run check:release && npm run lint && npm test && npm run test:package","probe:contract":"node scripts/probe-contract.mjs --read-only","test:compatibility":"npm run build && node --test scripts/compatibility-smoke.controls.mjs scripts/probe-contract.controls.mjs"},"version":"1.4.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"ac947915-8e25-4840-9160-2a84f4dbcea8"}},"homepage":"https://github.com/conorbronsdon/substack-mcp#readme","keywords":["mcp","substack","newsletter","ai","claude","mcp-server","model-context-protocol","cli","markdown","newsletter-automation","content-creation"],"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"_npmVersion":"11.19.1","description":"Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.","directories":{},"maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"_nodeVersion":"24.22.2","dependencies":{"zod":"^3.24.0","mdast-util-gfm":"3.1.0","mdast-util-to-markdown":"2.1.2","micromark-extension-gfm":"3.0.0","mdast-util-from-markdown":"2.0.3","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","semver":"^7.8.5","vitest":"^4.1.0","wrangler":"^4.151.0","typescript":"^5.7.0","@types/node":"^22.0.0","@types/mdast":"4.0.4","@cloudflare/vitest-plugin":"^1.4.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/substack-mcp_1.4.0_1794934532992_0.37440467249008"}}},"time":{"created":"2026-03-13T06:25:27.375Z","modified":"2026-11-17T16:55:33.449Z","0.2.0":"2026-03-13T06:25:27.586Z","0.2.1":"2026-03-13T07:23:56.395Z","0.2.2":"2026-03-21T07:12:31.591Z","0.3.0":"2026-06-12T05:22:59.994Z","0.4.0":"2026-07-08T08:03:37.036Z","0.5.0":"2026-07-09T22:57:42.019Z","0.6.0":"2026-07-10T19:30:11.630Z","0.6.1":"2026-08-03T08:50:41.988Z","0.6.2":"2026-08-03T09:48:13.732Z","0.7.0":"2026-09-07T18:54:11.876Z","0.8.0":"2026-09-07T19:48:46.959Z","0.9.0":"2026-09-08T03:22:18.544Z","1.0.0":"2026-09-08T07:02:23.231Z","1.1.0":"2026-09-14T16:50:09.322Z","1.1.1":"2026-09-14T18:32:37.812Z","1.2.0":"2026-09-14T23:10:14.791Z","1.2.1":"2026-09-18T15:56:58.595Z","1.3.0":"2026-09-24T02:34:31.009Z","1.4.0":"2026-11-17T16:55:33.093Z"},"bugs":{"url":"https://github.com/conorbronsdon/substack-mcp/issues"},"author":{"name":"Conor Bronsdon"},"license":"MIT","homepage":"https://github.com/conorbronsdon/substack-mcp#readme","keywords":["mcp","substack","newsletter","ai","claude","mcp-server","model-context-protocol","cli","markdown","newsletter-automation","content-creation"],"repository":{"url":"git+https://github.com/conorbronsdon/substack-mcp.git","type":"git"},"description":"Safe creator operations for Substack: rich drafts, Notes, analytics, and consented subscribers. Long-form posts stay draft-only; Notes publish immediately.","maintainers":[{"name":"conorbronsdon","email":"hello@conorbronsdon.com"}],"readme":"<div align=\"center\">\n\n# substack-mcp\n\nCreate and manage your Substack newsletter from your AI assistant or terminal. Prepare rich drafts, search your archive, publish Notes, inspect analytics, and manage explicitly consented free subscribers across publications. Review and publish long-form posts in Substack.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE)\n[![Language: TypeScript](https://img.shields.io/badge/TypeScript-3178c6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)\n[![npm version](https://img.shields.io/npm/v/@conorbronsdon/substack-mcp?style=flat-square)](https://www.npmjs.com/package/@conorbronsdon/substack-mcp)\n[![MCP](https://img.shields.io/badge/MCP-Model_Context_Protocol-1f6feb?style=flat-square)](https://modelcontextprotocol.io/)\n[![HOL Plugin Security Scan](https://github.com/conorbronsdon/substack-mcp/actions/workflows/hol-plugin-scanner.yml/badge.svg)](https://github.com/conorbronsdon/substack-mcp/actions/workflows/hol-plugin-scanner.yml)\n[![Podcast](https://img.shields.io/badge/Podcast-Chain_of_Thought-purple?style=flat-square)](https://chainofthought.show/?utm_source=github&utm_medium=referral&utm_campaign=repo-readme&utm_content=substack-mcp)\n[![X](https://img.shields.io/badge/X-@ConorBronsdon-black?style=flat-square&logo=x)](https://x.com/ConorBronsdon)\n\n</div>\n\n---\n\n![Create, search, export, plan and review a draft with substack-mcp](https://raw.githubusercontent.com/conorbronsdon/substack-mcp/c4602e8bf1987823918eb69268dced96e0d3f317/docs/workflow-demo.gif)\n\nThe 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.\n\n**Draft-only long-form posts; explicit public actions:** This server cannot publish or delete long-form posts. Post tools create and edit drafts only; you review and publish manually through Substack's editor. Public community comments/restacks are separately [experimental and consent-gated](docs/community-writes.md). Substack **Notes** also publish publicly: `create_note` and `create_note_with_link` publish short-form Notes immediately, because Notes have no draft state on Substack. Treat the Note tools as public-publish actions — there is no preview step and no undo from this server. The split is proportionate review, the piece of trust infrastructure for agents this server cares most about: the high-stakes surface gets a human gate, and the exception is stated loudly.\n\nThis server imposes no Bestseller-status check. Use an authenticated account with permission to manage the publication; individual operations depend on your Substack access. Connect through local stdio or self-hosted HTTP.\n\n<a href=\"https://glama.ai/mcp/servers/conorbronsdon/substack-mcp\">\n  <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/conorbronsdon/substack-mcp/badge\" alt=\"substack-mcp MCP server\" />\n</a>\n\nFor 1.0 setup coverage and account eligibility, see [compatibility](docs/compatibility.md). Run `substack-mcp compatibility report` for an offline, shareable diagnostic report; [reporting guide](docs/compatibility-report.md). Maintainers can use the [release checklist](docs/release-checklist.md) and [distribution inventory](docs/distribution.md).\n\n**Contents:** [Quick start](#quick-start) · [Setup](#setup) · [Tools](#tools) · [Operator CLI](docs/operator-cli.md) · [Draft workflow](docs/workflow.md) · [Analytics to draft](docs/analytics-to-draft.md) · [Export](docs/export.md) · [Markdown](docs/authoring.md) · [Multiple publications](#multiple-publications) · [Transports](docs/http-transport.md) · [Compatibility](docs/compatibility.md)\n\n## Quick start\n\n1. **Install and sign in.** Browser login needs the optional Playwright dependency:\n\n   ```bash\n   npm install @conorbronsdon/substack-mcp playwright\n   npx playwright install chromium\n   npx substack-mcp login https://yourblog.substack.com --user-id 12345\n   ```\n\n   Use your own account's user ID ([how to find it](#find-your-account-user-id)). The session is saved only after a bounded\n   authenticated read succeeds. To paste credentials instead, see\n   [Option B](#option-b--get-your-credentials-manually).\n2. **Verify a read.** `npx substack-mcp doctor --json --check-auth` makes one\n   bounded read per publication. It confirms read access, not your user ID or\n   write permission.\n3. **Connect your MCP client.** Add the server to\n   [Claude Desktop or Claude Code](#2-configure-your-mcp-client), or use the\n   [Codex plugin](#codex-plugin). Environment variables take precedence; omit\n   them to use the stored browser-login session. Then ask your assistant:\n   \"How many Substack subscribers do I have?\"\n4. **Prepare a draft for review.** Follow the [draft workflow](docs/workflow.md):\n   `create_draft`, `search_posts`, `export_draft`, `preflight_draft`, then\n   `plan_draft_update` and `update_draft`. Long-form posts stay unpublished\n   drafts until you publish them in Substack's editor. `create_note` and\n   `create_note_with_link` publish immediately.\n\n## Community walkthrough\n\nJonathan 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)\nwalks through using Codex to install the MCP locally, connecting ChatGPT through\nOpenAI's Secure MCP Tunnel, and creating a private draft for manual publication.\nHe used the connection to create the draft of the guide itself.\n\nThe guide documents his September 18, 2026 setup with version 1.2.0. Its reported\n`get_post` 404 is fixed in 1.2.1. Client interfaces and access requirements can\nchange; use the [setup instructions below](#setup) for this package's current\nconfiguration. This is a community walkthrough, not a hosted service provided\nby this project.\n\n## Setup\n\nRequires **Node.js 22 or newer** (CI covers Node 22 and 24). Browser login additionally requires Playwright.\n\nYou can supply credentials two ways: paste them as env vars (below), or run the\noptional **browser login** which captures and stores them for you.\n\n### Option A — Browser login (optional, no manual cookie copying)\n\nInstall the server and optional Playwright dependency together in a local tools\ndirectory, then sign in:\n\n```bash\nnpm install @conorbronsdon/substack-mcp playwright\nnpx playwright install chromium\nnpx substack-mcp login https://yourblog.substack.com --user-id 12345\n```\n\n`substack-mcp-login` remains a supported alias. Missing publication URL and user\nID are prompted. Supply your own account's user ID ([steps below](#find-your-account-user-id)); a post author's byline does\nnot verify your identity. The browser opens for sign-in, including any CAPTCHA.\nLogin then opens `<publication>/publish/home` and waits for the publication\nsession cookie; on custom domains this is `connect.sid` on the custom domain.\nA bounded authenticated read must succeed before saving. The default flow verifies\nread access, not the configured user ID or permission to write.\n\nTo derive your ID from the selected publication's authenticated session instead\nof entering it manually, use:\n\n```bash\nnpx substack-mcp login https://yourblog.substack.com --verify-identity --profile work\n```\n\n`--verify-identity` reads the publication-host `/api/v1/user/profile/self` with\nthat host's cookie, requires a positive safe integer top-level ID, and then\nperforms the existing authenticated draft-list check before saving. Supplying\n`--user-id` as well turns it into an assertion: a mismatch stops without saving\nor replacing a profile, even with `--force`. No public profile, post byline,\nother-host cookie or other-host endpoint is used as a fallback. The verified\nmode's JSON result reports `user_identity: \"verified\"` and\n`identity_source: \"authenticated_publication_self_profile\"`; it prints no ID.\nThis is an observation at login time, not a persisted identity attestation or\nproof of write permission. Ordinary `doctor` continues to report identity as\nunverified.\n\nFor subscriber tools or the calendar opt-in sync, add `--subscriber-access`.\nSubstack asks for a one-time \"Confirm it's you\" code (by email or authenticator\napp) before it allows subscriber reads, and login prompts for it. See\n[docs/subscriber-step-up.md](docs/subscriber-step-up.md).\n\nSelf-profile support on publication hosts has not been live-verified for every\nSubstack/custom-domain configuration. If the endpoint is unavailable, expired,\nredirected or malformed, verified mode fails closed and saves nothing. The\nexisting manually configured-ID flow remains available and explicitly\nunverified. A real browser run is still needed for [#150](https://github.com/conorbronsdon/substack-mcp/issues/150);\nfixture tests are not evidence about the current sign-in UI.\n\nWithout `--profile`, login saves `~/.substack-mcp/session.json` (directory override:\n`SUBSTACK_MCP_HOME`). The server uses this legacy session when publication\ncredential environment variables and `SUBSTACK_PROFILES` are unset.\n\n**Default storage (`SUBSTACK_CREDENTIAL_STORE=file`):** sessions use AES-256-GCM with a key derived from the OS account and\nmachine. File permissions request `0600`; Windows access also depends on directory\nACLs. This is a machine-bound file, not an OS keychain or secret vault. Code\nrunning as your OS user can derive the key. Use environment credentials if your\nMCP client manages secrets for you.\n\n**Optional OS keychain:** set `SUBSTACK_CREDENTIAL_STORE=keychain` in both the\nlogin process and the MCP client's environment. macOS uses Keychain via\n`/usr/bin/security`; Linux needs libsecret and `secret-tool` plus an unlocked Secret\nService; Windows uses Credential Manager through PowerShell's `PasswordVault`. All\nthree are exercised with synthetic credentials by the `keychain` CI workflow on\nGitHub-hosted runners (an unlocked temporary macOS keychain and a gnome-keyring\nsession on Linux); desktop setups with locked keychains may still prompt. Login writes the selected account to the keychain, and the\nserver reads it there. Explicit keychain selection never reads the encrypted\nfile as a fallback. The keychain helps against other OS users, copied disks,\nand some malware limited to file access. Code running as your user can usually\nquery the keychain. Keep the OS account and running code trusted.\nOn Linux, `secret-tool lookup` can exit 1 without an error message for either\nan absent entry or a locked keyring. Named writes without `--force` search and\nunlock first, and refuse overwrites when an entry is found.\n\n#### Named profiles and migration\n\n```bash\nnpx substack-mcp login https://yourblog.substack.com --user-id 12345 --profile work\nnpx substack-mcp profiles list\n# Copy an existing legacy session without changing its file:\nnpx substack-mcp profiles migrate --name personal\n# Copy a file session or named file profile into the keychain; source remains:\nnpx substack-mcp profiles migrate --to keychain\nnpx substack-mcp profiles migrate --to keychain --name work\n```\n\nKeys start with a lowercase ASCII letter and contain only lowercase letters,\ndigits and hyphens, up to 64 characters. Existing profiles require explicit\n`--force` to replace. List output contains keys, readability status, publication origins and file save\ntimes; it excludes cookies and user IDs. Unreadable profiles remain visible but\ncannot be selected. Save time records local persistence, including migration; it\nis not token issuance or expiration time. Listing is bounded to 32 profiles.\n\nProfile storage requires a local filesystem supporting hard links (such as NTFS\nor a typical Linux filesystem), so creation can install a complete encrypted file\nwithout overwriting an existing name. FAT/exFAT and some network mounts are not\nsupported: set `SUBSTACK_MCP_HOME` to a suitable local directory. Do not use\n`--force` to work around an unsupported filesystem.\n\nSet `SUBSTACK_PROFILES=work,personal` in your MCP client's environment to select\nup to 32 distinct profiles. Remove all publication credential variables first:\ncombining profile selection with legacy or named credential variables is an\nerror, including empty variables. Missing, corrupt or invalid selected profiles\nstop startup; they never fall back to another account. Profiles on disk are\nnever activated by discovery. With multiple profiles, tools require an explicit\npublication key and CLI reads require `--publication`.\n\nTo roll back, unset `SUBSTACK_PROFILES` and restore your previous environment\nconfiguration. Migration preserves the legacy session byte-for-byte. These files\nuse the existing encryption format. `profiles list` lists file profiles; select\nkeychain profiles explicitly with `SUBSTACK_PROFILES` after migration or login.\nRun `substack-mcp status --json` for offline configuration diagnostics or\n`substack-mcp doctor --check-auth --json` for a bounded read per selected account.\n\n### Option B — Get your credentials manually\n\nOpen your Substack in a browser, then:\n\n1. **Session token:** For custom domains, open DevTools → Application → Cookies → `https://your-custom-domain` and copy `connect.sid` from the publication's own domain (URL-encoded string starting with `s%3A`). Do not copy `substack.sid` from substack.com: it is a different session that the custom domain's admin API rejects with 403. For `*.substack.com` publications, use `connect.sid` on that host or `substack.sid` on `.substack.com`. The token must match the host of `SUBSTACK_PUBLICATION_URL`, with the `.substack.com` fallback only for Substack-hosted publications.\n2. **User ID:** Follow [Find your account user ID](#find-your-account-user-id). Do not use a publication post's byline ID: publications can have multiple authors. This server does not independently verify the supplied ID.\n3. **Publication URL:** Your Substack URL, including custom domain if you have one (e.g., `https://newsletter.yourdomain.com` or `https://yourblog.substack.com`)\n\n### Find your account user ID\n\n1. In Substack, open **your own account profile** and copy its handle (the part after `@` in `https://substack.com/@your-handle`). A publication URL or another author's profile is not your account handle.\n2. Open `https://substack.com/api/v1/user/your-handle/public_profile` with that handle substituted. Read the top-level numeric `id` in the JSON response; do not use an ID nested under a publication or post byline. This public profile endpoint is also used by this server's anonymous profile lookup.\n3. Confirm that the response's `handle` and name match the account you will sign in with. Supply the top-level `id` to `login --user-id` or `SUBSTACK_USER_ID`. A public profile lookup identifies the handle you entered; the browser-login read check does **not** prove that the cookie belongs to that ID. Recheck the account before any write operation.\n\n### 2. Configure your MCP client\n\n#### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"substack\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@conorbronsdon/substack-mcp\"],\n      \"env\": {\n        \"SUBSTACK_PUBLICATION_URL\": \"https://yourblog.substack.com\",\n        \"SUBSTACK_SESSION_TOKEN\": \"your-session-token\",\n        \"SUBSTACK_USER_ID\": \"your-user-id\"\n      }\n    }\n  }\n}\n```\n\n[Claude Code and Codex plugin setup](docs/plugins.md) is available alongside\nmanual MCP configuration. The repository marketplace and local plugin are\nseparate from curated-directory acceptance or hosted ChatGPT support.\n\n#### Claude Code\n\nAdd to your `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"substack\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@conorbronsdon/substack-mcp\"],\n      \"env\": {\n        \"SUBSTACK_PUBLICATION_URL\": \"https://yourblog.substack.com\",\n        \"SUBSTACK_SESSION_TOKEN\": \"your-session-token\",\n        \"SUBSTACK_USER_ID\": \"your-user-id\"\n      }\n    }\n  }\n}\n```\n\n### 3. Verify\n\nAsk your AI assistant: \"How many Substack subscribers do I have?\"\n\nTool output compatibility, response limits and versioning are documented in\n[the tool contract](docs/tool-contract.md).\n\n### Operator diagnostics\n\nThe CLI exposes operator commands and configuration checks through the same MCP\nhandlers and credential resolution as the server. `drafts create` writes one\nprivate draft and `images upload` returns a publicly fetchable (unlisted) image\nURL for it; the other operator commands read:\n\n```sh\nsubstack-mcp status --json\nsubstack-mcp doctor --json --check-auth\nsubstack-mcp drafts list --limit 10\n```\n\nCommands, the JSON envelope, exit codes, request deadlines and response limits\nare documented in [operator CLI and diagnostics](docs/operator-cli.md).\n\n## Tools\n\nEvery tool declares explicit MCP side-effect annotations; see\n[tool annotations](docs/tool-contract.md#tool-annotations). Tool descriptions carry the\nauthoritative wording.\n\n### Read\n\n| Tool | Description |\n|------|-------------|\n| `get_subscriber_count` | Get your publication's current subscriber count |\n| `list_subscribers` | Read a bounded page of private subscriber records |\n| `search_subscribers` | Filter and page private subscriber records; optional activity, date, flags and revenue fields |\n| `get_subscriber` | Look up membership by exact email; reconcile pending additions |\n| `list_published_posts` | List published posts with pagination |\n| `get_publication` | Read projected publication identity/settings, verify the configured host, and report missing fields; does not verify account identity or role |\n| `list_publication_tags` | Read tag definitions, including hidden tags by default, with bounded local pagination |\n| `get_post_tags` | Resolve post tag associations; preserves unresolved IDs and reports empty-result identity uncertainty. Draft coverage is currently live-verified only for empty responses |\n| `search_posts` | Search a publication archive by query and status; bounded pages with continuation metadata |\n| `plan_draft_update` | Review proposed changes, preflight and a receipt for best-effort stale detection; no writes |\n| `export_draft` | Editable Markdown, exact original body, conversion diagnostics, preflight and editor link |\n| `preflight_draft` | Read-only checks for title, audience, body structure, images, and paywalls, with an editor link; optionally adds Substack's own prepublish errors and suggestions |\n| `list_drafts` | List draft posts |\n| `get_post` | Get full content of a published post by ID |\n| `get_draft` | Get full content of a draft by ID |\n| `get_post_comments` | Get comments on a published post |\n| `get_sections` | List your publication's sections (categories) with their IDs |\n| `get_post_analytics` | Get a published post's stats (views, opens, signups, subscribes, reactions) by ID |\n| `rank_posts` | [Rank posts](docs/analytics-rankings.md) by views, opens, sends, rates, signups, subscribes, estimated value or date, keeping null and missing values distinct |\n| `get_publication_stats` | [Read dashboard summary and ranged publication metrics](docs/analytics-rankings.md), with missing and unavailable states |\n| `get_growth_sources` | [Read bounded growth source attribution](docs/analytics-rankings.md) and optional events |\n| `list_incoming_recommendations` | [List publications that recommend yours](docs/analytics-rankings.md#recommendations), with start date, active state and dashboard-attributed subscribers |\n| `list_outgoing_recommendations` | List whom your publication recommends (can be partial). This is not who recommends it; use `list_incoming_recommendations` for that |\n| `list_outgoing_recommendation_stats` | List subscribers your publication has sent to the publications it recommends |\n| `list_scheduled_posts` | List posts scheduled for future publication (read-only; scheduling stays in Substack's editor) |\n| `get_user_profile` | Read a minimal public user profile by handle, anonymously |\n| `get_profile_feed` | Read one public profile feed page with cursor continuation, anonymously |\n| `get_note_thread` | Read a public Note, ancestors and one replies page, anonymously |\n| `list_public_posts` | Read a bounded public archive page, anonymously |\n| `get_public_post` | Read an anonymous public post by URL with body status and truncation flags |\n\n### Public reading\n\nThese five tools use a separate anonymous reader. It sends only `User-Agent` and\n`Accept`, never the configured publication cookie or other credentials. The\nconfigured publication selects the default archive origin; callers may supply an\nallowlisted HTTPS publication origin. Allowed hosts are `substack.com`, one-label\n`*.substack.com`, configured publication origins, and exact origins in\n`SUBSTACK_PUBLIC_READ_ORIGINS` (comma-separated HTTPS origins without ports,\npaths or userinfo). Redirects are rejected. A `*.substack.com` publication may\nredirect to its custom domain (for example, `lenny.substack.com`); JSON reads do\nnot follow that redirect. Add the custom HTTPS origin to\n`SUBSTACK_PUBLIC_READ_ORIGINS` and read through that origin. With multiple\npublications, the `publication` key remains required for every publication tool.\n\nProfile feed pages are upstream-sized; `has_more: null` means the upstream omitted\ncontinuation metadata. Thread pages can omit replies when `more_branches` or\n`next_cursor` is present; `completeness: \"unknown\"` means continuation metadata\nwas omitted.\nArchive full pages have `has_more: null` because no total is returned. Public\npost `body_status` is a heuristic based on audience and body presence; it does\nnot establish full access. The anonymous reader does not use subscription\nentitlements. Reader subscriptions and inbox are unsupported: the configured\npublication session received 401 on the `substack.com` reader-account routes,\nwhich require a separate reader session this server does not manage.\n\n### Archive search and draft review\n\n`search_posts` accepts `query` (1–500 characters), `status` (`published`, `drafts`,\nor `scheduled`, default `published`), `offset` (default 0), and `limit` (1–50,\ndefault 25). It makes one authenticated archive request and returns projected\nmetadata, `returned`, `total`, `has_more`, and `next_offset`. Continue with\n`next_offset` and the same query/status. When Substack omits the total and a\npage is full, `has_more` is null (unknown); another page may be empty. Substack\ncontrols matching and indexing: this is not a guaranteed full-text scan. Use\n`get_post` or `get_draft` to retrieve full content. Pagination is not a snapshot;\nconcurrent edits can move results between pages.\n\n`preflight_draft` accepts `draft_id`, reads it once, and returns `checks_passed`,\nfindings with severity/code/message, content counts and an editor link. It checks title,\naudience, JSON/body shape, image wrappers and HTTPS sources, and paywall count\nand edge placement. Unknown nodes and external images produce review warnings.\nBodies over two million characters, 10,000 nodes, or depth 100 are not fully\nchecked; `counts.complete` is false and aggregate checks are skipped after a\nscan limit. Unknown-node warnings name up to five types for editor review.\n\nWith `substack_check: true`, it also makes one more read: Substack's own\nprepublish validator (`GET /api/v1/drafts/{id}/prepublish`, the check the editor\nruns before its publish dialog). The result comes back separately as\n`substack_check` with `errors` and `suggestions` (up to 50 each, 300 characters\neach) and never changes `checks_passed` or `findings`. The endpoint is\nundocumented and its response shape is not yet live-verified: any failure or\nunexpected shape returns `substack_check.status: \"unavailable\"` with a reason, and\nthe static checks still return. A clean result is not publish approval.\nThis is a focused static check, not full ProseMirror validation or\npublish approval. It does not fetch links/images, verify access settings, or\nprove final rendering. Review the draft in Substack; no content is modified.\n\nBoth tools require `publication` when multiple publications are configured.\n\n### Write (private drafts; image upload returns a public URL)\n\n| Tool | Description |\n|------|-------------|\n| `create_draft` | Create a new draft from markdown (private) |\n| `update_draft` | Apply a reviewed change receipt; recheck unpublished state and report readback outcomes |\n| `update_draft_tags` | [Plan or change draft tags](docs/draft-tags.md); dry-run by default, draft-only, with one readback after writes |\n| `upload_image` | Upload an image to Substack's CDN from a file, data URI or [public HTTPS URL](docs/remote-images.md) — returns a publicly-fetchable (unlisted) URL |\n\n### Review before changing a draft\n\nIn 0.9, call `plan_draft_update`, review its output, then call `update_draft` with\nthe same fields and returned receipt. Published or known stale drafts are\nrejected. The read/write race remains; check readback outcomes and review in\nSubstack. The CLI shares this flow through `drafts plan` and `drafts apply`.\nSee [draft changes and migration](docs/draft-changes.md) for examples and limits.\n\n### Public community writes (experimental)\n\n| Tool | Description |\n|------|-------------|\n| `create_post_comment` | Comment at a configured publication; preview by default, **publishes immediately** when live |\n| `restack` | Restack a post or Note as a separate reader account; preview by default, **publishes immediately** when live |\n\nLive attempts require `SUBSTACK_EXPERIMENTAL_COMMUNITY_WRITES=1`,\n`dry_run=false`, `confirm_publish=true` and explicit approval of the exact\naccount, target and text. Restacks additionally need a separate reader session.\nBoth tools check the authenticated identity before writing, attempt one POST,\nand report bounded readback outcomes without automatic retries. The endpoints\nhave source evidence; live verification remains pending. See\n[setup, credential routing, consent and limitations](docs/community-writes.md).\n\n### Publish (Notes — public immediately)\n\n| Tool | Description |\n|------|-------------|\n| `create_note` | Publish a Substack Note (short-form, **publishes immediately**) |\n| `create_note_with_link` | Publish a Note with a link card attachment (**publishes immediately**) |\n\nNotes have no draft state on Substack, so there is no draft-first option for these two tools.\n\n### Subscriber management\n\n`add_free_subscriber` adds one consenting reader to the free newsletter. It is\na distribution change: that reader may receive future newsletter emails. It\ncan request a welcome email with `send_welcome_email: true` (off by default).\nIt never grants paid access or overrides Substack's\nsuppression of previously unsubscribed addresses. Its MCP annotations identify\nit as an external write (`readOnlyHint: false`, `openWorldHint: true`).\n\n```json\n{\"email\":\"reader@example.org\",\"consent_confirmed\":true,\"consent_evidence\":{\"source\":\"booking:message-id\",\"recorded_at\":\"2026-09-01T00:00:00Z\"},\"dry_run\":true}\n```\n\nDry-run is the default. After checking actual newsletter consent, set\n`dry_run: false` to execute. Live adds require the source reference and timestamp\nin `consent_evidence`; this attestation is echoed with the publication key for\nauditing and does not replace checking the underlying consent record.\nMulti-publication configurations also require the\n`publication` selector, just like every other tool.\n\nResults distinguish `existing`, `dry_run`, `verified`, `blocked`, and\n`unverified`, `busy`, and `retryable`. `busy` performs no write; wait for the\nother operation. `retryable` means authentication or rate limiting refused the\nrequest; resolve that condition before explicitly retrying. An empty API acknowledgement is **not** proof of addition.\n`verified` means an exact membership lookup succeeded after the request; it\ndoes not prove that this request originally created the membership. Dashboard\ndata can lag. A missing reader may also have previously unsubscribed.\n\nFor `unverified`, recheck with `get_subscriber`; never automatically repeat the\nadd. For `blocked`, review in Substack without bypassing suppression. Automated\ncallers must persist an attempt ledger **before** sending each live request.\nThe client's in-memory duplicate guard does not survive restarts or separate\nHTTP sessions. Keep subscriber identities and consent evidence out of shared\nrepositories, prompts to unapproved public services, and routine logs.\n\nImplementation and live verification notes: [subscriber API](docs/subscribers.md).\n\nFor Google Calendar booking opt-ins, the [calendar sync helper](docs/calendar-sync.md)\nprovides a bounded Gmail scan, latest-answer selection, a private durable attempt\nledger, and read-only reconciliation after uncertain writes. Scheduling is an\nexplicit local setup step; installing the MCP does not start a background job.\n\n### Prompts and resources\n\nClients that support MCP prompts (often shown as slash commands) get four\nworkflows. Each one only tells the model which existing tools to chain, so a\nprompt adds no endpoint, write path or permission:\n\n| Prompt | What it does |\n|--------|--------------|\n| `review_draft` | `export_draft`, then `preflight_draft` with `substack_check`; reports static findings, Substack's own findings and an editorial read separately. Edits go through `plan_draft_update` and `update_draft` only after you approve |\n| `what_worked` | Unfiltered archive `rank_posts` by subscribes/open rate in both directions, separately from `get_publication_stats` and `get_growth_sources` over a window (default 90 days), with sources and missing values kept explicit |\n| `draft_from_idea` | Checks past posts and drafts with `search_posts`, proposes an outline, and after approval creates a private draft and preflights it |\n| `plan_notes` | Proposes Notes that resurface recent posts as text only. It never calls `create_note`: Notes publish immediately, so you post each approved one yourself |\n\nWith several publications configured, each prompt takes a required `publication`\nargument, matching the tools.\n\nThe `substack://publications` resource lists the configured publications (key,\nlabel, origin) from local configuration, so a client can load them without a\ntool call. It makes no request and contains no credentials.\n\n### Intentionally excluded\n\n- **Publish posts** — Publishing long-form posts should be a deliberate human action (Notes are the documented exception above)\n- **Delete** — Too destructive for an AI tool\n- **Schedule** — Use Substack's editor for scheduling. (`list_scheduled_posts` *reads* what you've queued there, but this server never creates, edits, or cancels a schedule.)\n\nFor an always-on scheduler with durable cloud state and weekly email reports, see [Cloud Calendar sync](docs/cloud-calendar-sync.md).\n\n## Multiple publications\n\nRunning more than one publication behind a single server? Set a `SUBSTACK_PUB_<KEY>_*` triplet per publication instead of the plain `SUBSTACK_*` vars. `<KEY>` is any name you choose (letters, digits, underscores) — it becomes the publication's lowercase, hyphenated key, e.g. `KEVIN_MULDOON` → `kevin-muldoon`.\n\n```json\n\"env\": {\n  \"SUBSTACK_PUB_KEVIN_MULDOON_PUBLICATION_URL\": \"https://kevinmuldoon.substack.com\",\n  \"SUBSTACK_PUB_KEVIN_MULDOON_SESSION_TOKEN\": \"token-1\",\n  \"SUBSTACK_PUB_KEVIN_MULDOON_USER_ID\": \"111\",\n  \"SUBSTACK_PUB_SAPERE_PUBLICATION_URL\": \"https://sapere.substack.com\",\n  \"SUBSTACK_PUB_SAPERE_SESSION_TOKEN\": \"token-2\",\n  \"SUBSTACK_PUB_SAPERE_USER_ID\": \"222\"\n}\n```\n\nEach triplet is independent, and setting *any* `SUBSTACK_PUB_<KEY>_*` variable declares that publication. An incomplete triplet — a missing variable, an empty value, or a whitespace-only value — fails startup with an error naming the key, rather than silently dropping that publication. That matters because a dropped publication is not \"one fewer publication\": drop the only one and the server falls back to your stored browser-login session; drop one of two and every tool loses its `publication` parameter, so a call meant for the dropped publication routes silently to the surviving one.\n\nKeys are compared case-insensitively, with `_` folded to `-`. Two names that resolve to the same key (`SUBSTACK_PUB_ALPHA_*` and `SUBSTACK_PUB_Alpha_*`) are a startup error too — merging them silently would let one publication's URL pair with another's session token.\n\n`<KEY>` accepts ASCII letters, digits, and underscores; the three suffixes must be uppercase and the whole name must have no stray whitespace. Anything that begins with `SUBSTACK_PUB_` but does not fit that shape — a hyphen in the key, a lowercase suffix, an accented character, a trailing space — is a startup error naming the variable, not a variable that gets quietly ignored. For the same reason as above: an ignored publication is not one fewer publication, it is a silent reroute to a different one.\n\nWith two or more publications configured, every publication tool gains a **required** `publication` parameter — one of your configured keys (e.g. `kevin-muldoon`, `sapere` above). The calling model must specify one on every publication call; an unrecognized value is rejected before any Substack API call is made, so a stray write can't land on the wrong publication. **With exactly one publication configured** — the common case, whether via plain `SUBSTACK_*` vars or a single `SUBSTACK_PUB_<KEY>_*` triplet — **no `publication` parameter is added at all**; every tool's schema is unchanged from single-publication mode.\n\nDon't mix the two styles: if any `SUBSTACK_PUB_<KEY>_*` var is set, the plain `SUBSTACK_*` vars are ignored (with a startup warning) rather than treated as an unnamed extra publication.\n\nThe account-wide `restack` tool uses an explicit reader `account_user_id` instead of a `publication` parameter. Its reader credential is configured separately; it never uses a publication session.\n\n`SUBSTACK_USER_AGENT` and `SUBSTACK_REQUEST_TIMEOUT_MS` apply to every configured publication — they are not per-publication. Browser login also supports explicit named profiles; see [Named profiles and migration](#named-profiles-and-migration).\n\n## Token expiration\n\nSubstack session tokens expire periodically (typically ~90 days). If you get authentication errors, re-run `substack-mcp login` to refresh the stored session, or copy a fresh cookie from DevTools on the matching publication host and update the env var. Custom domains require their own `connect.sid`, not substack.com's different `substack.sid` session (which the custom domain rejects with 403). For `*.substack.com` publications, use `connect.sid` on that host or `substack.sid` on `.substack.com`. Then run `substack-mcp doctor --check-auth` to verify access.\n\n## Custom domains & Cloudflare\n\nThis section covers authenticated creator API calls. Anonymous public reading\nuses the [public reading](#public-reading) origin rules above.\n\nSubstack publications served on a custom domain (e.g. `blog.example.com`) sit behind Cloudflare, which can reject non-browser requests with `403 error code: 1010`. To avoid this, the server sends a browser `User-Agent` and a `Referer` by default, and uses the configured publication URL.\n\n- **Match the host and cookie.** If using the canonical `*.substack.com` URL, use its host session or the `.substack.com` fallback. A custom-domain `connect.sid` pairs with the custom-domain `SUBSTACK_PUBLICATION_URL`.\n- **Override the User-Agent** (optional) via `SUBSTACK_USER_AGENT` if you need a different browser signature:\n\n```json\n\"env\": {\n  \"SUBSTACK_PUBLICATION_URL\": \"https://yourblog.substack.com\",\n  \"SUBSTACK_SESSION_TOKEN\": \"your-session-token\",\n  \"SUBSTACK_USER_ID\": \"your-user-id\",\n  \"SUBSTACK_USER_AGENT\": \"Mozilla/5.0 ...\"\n}\n```\n\n## Request timeout\n\nEvery request to Substack is bounded by a 30-second deadline. Node applies no request timeout of its own — only a 10-second *connect* timeout — so a host that accepts the connection and then goes silent (a proxy that drops packets rather than refusing them) would otherwise hang a tool call indefinitely. A request that hits the deadline fails with a `TimeoutError` naming the endpoint and the limit.\n\nRaise or lower it with `SUBSTACK_REQUEST_TIMEOUT_MS` (milliseconds; a non-numeric or non-positive value is ignored with a warning and the default is used):\n\n```json\n\"env\": {\n  \"SUBSTACK_REQUEST_TIMEOUT_MS\": \"60000\"\n}\n```\n\n## Transports\n\nBy default the server speaks MCP over **stdio**, which the client configurations\nabove assume. Set `MCP_TRANSPORT=http` for a stateless Streamable HTTP server\n(`POST /mcp`, `GET /health`) in a persistent, self-hosted deployment. Setup,\nlistener variables and the security model are in [HTTP transport](docs/http-transport.md).\n\n### What this listener will accept\n\nThe HTTP listener starts closed: loopback `Host` and `Origin` allowlists by\ndefault, an optional bearer token (`MCP_HTTP_TOKEN`) and a 10 MiB body cap. Host\nand Origin checks are not authentication; set a token wherever other processes\ncan reach the port. See the [listener policy](docs/http-transport.md#what-this-listener-will-accept).\n\n\nVersioned GHCR images and transport verification: [container distribution](docs/containers.md).\n\n## Typed errors\n\nAPI failures map to typed errors (`AuthenticationError`, `RateLimitError`,\n`ValidationError`, `NotFoundError`, `ServerError`, `TimeoutError`, and the base\n`SubstackAPIError`). The status mapping and error-body parsing are documented in\n[typed errors](docs/errors.md).\n\n## Draft export\n\nUse `export_draft` for a read-only Markdown/JSON bundle, or run:\n\n```sh\nsubstack-mcp export 42 --output draft-export.json\nsubstack-mcp export 42 --format markdown --output draft.md\n```\n\nMarkdown exports retain the exact original body in a `.source.json` sidecar.\nInspect `unsupported_nodes` before reuse. Existing files require `--force`.\nSee [export and CLI behavior](docs/export.md) for publication selection, limits,\npartial exports and file recovery.\n\n## Markdown support\n\nDrafts accept CommonMark/GFM Markdown: headings, nested bold/italic/strikethrough,\nlinks and reference links, images with captions and linked destinations, nested\nlists with starting numbers, code, blockquotes, rules and hard breaks. A standalone\n`<!-- paywall -->` block adds one paywall to a long-form draft.\n\nUnsupported content returns `unsupported_nodes` before a write. After reviewing\nthose diagnostics, draft callers can explicitly set `allow_unsupported: true`\nto retain literal fallbacks. Tables remain Markdown inside code blocks; native\ntables, callouts and arbitrary embeds are not advertised as supported. Footnotes\nin top-level paragraphs map to the editor's native footnotes in long-form drafts.\nNotes reject unsupported conversion before either publication or attachment\ncreation and have no fallback override.\n\nSee [Markdown authoring](docs/authoring.md) for mappings, limits, compatibility\nchanges and the distinction between offline fixtures and live editor checks.\n\n## Important notes\n\n- This server uses Substack's **unofficial API**. It may break if Substack changes their endpoints.\n- Session tokens are sent as cookies. Keep your `SUBSTACK_SESSION_TOKEN` secure.\n- The server checks your credentials on startup, *after* the MCP handshake completes, and only warns — it never blocks startup on a network call. Tools still error individually if the token is expired, which is where the failure is actionable.\n- `SIGTERM` and `SIGINT` are handled: the server closes its transport and exits 0, so `docker stop` returns promptly instead of waiting out the grace period.\n\n## Development\n\nFor opt-in live read checks, see [live contract evidence](docs/live-contract-evidence.md).\nThe probe is disabled in ordinary CI and never publishes or writes.\n\nBefore releasing, run `npm run test:package`. It installs the built tarball with production dependencies in a clean temporary directory, checks both executable entrypoints, and verifies the MCP version and the complete registered tool catalog without real credentials.\n\n```bash\ngit clone https://github.com/conorbronsdon/substack-mcp.git\ncd substack-mcp\nnpm install\nnpm run build\n```\n\nRun locally:\n```bash\nSUBSTACK_PUBLICATION_URL=https://yourblog.substack.com \\\nSUBSTACK_SESSION_TOKEN=your-token \\\nSUBSTACK_USER_ID=your-id \\\nnpm start\n```\n\n## Contributing\n\nIssues and pull requests are welcome. Because this server uses Substack's unofficial API, the most useful contributions are fixes when an endpoint changes. If a tool stops working, open an issue with the tool name and the error. The safe-by-design boundary stays: no publish, no delete, no schedule for long-form posts. Notes publish immediately by design and must keep saying so loudly in their descriptions.\n\n## About\n\nBuilt and maintained by [Conor Bronsdon](https://github.com/conorbronsdon) for the [Chain of Thought](https://chainofthought.show/?utm_source=github&utm_medium=referral&utm_campaign=repo-readme&utm_content=substack-mcp) podcast production workflow, where it drafts and reviews newsletter posts before a human hits publish. Conor hosts Chain of Thought, a show about AI infrastructure and how practitioners actually build with it. More tools for creators live in [ai-tools-for-creators](https://github.com/conorbronsdon/ai-tools-for-creators). Find Conor on X at [@ConorBronsdon](https://x.com/ConorBronsdon).\n\n**Companion tools:**\n- [Transistor MCP](https://mcp.transistor.fm): Transistor.fm's official MCP server. Episodes, publishing, and analytics.\n- [podcastindex-mcp](https://github.com/conorbronsdon/podcastindex-mcp): search the Podcast Index and track guest appearances\n- [op3-mcp](https://github.com/conorbronsdon/op3-mcp): report downloads, listener geography, and apps from OP3\n- [apple-podcasts-mcp](https://github.com/conorbronsdon/apple-podcasts-mcp): pull plays, followers, and per-episode listening from Apple Podcasts Connect\n- [gsc-mcp](https://github.com/conorbronsdon/gsc-mcp): query search performance, keywords, and sitemaps in Google Search Console\n- [podcast-benchmark](https://github.com/conorbronsdon/podcast-benchmark): benchmark a show against its peers using only public data\n\n---\n\n## Disclaimer\n\n*This is an independent personal project, not affiliated with, sponsored by, or endorsed by any company. All views expressed are my own.*\n\n## Codex plugin\n\nThe repository includes a Codex manifest at `.codex-plugin/plugin.json` and an\nMCP configuration at `.mcp.json`. It runs the published npm package over stdio\nusing `npx`; Node.js and npm must be available. The package version is pinned\nin `.mcp.json`, so upgrading the plugin's server is an explicit change.\n\nConfigure your Substack credentials outside the plugin using the environment\nvariables or browser-login session described above. Never commit a session\ntoken. Installation does not authenticate an account or grant approval to post.\nLong-form posts remain drafts; Notes publish immediately.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}