substack-api-mcp MCP Server

Substack does not provide a native public API for publishing posts.

Local serverstdio

What is the substack-api-mcp Server?

substack-api-mcp is an MCP project maintained in the alxgntv/substack-api-mcp repository. The maintainer describes its purpose as “Substack does not provide a native public API for publishing posts”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using /ABSOLUTE/PATH/TO/Substack-API-MCP/.venv/bin/substack-api-mcp. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares APISUBSTACK_API_KEY, SUBSTACK_PUBLICATION_URL, SUBSTACK_SID. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
test_connection	Verify substack.sid and return profile
create_post	Create draft / publish now / schedule (+ optional tags)
get_draft	Fetch draft by id
pangram_detection	Pangram AI-text / AI-slop check on a draft
update_draft	Update draft fields
publish_post	Publish existing draft
schedule_post	Schedule existing draft
delete_draft	Delete draft
list_tags	List publication tags
create_tag	Create tag
set_tags	Ensure + attach tags
get_post_tags	List tags on a post/draft
create_note	Create a Substack Note (optional link attachment)
delete_note	Delete a Substack Note by id

How to install the substack-api-mcp Server

{
  "mcpServers": {
    "substack-api": {
      "command": "/ABSOLUTE/PATH/TO/Substack-API-MCP/.venv/bin/substack-api-mcp",
      "args": [],
      "env": {
        "APISUBSTACK_API_KEY": "YOUR_APISUBSTACK_API_KEY",
        "SUBSTACK_PUBLICATION_URL": "https://yourname.substack.com",
        "SUBSTACK_SID": "YOUR_SUBSTACK_SID_VALUE"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
APISUBSTACK_API_KEY	Declared in the maintainer’s client configuration.	Check documentation
SUBSTACK_PUBLICATION_URL	Declared in the maintainer’s client configuration.	Check documentation
SUBSTACK_SID	Declared in the maintainer’s client configuration.	Check documentation