Substack MCP Server

更新是部分更新：只更改传入的字段，正文保持不变。

输入：

• draft_id（数字）：由 list_posts 或 create_draft_post 返回的 ID
• draft_title（字符串，可选）
• draft_subtitle（字符串，可选）
• audience（everyone | only_paid | only_free | founding，可选）
• write_comment_permissions（everyone | subscribers | only_paid | none，可选）：允许哪些人发表评论
• default_comment_sort（best_first | most_recent_first | oldest_first，可选）
• cover_image（字符串，可选）：社交预览图片。若 URL 已位于 substack-post-media.s3.amazonaws.com 或 substackcdn.com，则直接使用；否则会先下载并重新托管到 Substack，遵循与 upload_image 相同的限制
• social_title（字符串，可选）：文章在其他地方分享时使用的标题
• description（字符串，可选）：社交预览描述——不是副标题
• search_engine_title（字符串，可选）
• search_engine_description（字符串，可选）
• slug（字符串，可选）：文章的 URL 别名

返回：{draft_id, updated_fields, draft_title, draft_subtitle, audience, is_published, cover_image, cover_image_rehosted_from}。 如果没有要更改的字段，调用会被拒绝，而不是作为空操作发送。cover_image 是最终实际使用的 URL；如果图片经过重新托管，它就会与传入的 URL 不同。

输入：

• draft_id（数字）：由 list_posts 或 create_draft_post 返回的 ID
• send（布尔值，可选）：是否通过电子邮件向订阅者发送文章。默认为 false，与 Substack API 自身的默认值不同——无论如何，文章都会在网站上发布，但电子邮件无法撤回，因此必须明确请求发送。

返回：{status, draft_id, post_id, title, slug, canonical_url, emailed, email_sent_at}。 emailed 表示请求发送的意图；email_sent_at 是服务自身记录的实际发送情况。

发送邮件的意图会在发布前写入草稿的 should_send_email 字段，并同时传入发布调用。仪表板会通过该字段保存发送决定，且其默认值为 true，因此如果只设置其中一处，端点读取草稿而非请求正文时，就可能会向整个订阅者列表发送邮件。

没有取消发布工具：发布后无法通过此服务撤销。

输入：

• draft_id（数字）：由 list_posts 或 create_draft_post 返回的 ID

返回：{status, draft_id, draft_title}。

Substack 使用同一个端点删除草稿和已发布的文章，因此此工具会先读取目标，若文章已发布则拒绝操作——删除已上线的文章不可撤销，需通过仪表板操作。

输入：

• full（布尔值，可选）：返回全部 111 个字段（约 24 KB），而非精简视图。 默认为 false。 返回：默认返回投影结果——名称、子域名、自定义域名、首页宣传文案、版权信息、发件人 名称、徽标、套餐、付款状态和社区／播客标记——以及说明已省略字段数量的 _meta。完整载荷主要 包含通知开关，以及欢迎邮件、服务条款页面和隐私页面的原始 HTML。

输入：

• full（布尔值，可选）：包含完整的 subscriptions 数组。默认为 false。

返回：{id, name, handle, bio, photo_url, publications, primary_publication_id, subscription_count}。publications 列出此会话拥有某种角色的所有出版物，可据此发现 SUBSTACK_PUBLICATION_URL 并非唯一可指向的出版物。

输入：

• include_hidden（布尔值，可选）：包含导航中未显示的标签。默认为 true。

返回：{total, returned, tags}，每个标签为 {id, name, slug, hidden}。标签 ID 是 UUID，而非 整数——与此 API 中的其他所有 ID 不同。

输入：

• post_id（数字）：来自 list_posts 的 ID。草稿也适用。

返回：{post_id, count, tags}，每个标签为 {post_tag_id, name, slug, hidden, association_id}。

底层端点只返回 UUID，因此此工具会根据出版物的标签列表解析名称。get_draft 和 list_posts 都不包含标签，所以这是唯一能读取标签的方式。

输入：

• post_id（数字）：来自 list_posts 的 ID。草稿也适用。
• tag_name（字符串）：与现有标签进行不区分大小写的匹配
• create_if_missing（布尔值，可选）：没有匹配名称时创建标签。默认为 true； 设为 false 时，拼写错误会被报告，而不会被转成新标签。

