FastMCP server for Substack — publish Notes and posts, pull analytics, manage dr MCP server

substack-mcp

<!-- mycelium-badges:start -->

<!-- mycelium-badges:end -->

FastMCP server for Substack: publish Notes and posts, pull analytics, manage drafts, bridge Obsidian vault drafts to Substack, and generate visual cards with pluggable image generators.

Quick reference

substack__test_connection             -- verify auth (start here)
substack__publish_note text=...       -- publish a Note immediately
substack__list_vault_drafts           -- show drafts from your vault file
substack__publish_vault_draft index=N -- publish one vault draft as a Note
substack__create_draft title=... body=... -- create a post draft
substack__get_dashboard days=30       -- subscriber + view KPIs
substack__capture_analytics_to_vault  -- snapshot analytics to vault markdown

Tool inventory (30)

Notes + vault pipeline

• test_connection(publication?) -- verify auth, return your profile
• list_publications() -- show configured publications and which is default
• publishnote(text, publication?, attachmentids?) -- publish a Note immediately; markdown supported
• createnoteattachment(imagepath?, imageurl?, linkurl?, publication?) -- upload image or register link; returns attachment UUID for use with publishnote
• listmynotes(limit?, publication?) -- your recent Notes with reaction + comment counts
• replytonote(note_id, text, publication?) -- reply to a Note by ID
• listvaultdrafts() -- parse vault drafts file, return index + preview for each draft
• publishvaultdraft(index, publication?, movetopublished?) -- publish one vault draft as a Note
• batchpublishvault_drafts(indices, publication?) -- publish multiple vault drafts in sequence

Post management

Shortened. The full README is on GitHub.