4,500+ servers built on MCP Fusion
Vinkius

Substack MCP. Manage posts, stats, and subs without leaving your chat.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Substack MCP on Cursor AI Code Editor MCP Client Substack MCP on Claude Desktop App MCP Integration Substack MCP on OpenAI Agents SDK MCP Compatible Substack MCP on Visual Studio Code MCP Extension Client Substack MCP on GitHub Copilot AI Agent MCP Integration Substack MCP on Google Gemini AI MCP Integration Substack MCP on Lovable AI Development MCP Client Substack MCP on Mistral AI Agents MCP Compatible Substack MCP on Amazon AWS Bedrock MCP Support

Just plug in your AI agents and start using Vinkius.

Substack MCP Server connects your AI agent directly to Substack's backend. You manage entire newsletter publications—from drafting posts to tracking detailed subscriber growth and open rates—without ever opening the main website editor.

It lets you query audience demographics, list content drafts, or pull deep analytics purely through conversation.

What your AI agents can do

Get leaderboard

Retrieves a leaderboard ranking, likely based on engagement or popularity metrics.

Get post

Fetches the full content and details for one specific published article.

Get post stats

Retrieves detailed performance metrics (open rate, click rates) for a single post.

+ 3 more capabilities included
Audience Management

Lists current subscriber counts and pulls raw lists of members based on the list_subscribers tool.

Content Discovery & Drafting

Retrieves a list of recent posts using list_posts, or gets full details and draft content for specific articles via get_post.

Performance Analysis

Calculates metrics like open rates, click-through rates, and subscriber growth trends by invoking the get_post_stats tool.

Publication Metadata Retrieval

Pulls high-level details about your entire newsletter platform using get_publication_info, including categories and custom domains.

Supported MCP Clients

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients
Free for Subscribers

Waiting for input…

AI Agent

Substack MCP Server: 6 Tools for Publishing Analytics

Use these tools to pull specific data points—from subscriber lists to post stats—and feed them directly into your AI client's workflow.

get019d760e

get leaderboard

Retrieves a leaderboard ranking, likely based on engagement or popularity metrics.

get019d760e

get post

Fetches the full content and details for one specific published article.

get019d760e

get post stats

Retrieves detailed performance metrics (open rate, click rates) for a single post.

get019d760e

get publication info

Gets core metadata and settings information about the entire Substack publication.

list019d760e

list posts

Lists titles, statuses, and basic details for a set of recent articles published on the account.

list019d760e

list subscribers

Generates a list or summary report of all current subscribers to the publication.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on every call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with Substack, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 4,700+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Every connection is secured and compliant automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog every week

What you can do with this MCP connector

Substack MCP Server lets your AI agent talk straight to Substack's backend. You manage your entire newsletter operation—from drafting a killer post to checking deep subscriber metrics—without ever having to touch the main web editor. It’ll let you pull audience demographics, list draft content, or run detailed analytics purely by talking to your agent."

"### Audience Tracking and Growth Reports

You wanna know who's reading your stuff? The list_subscribers tool gives you a raw report of every person subscribed to the publication. You can use that data to build out segments or check the total count at any time. For bigger picture info, get_publication_info pulls core metadata, letting you see high-level settings like what categories you're using and if you’ve set up a custom domain for your newsletter."

"### Content Workflow: From Draft to Published

Need to check what articles are sitting there waiting? The list_posts tool pulls titles, statuses, and basic details on all the recent pieces published under the account. If you need the full write-up—the actual content or a draft version—you use get_post, which fetches everything for one specific article. You can also check out how well that single piece did by calling get_post_stats.

This tool doesn't just give you a number; it retrieves detailed performance metrics, like the exact open rate and click-through rates for that post."

"### Deep Dive Analytics and Ranking

Figuring out what works is everything. The get_post_stats mechanism calculates key engagement numbers—open rates, click rates—for any specific article you point it at. You can run these checks repeatedly to spot trends or see which topics really hit home with your readers. Beyond single-post analysis, the get_leaderboard tool retrieves a leaderboard ranking, usually based on how engaged people are with certain content pieces.

