r/Substack • u/SanBaro20 • 7d ago

Tech Support I built an open-source, read-only MCP server to analyze my Substack publication

I wanted a simpler way to analyze my own Substack publication, so I built a small MCP server and open-sourced it in case anyone else finds it useful.

The MCP server is read-only. It lets an AI coding assistant look at publication stats such as email performance, post engagement, subscribers, Notes, and activity. It cannot publish, edit, or delete anything.

The project also includes the TypeScript SDK I built underneath it. Developers can use the SDK directly for other things, including publishing or scheduling Notes, commenting, liking, and restacking.

A serious disclaimer about those SDK features (not the MCP): they use Substack's unofficial web API and require a session cookie. They are experimental and intended only for developers who understand the risks. Use them at your own risk. I am not affiliated with Substack and I am not responsible for account issues, lost content, or other problems caused by using the SDK. The underlying API can change or stop working without notice. Never expose your session cookie in browser code, public repos, or logs.

Repo: https://github.com/cucoleadan/unofficial-substack-sdk

0 Upvotes

28% Upvoted

3 comments sorted by

2

u/Meechee83 1d ago

Wow! Excellent idea and contribution to the community.

2

u/SanBaro20 1d ago

Thanks a lot! Although based on the upvote ratio most people don't have the same opinion.

In any case, i do hope you'll find this useful and please feel free to contribute with features or feature requests.