FastMCP server for Substack — publish Notes and posts, pull analytics, manage dr
A full-featured Substack client that wraps 30 operations into MCP tools. You can publish Notes directly or batch-publish drafts from an Obsidian vault file, create and schedule posts, pull dashboard KPIs and post-level analytics, and snapshot metrics to markdown. Auth uses your browser session cookie since Substack has no public API. The vault integration parses sections from a markdown file and optionally moves published drafts to an archive section with timestamps. Ships with a local Pillow card renderer and a Canva adapter that generates playbooks for the Canva MCP. Built with FastMCP, uses stdio transport. Useful if you're managing a Substack publication programmatically or bridging your note-taking workflow to published content.
- GitHub stars
- 1
- tools
- 30
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- May 20, 2026
Tools
30 toolsPublic tool metadata for what this MCP can expose to an agent.
test_connectionverify auth, return your profile
verify auth, return your profile
No parameter schema in public metadata yet.
list_publicationsshow configured publications and which is default
show configured publications and which is default
No parameter schema in public metadata yet.
publish_notepublish a Note immediately; markdown supported
publish a Note immediately; markdown supported
No parameter schema in public metadata yet.
create_note_attachmentupload image or register link; returns attachment UUID for use with publish_note
upload image or register link; returns attachment UUID for use with publish_note
No parameter schema in public metadata yet.
list_my_notesyour recent Notes with reaction + comment counts
your recent Notes with reaction + comment counts
No parameter schema in public metadata yet.
reply_to_notereply to a Note by ID
reply to a Note by ID
No parameter schema in public metadata yet.
list_vault_draftsparse vault drafts file, return index + preview for each draft
parse vault drafts file, return index + preview for each draft
No parameter schema in public metadata yet.
publish_vault_draftpublish one vault draft as a Note
publish one vault draft as a Note
No parameter schema in public metadata yet.
batch_publish_vault_draftspublish multiple vault drafts in sequence
publish multiple vault drafts in sequence
No parameter schema in public metadata yet.
create_draftcreate a post draft; body is markdown
create a post draft; body is markdown
No parameter schema in public metadata yet.
update_draftedit an existing draft
edit an existing draft
No parameter schema in public metadata yet.
publish_postpublish a draft live to subscribers
publish a draft live to subscribers
No parameter schema in public metadata yet.
schedule_postschedule a draft for future publication (ISO 8601)
schedule a draft for future publication (ISO 8601)
No parameter schema in public metadata yet.
list_sectionslist configured sections for a publication; required to publish on publications with sections
list configured sections for a publication; required to publish on publications with sections
No parameter schema in public metadata yet.
list_draftslist unpublished drafts
list unpublished drafts
No parameter schema in public metadata yet.
list_publishedlist published posts with basic stats
list published posts with basic stats
No parameter schema in public metadata yet.
get_postget full post by slug or numeric ID
get full post by slug or numeric ID
No parameter schema in public metadata yet.
upload_imageupload an image to Substack CDN; returns CDN URL
upload an image to Substack CDN; returns CDN URL
No parameter schema in public metadata yet.
reactheart a post
heart a post
No parameter schema in public metadata yet.
restackrestack a post
restack a post
No parameter schema in public metadata yet.
commentcomment on a post
comment on a post
No parameter schema in public metadata yet.
get_feedyour reader feed (posts from publications you follow)
your reader feed (posts from publications you follow)
No parameter schema in public metadata yet.
get_dashboardKPIs: total/paid subscribers, views, growth, ARR
KPIs: total/paid subscribers, views, growth, ARR
No parameter schema in public metadata yet.
get_post_statsviews, opens, clicks, shares, conversions for one post
views, opens, clicks, shares, conversions for one post
No parameter schema in public metadata yet.
get_subscriber_growthsubscriber count over time
subscriber count over time
No parameter schema in public metadata yet.
get_growth_sourcessubscriber growth by source (search, recommendations, direct, social)
subscriber growth by source (search, recommendations, direct, social)
No parameter schema in public metadata yet.
get_top_postsposts ranked by engagement
posts ranked by engagement
No parameter schema in public metadata yet.
get_earningsrevenue data for paid publications
revenue data for paid publications
No parameter schema in public metadata yet.
get_recommendation_statsrecommendation network performance
recommendation network performance
No parameter schema in public metadata yet.
capture_analytics_to_vaultwrite a weekly analytics snapshot to your vault
write a weekly analytics snapshot to your vault
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
SUBSTACK_SID_COOKIE*secretAuth cookie extracted via browser dev tools
Readme
Details
- Repository
- github.com/adelaidasofia/substack-mcp
- Category
- Monitoring & Observability
- Package
https://github.com/adelaidasofia/substack-mcp/releases/download/v0.1.0/substack-mcp.mcpb- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
More from adelaidasofia
- macOS-only MCP server that exposes iMessage chat1
- Multi-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, token1
- WhatsApp MCP
- Multi-workspace Slack MCP server with draft+confirm safety, vault auto-export, a1
- FastMCP seed raise pipeline tracker — syncs from Obsidian CRM, generates meeting
- FastMCP server for Obsidian wikilink suggestions from a pre-computed knowledge g
- Local-first personal finance MCP
- lu
- One MCP, many parsers
- Self-hosted GitHub MCP server
- FastMCP server for bidirectional sync between personal and team Obsidian vaults
- FastMCP server that pages on-call via 100+ notification channels (Apprise wrappe
- MCP server for RescueTime productivity data
- Linear MCP (multi-workspace, PAT auth)
- FastMCP server for surgical queries against a vault knowledge graph (NetworkX no2
- FastMCP server for Apollo1
Related Monitoring & Observability MCP servers
View all
AnomalyArmoranomalyarmor/agentsData observability tools for engineering teams: alerts, freshness, schema drift, lineage, quality.0stars
Atlasatlasdevhq/atlasAtlas is a YAML-defined semantic layer for analytics — authored by humans, consumed by AI agents.1stars
Cognos Session Memorybase76-research-lab/cognos-session-memoryCognOS trust scoring (C=p·(1-Ue-Ua)) and session trace storage as MCP tools.1stars
Queryshieldbch1212/queryshieldSecure SQL proxy for AI agents — NL→SQL, AST safety, per-agent RLS, audit log.1stars
Mcp Serverffmpeg-micro/ffmpeg-micro-mcpMCP server for the FFmpeg Micro video transcoding API — create, monitor, download transcodes.1stars
Shopify Mcp Proden-indance/shopify-mcp-proShopify MCP server with real analytics (ShopifyQL), auto-refresh auth, and Shopify API 2026-04.1stars