This lets you instantly know what's performing best against everything else published."

"### The Workflow In Action

You don't have to jump between five different tabs to get this stuff done. You just ask your agent: 'List the titles of my last ten posts, then pull the subscriber count, and give me the open rate for the article titled The Big Shift.' It uses list_posts first, grabs the total number via list_subscribers, and hits get_post_stats all in one go.

You'll get a clean report back without any manual copy-pasting or clicking around.

If you need to see what your whole newsletter setup looks like—the overall categories, the custom domain name, and other high-level settings—you run get_publication_info. It gives you the structural data for your entire platform. This server lets you treat Substack like a database, allowing your AI client to query it just like talking to a teammate over coffee: direct, specific, and actionable.

How Substack MCP Works

  1. 1 First, subscribe to the Substack integration on Vinkius. Then, secure your API token from your publication's backend settings.
  2. 2 Next, you give that token and context to your AI agent (e.g., 'Check the open rate for my last post').
  3. 3 The agent uses the specific tools—like get_post_stats—to pull real-time data, which it then synthesizes into a natural language report.

The bottom line is: you treat your entire newsletter backend like another conversation topic for your AI client.

Who Is Substack MCP For?

This tool is built for the content creator who hates switching tabs. It’s perfect for the marketing manager tired of clicking through multiple dashboards just to figure out if last week's post was a hit or a flop. If your job involves regular publishing, tracking growth, or analyzing performance metrics, this saves you hours.

Newsletter Creator

Uses list_posts to check drafts and then asks the agent to schedule them for publication without leaving their main writing tool.

Content Marketer

Runs multi-step queries combining get_post_stats with demographic data from list_subscribers to plan paid campaigns.

Thought Leader/Publisher

Manages multiple publications by calling get_publication_info to confirm settings and access aggregated performance metrics across different streams of content.

What Changes When You Connect

  • Stop context switching. You can draft a post or check analytics directly through your agent; no need to open the Substack editor just to copy data.
  • Deep performance insight: Instead of guessing, you get hard numbers on click rates and open rates by calling get_post_stats for any article.
  • Audience visibility: Easily pull subscriber lists using list_subscribers. You can ask your agent who signed up this month or how many paid members you have.
  • Holistic overview: Use get_publication_info to check if your custom domain is set up correctly, or verify what the current category structure looks like before publishing.
  • Workflow control: The combination of list_posts and targeted calls lets your agent find specific content drafts so you can edit them immediately.

Real-World Use Cases

01

Figuring out why Q2's post flopped

The marketing manager notices engagement dipped after the last piece. Instead of digging into confusing dashboards, they prompt their agent: 'Check get_post_stats for the article from June 1st.' The agent runs the tool and reports back that while the open rate was fine, the click rate on internal links dropped by 15%, pinpointing exactly where the content fell short.

02

Batch checking drafts before launch

A newsletter creator has five articles ready to go. They don't want to manually check each one. They ask the agent to use list_posts first, getting all five IDs. Then they tell the agent to run get_post on each ID and summarize them, making sure all titles are correct and no body content is missing.

03

Calculating monthly growth rates

The thought leader needs to report quarterly metrics. They prompt: 'Run list_subscribers for this month and compare it to the last one.' The agent gathers the raw data, calculates the percentage change, and provides a clean summary ready for their presentation.

04

Verifying publication settings

Before running an ad campaign, the marketer needs confirmation that the correct custom domain is active. They call get_publication_info via the agent. The tool confirms the status and details immediately, preventing them from wasting time on a broken link.

The Tradeoffs

Manually compiling stats

The user copies open rates from the analytics tab into a spreadsheet, then manually calculates month-over-month growth percentages.

Instead, ask your agent to call get_post_stats for multiple posts and compare those outputs directly. The AI client handles the calculation logic, saving you manual data entry.

Drafting without context

A user asks the agent to draft a post but forgets to tell it which publication's settings (get_publication_info) or style guide it should use.

