How to Use the Substack MCP in Claude Code

Q: How do I get a complete list of Substack subscribers via Claude Code?

Run listsubscribers in your terminal. The output is designed to be machine-readable, letting you capture every user ID and email address for automated processing.

Q: Can I use Claude Code to check Substack's publishing status?

Yes, running getpublicationinfo provides all the core metadata about the account. This confirms connection health and gives you parameters needed for your deployment scripts.

Q: What is the best way to monitor Substack post performance with Claude Code?

Use getpoststats. You can schedule this command to run nightly, capturing metrics that prove whether a certain content type is driving conversions. The output goes straight to STDOUT.

Q: If I need to analyze Substack's historical posts with Claude Code, what tools do I use?

First, pipe the list of IDs from listposts into a loop that calls getpost. This pulls down the raw content for every article you care about.

Q: What sensitive Substack information does Claude Code touch?

The server touches subscriber data when running listsubscribers. Since this is terminal-only, ensure your entire CI/CD environment is secured and logged appropriately.

Run Substack reporting in headless CI/CD with Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Substack MCP to Claude Code

Create your Vinkius account to connect Substack to Claude Code — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Substack with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

CLI Audience Auditing

Execute `list_subscribers` from a shell script to pull subscriber data into JSON format. This makes it easy to pipe the output directly into database migrations or billing scripts. The resulting stream of IDs and emails lets your SRE team verify user counts against external service records.

Metric Extraction for CI/CD

`get_post_stats` allows you to pull hard numbers on content performance, which is perfect for automated reporting. You can use the output as a conditional check in your pipeline (e.g., 'if stats > 10k, then deploy'). It's ideal for setting up cron jobs that monitor engagement trends without needing any GUI.

Bulk Content Retrieval

`list_posts` retrieves titles and IDs for recent Substack content. This is your starting point when building a scraper or an automated knowledge base index. You can then chain this by using `get_post` to grab the raw text of multiple posts, feeding them into another processing utility downstream.

Setup guide

Set up Substack MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see substack-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Substack transactions." It will automatically discover and invoke the available Substack tools.

Terminal

claude mcp add --transport http substack-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Substack MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "substack-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Substack. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Substack now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Substack MCP in Claude Code

Run `list_subscribers` in your terminal. The output is designed to be machine-readable, letting you capture every user ID and email address for automated processing.

Yes, running `get_publication_info` provides all the core metadata about the account. This confirms connection health and gives you parameters needed for your deployment scripts.

Use `get_post_stats`. You can schedule this command to run nightly, capturing metrics that prove whether a certain content type is driving conversions. The output goes straight to STDOUT.

First, pipe the list of IDs from `list_posts` into a loop that calls `get_post`. This pulls down the raw content for every article you care about.

The server touches subscriber data when running `list_subscribers`. Since this is terminal-only, ensure your entire CI/CD environment is secured and logged appropriately.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript