Substack Publisher MCP Server

MCP server for Substack's official Publisher API

Local serverstdio

What is the Substack Publisher MCP Server?

MCP server for Substack's official Publisher API

What it actually does

The first MCP server for Substack's official Publisher API. Query post analytics, subscriber counts, and publication data directly from Claude, Cursor, or any MCP client.

Configuration

  • Node.js 18+. Check with node --version; install from nodejs.org if missing. - Substack Publisher API key. Generate one from your publication's Substack dashboard. If you don't see a Publisher API option there, it may not be enabled for your publication yet; see the Publisher API docs for availability.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

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.

ToolWhat it does
list_publicationsList configured publications
list_postsList published posts
search_postsFull-text search across published posts
get_postGet a post and its body by URL slug
get_post_statsGet engagement stats for a post
get_subscriber_countsGet daily subscriber counts by type
get_subscriberLook up a subscriber by email

How to install the Substack Publisher MCP Server

{
  "mcpServers": {
    "substack": {
      "command": "node",
      "args": [
        "/path/to/substack-publisher-mcp/dist/index.js"
      ],
      "env": {
        "SUBSTACK_API_KEY": "YOUR_SUBSTACK_API_KEY"
      }
    }
  }
}

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

Configuration

  • Node.js 18+. Check with node --version; install from nodejs.org if missing. - Substack Publisher API key. Generate one from your publication's Substack dashboard. If you don't see a Publisher API option there, it may not be enabled for your publication yet; see the Publisher API docs for availability.
VariableDescriptionRequired
SUBSTACK_API_KEYDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Substack Publisher MCP to list publications.”
  • “Use Substack Publisher MCP to list posts.”
  • “Use Substack Publisher MCP to get post.”

Frequently asked questions

MCP server for Substack's official Publisher API Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.