返回：{status, post_id, tag, tag_created, association_id}，其中 status 为 tagged 或 already_tagged——对文章已有的标签重复添加会使上游直接返回 400，因此此工具会先检查。

此工具接受名称而非 ID，因为 ID 是 UUID，调用方通常不可能持有这些 ID。

输入：

• post_id（数字）：来自 list_posts 的 ID
• limit（数字，可选）：1–100，默认为 50

返回：{post_id, returned, automod_hidden_count, comments}。每条评论包含作者、 纯文本正文、表情回应数和回复数，以及其在线程中的位置（parent_comment_id、 depth）。被 Substack 自动审核隐藏的评论会计入数量，但不会合并到评论列表中——它们会在上游的 单独数组中返回；若静默丢弃，就会把“已拦截”变成“无人评论”。

输入：

• post_id（数字）：来自 list_posts 的 ID
• body（字符串）：纯文本；Substack 会在服务器端转换

返回：{status, post_id, comment}。

评论会以你的名义发布。请求发出前，完整文本会以 info 级别记录，因为日志是所说内容的唯一 记录。此服务不提供删除功能，但可以在 Substack 界面中删除评论——与 restack 不同，评论有自己的 ID。

返回值：{returned, pages_fetched, subscriptions}，每个订阅都包含方案、membership_state、 is_founding、is_favorite，以及是否已关闭邮件通知。最多在内部请求 20 页；如果达到此上限而停止，则会返回 truncated: true。

不要与 list_subscribers 混淆，后者列出的是订阅了你的内容的人。

输入：

• limit（数字，可选）：1–100，默认值为 20
• after（字符串，可选）：上次响应中的 next_after。这是一个时间戳，不是不透明游标——此端点自己的 cursor 字段始终为 null。

返回值：{returned, more, next_after, posts}，每篇文章都包含阅读状态摘要（is_read、read_progress、is_saved）。收件箱会发送每篇文章的完整正文；此处会将其丢弃，因此请使用 get_reader_post 阅读单篇文章。

输入：

• post_id（数字）：来自 list_reader_posts 或 get_reader_feed
• include_body（布尔值，可选）：默认值为 true

返回值：文章的元数据及 body_html。body_truncated: true 表示正文受付费墙限制，本次会话无法解除限制——preview_text 仍包含预览内容。

正文保持为 HTML：转换正文需要新增依赖，或对标记进行正则处理，而正则 HTML 转换器会在不报错的情况下破坏嵌套列表和嵌入内容。

输入：

• tab（字符串，可选）：标签页 id——for-you（默认值）或 subscribed。不能使用显示名称：显示名称会本地化。
• limit（数字，可选）：1–50，默认值为 20
• cursor（字符串，可选）：上次响应中的 next_cursor
• include_tabs（布尔值，可选）：同时返回可用的标签页 id

返回值：{tab, returned, next_cursor, items}。每个项目都是一条 note 或一篇 post。 non_content_items_skipped 统计 Substack 混入数组的“关注推荐”区块数量，这些区块完全不包含内容。

输入：

• user_id（数字，可选）：默认为 SUBSTACK_USER_ID——你自己的账号
• type（all | notes | posts，可选）：默认值为 all
• limit（数字，可选）：1–50，默认值为 20
• cursor（字符串，可选）

返回值：{user_id, type, returned, next_cursor, items}。启用筛选时，read_from_profile 会报告该页面实际包含的条目数——否则，“从 20 个已读取条目中读到 3 条 notes”会让人误以为“这个账号只写了 3 条 notes”。

输入：

• comment_id（数字）：不带 Substack 在 URL 中使用的 c- 前缀
• include_replies（布尔值，可选）：默认值为 true

返回值：{comment, branch_count, replies_returned, more_branches, next_cursor, branches}。每个分支包含一条直接回复及其后代回复，并解析出 parent_comment_id 和 depth。

输入：

• comment_id（数字）：要 Restack 的 Note，来自 get_reader_feed 或 get_profile_feed
• tab_id（字符串，可选）：默认值为 for-you

返回值：{status, comment_id, restack_id, note}。

此操作是公开的，并会显示在你的个人资料中，且无法在此处撤销：Restack 没有独立的 id——它会通过 context: comment_restack 显示原始 Note——因此此 MCP 服务无法删除任何内容。请在 Substack 界面中将其移除。