Always run get_publication_info first. This grounds the agent in your specific metadata, ensuring any generated content adheres to your established brand rules and categories.

Assuming post availability

Asking the agent to check stats for a post ID that was deleted or never existed.

Always run list_posts first. This gives you an accurate, live list of available content IDs before requesting specific data via get_post or get_post_stats.

When It Fits, When It Doesn't

Use this server if your workflow requires deep, multi-step analysis: comparing subscriber lists against post performance metrics, or drafting content based on hard data. You need the machine to handle complex data orchestration—for example, listing posts (list_posts), pulling stats on three of them (get_post_stats x 3), and summarizing all that in one go.

Don't use this if you just want a simple view. If your only goal is to browse the site or edit content using the web UI, connecting this server adds unnecessary complexity. This tool shines when you need data out of Substack and into an actionable workflow (like feeding metrics into a billing script or a CRM).

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.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

How we secure it →

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This server provides 6 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.

Available Capabilities

get_leaderboard get_post get_post_stats get_publication_info list_posts list_subscribers

Reviewing newsletter performance used to mean opening three different tabs.

You know the drill: you finish a week of publishing, and now you have to check analytics. You open the Substack dashboard, find the right post, click on 'Analytics,' then look at the open rate graph... then switch to the subscriber tab just to see if your total count actually went up. It's clicking through four different views just for a basic performance summary.

Now? You tell your agent: 'Run `get_post_stats` and compare it to the total subscribers from `list_subscribers`.' Your AI client handles the clicks, pulls all the numbers you need, and gives you one clean report. The whole process takes seconds.

Substack MCP Server: Get a complete picture of your audience.

Before this server, figuring out who was reading your content meant guessing or relying on vague internal reports. You couldn't easily pull a list of current members without navigating to the dedicated 'subscribers' section and exporting a CSV just to count them.

Now you run `list_subscribers`. The agent pulls that data into your workflow instantly, letting you analyze growth trends alongside your content performance metrics—all from chat. It’s immediate.

Common Questions About Substack MCP

How do I get my Substack API token? +

Log in to your Substack publication at yourdomain.substack.com. Navigate to Settings from the left sidebar. Look for the Publication API or Developer section. Generate an API token and copy it. Paste it into the configuration field below. Note: Substack's API is currently in limited availability — check Substack's developer page for the latest access information.

Can I draft and schedule newsletter posts? +

Yes. Your AI agent can create draft posts with title, body content, subtitle, and metadata. You can then schedule them for a specific date and time — managing your entire editorial calendar conversationally.

Can I track how many subscribers I gained this month? +

Yes. Ask your AI agent for subscriber growth metrics and get total subscribers, new subscribers this month, churn rate, and free vs. paid subscriber breakdown.

Does this work with paid Substack publications? +

Yes. The integration supports both free and paid publications. You can manage paywalled content, check paid subscriber counts, and analyze revenue metrics through your AI agent.

How do I use get_post_stats to analyze detailed performance metrics? +

It provides granular stats beyond just open rates. You can check click rates on specific links, view total impressions, and see the number of shares for a post. This lets you figure out exactly which content resonates most with your audience.

What information do I get when I run list_posts? +

You retrieve metadata for all recent posts, including their current status (draft, published, scheduled). You can use this to quickly audit your publication history without navigating the Substack editor. It's great for checking drafts before you send them out.

Can get_publication_info tell me about my overall settings? +

Yes, it pulls core metadata like your custom domain and established categories. This tool helps verify the current setup of your publication without requiring you to log into the dashboard manually. It's a quick way to validate configurations.

How does list_subscribers work for audience segmentation? +

It lists individual subscribers and provides key demographic data points. You can use this raw data feed to segment your audience by location or sign-up source within your agent workflow. This makes targeted marketing much easier.

You might also like

Built & Managed by Vinkius 30s setup 6 tools

We've already built the connector for Substack. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 6 tools are live and waiting. You're up and running in seconds.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.