Skip to content
gdr203Public

About

MCP server for Substack with Streamable HTTP transport. 27 tools: drafts, publish, subscribers, analytics, Notes, comments, reader. Deployed on Vercel.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

24 Commits

Folders and files

Repository files navigation

Substack MCP

MCP server for Substack with Streamable HTTP transport, deployed on Vercel.

27 tools: drafts, publish, subscribers, analytics, tags, comments, Notes, reader feed, and more.

Deploy

Deploy with Vercel

Or import at vercel.com/new and set these env vars:

Variable Description
SUBSTACK_PUBLICATION_URL e.g. https://yourname.substack.com
SUBSTACK_SESSION_TOKEN Your substack.sid cookie from browser devtools
SUBSTACK_USER_ID Your numeric Substack user ID

MCP endpoint

POST https://your-domain.vercel.app/mcp

Streamable HTTP transport, no client auth required (credentials live server-side in env vars).

Tools

Tool Description
create_draft_post Create a draft from title, subtitle and plain-text body
set_post_body Replace a draft's body with structured content
update_draft Change title, subtitle and 9 Post settings
get_draft Read one draft in full
list_posts List drafts, published or scheduled posts
publish_draft Publish a draft, with email control
delete_draft Delete an unpublished draft
upload_image Re-host an image on Substack's CDN
list_subscribers List and filter subscribers (48 columns, 18 operators)
export_subscribers Export subscribers with engagement metrics
get_publication Read publication settings
get_user_profile Read your account and publications
get_publication_stats Headline stats
get_post_stats Rank posts by 43 per-post metrics
get_analytics 16 publication-level reports
list_publication_tags List tags
get_post_tags Tags on one post
add_tag_to_post Tag a post
get_post_comments Read comments
comment_on_post Post a comment
list_subscriptions What you subscribe to
list_reader_posts Your inbox
get_reader_post Read any post in full
get_reader_feed Notes feed
get_profile_feed One account's published Notes and posts
get_comment_thread A Note and its replies
restack_item Restack a Note

Credits

All 27 tools and the Substack API layer are from marcomoauro/substack-mcp (MIT). This repo rewires the transport from stdio to Streamable HTTP for Vercel deployment.

License

MIT

About

MCP server for Substack with Streamable HTTP transport. 27 tools: drafts, publish, subscribers, analytics, Notes, comments, reader. Deployed on Vercel.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages