Skip to content

v1.0.0 — First public release of Substak‑MCP

Latest
Latest

Choose a tag to compare

View all tags
@IgnazioDS IgnazioDS released this 27 May 15:51
· 11 commits to main since this release
v1.0.0
e45a911
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

🎉 First public release of Substak‑MCP

Substak‑MCP is an open‑source Model Context Protocol (MCP) server for Substack. It lets AI clients such as Claude Desktop, Claude Code, Cursor, Codex, Windsurf, and Antigravity draft, publish, schedule, analyze, and research Substack publications from natural‑language prompts.

If this project saves you time, please consider sponsoring its development. ❤️

✨ Highlights

  • Full publishing workflow: create, update, publish, schedule, preview, duplicate, and analyze posts.
  • Public Substack research: RSS feeds, integration options, profile lookup, topic research, post / publication analysis, study plans, coding‑lesson extraction.
  • Content strategy: post analysis, idea generation, repurposing, gap analysis, title/hook optimization, series planning.
  • Safety first: confirmation‑token flow for high‑risk write actions (create_formatted_post, update_post, publish_post, schedule_post, duplicate_post, delete_draft).
  • Encrypted local browser session storage under ~/.substack-mcp-plus/.
  • Works with any MCP client that supports a stdio server definition.

📦 Install

npm install -g github:IgnazioDS/Substak-MCP
substack-mcp-plus-setup

Then point your MCP client at the substack-mcp-plus command. See the README for full setup, client config, and example prompts.

🔧 Requirements

  • Node.js ≥ 16
  • Python ≥ 3.10
  • A Substack publication URL such as https://yourpublication.substack.com

🛠️ Tools included

Publishing & account: create_formatted_post, update_post, publish_post, schedule_post, list_drafts, list_published, list_scheduled_posts, get_post_content, get_post_analytics, duplicate_post, preview_draft, upload_image, delete_draft, get_sections, get_subscriber_count.

Developer & public research: get_publication_rss_feed, get_substack_integration_options, search_substack_profiles_by_linkedin, research_substack, research_substack_post, research_substack_publication, study_topic_on_substack, extract_coding_lessons.

Strategy: analyze_my_posts, generate_post_ideas, repurpose_post, content_gap_analysis, title_and_hook_optimizer, series_planner.

📝 Notes

This project is unofficial and is not affiliated with Substack Inc. See the README’s Known Limitations section for an honest list of current edge cases.

💖 Sponsor & support

Thanks for trying Substak‑MCP! Feedback and contributions are very welcome.

Assets 2
Loading