Substack MCP. Manage posts, stats, and subs without leaving your chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
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.
Lists current subscriber counts and pulls raw lists of members based on the list_subscribers tool.
Retrieves a list of recent posts using list_posts, or gets full details and draft content for specific articles via get_post.
Calculates metrics like open rates, click-through rates, and subscriber growth trends by invoking the get_post_stats tool.
Pulls high-level details about your entire newsletter platform using get_publication_info, including categories and custom domains.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
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.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Substack on Vinkius019d760eget leaderboard
Retrieves a leaderboard ranking, likely based on engagement or popularity metrics.
019d760eget post
Fetches the full content and details for one specific published article.
019d760eget post stats
Retrieves detailed performance metrics (open rate, click rates) for a single post.
019d760eget publication info
Gets core metadata and settings information about the entire Substack publication.
019d760elist posts
Lists titles, statuses, and basic details for a set of recent articles published on the account.
019d760elist 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
Make Your AI Do More
Start with Substack, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ 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
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
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.
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.
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.
019d760e-8906-71a5-9eab-aa41df6eafe0 
How Substack MCP Works
- 1 First, subscribe to the Substack integration on Vinkius. Then, secure your API token from your publication's backend settings.
- 2 Next, you give that token and context to your AI agent (e.g., 'Check the open rate for my last post').
- 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.
Uses list_posts to check drafts and then asks the agent to schedule them for publication without leaving their main writing tool.
Runs multi-step queries combining get_post_stats with demographic data from list_subscribers to plan paid campaigns.
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_statsfor 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_infoto 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_postsand targeted calls lets your agent find specific content drafts so you can edit them immediately.
Real-World Use Cases
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.
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.
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.
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).
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.