Substack Connector for AI agents.
6 live capabilities
Manage your newsletter publication and subscriber growth from a single chat.
Waiting for input…
Why people use Substack
Substack for managing newsletter publication growth
This Connector changes that by giving your AI agent a direct line to your Substack publication. Instead of manually pulling data into a spreadsheet or copying drafts back and forth, you can just ask your agent to do the heavy lifting. You get a unified way to handle your publication's logistics without the constant context switching.
What Vinkius changes
You get a conversational way to run your entire newsletter without opening the Substack dashboard.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 6,100+ Connectors
- Real-world use case 01
Checking performance
A creator wants to know why last week's post performed well.
- Real-world use case 02
Drafting content
A writer needs a head start on a new topic.
- Real-world use case 03
Audience research
A marketer wants to know how many new subscribers joined this month.
Complete set · 6capabilities
The complete Substack capability set.
These are the exact actions your AI can choose when you ask it to work with Substack.
01—03
3 capabilities in this set.
Part of 6 available through Substack.
- 01 Capability
Get post
Fetch the details of a specific post. This helps you see the content and status of any single entry.
- 02 Capability
Get leaderboard
View your publication's ranking on the Substack leaderboard. This helps you track your growth relative to others.
- 03 Capability
List posts
Get a list of your recent newsletter posts. Use this to see what's already been published or scheduled.
04—06
3 capabilities in this set.
Part of 6 available through Substack.
- 04 Capability
Get post stats
Pull engagement metrics for a specific post. You can use this to see open rates and click rates instantly.
- 05 Capability
List subscribers
Get a list of your current subscribers. This is useful for understanding your audience size and reach.
- 06 Capability
Get publication info
Retrieve your publication's metadata and settings. Use this to check your categories and custom domains.
Set up in minutes
One URL. Then ask Substack to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Substack from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_YpBi8hRnrhTPJHoHKTYYVNARu6MIIFCBfFP8XLRm/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Substack, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Substack for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_YpBi8hRnrhTPJHoHKTYYVNARu6MIIFCBfFP8XLRm/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Substack URL.
- Step 03
Save and start
Save the connection and enable Substack in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"substack": {
"url": "https://edge.vinkius.com/vk_preview_YpBi8hRnrhTPJHoHKTYYVNARu6MIIFCBfFP8XLRm/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Substack
Open Agent mode in chat and ask: "Using Substack, help me...". 6 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"substack": {
"url": "https://edge.vinkius.com/vk_preview_YpBi8hRnrhTPJHoHKTYYVNARu6MIIFCBfFP8XLRm/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Substack
Ask Copilot: "Using Substack, help me...". 6 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"substack": {
"url": "https://edge.vinkius.com/vk_preview_YpBi8hRnrhTPJHoHKTYYVNARu6MIIFCBfFP8XLRm/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Substack
Open Cascade and ask: "Using Substack, help me...". 6 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"substack": {
"url": "https://edge.vinkius.com/vk_preview_YpBi8hRnrhTPJHoHKTYYVNARu6MIIFCBfFP8XLRm/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Substack
Ask Cline: "Using Substack, help me...". 6 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add substack --transport http "https://edge.vinkius.com/vk_preview_YpBi8hRnrhTPJHoHKTYYVNARu6MIIFCBfFP8XLRm/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Substack
Ask Claude: "Using Substack, show me...". 6 tools are ready
Where the request belongs
Work Substack can move forward.
This is for newsletter creators who are tired of the tab-switching tax and want to manage their publication's growth and content through a single chat interface.
Newsletter Creator
Drafts posts and checks open rates while staying in their primary writing app.
Content Marketer
Tracks audience demographics and growth trends to adjust strategy quickly.
Publication Manager
Oversees multiple Substack accounts and manages metadata across all of them.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsBeehiiv
Automate newsletter management via Beehiiv. manage publications, subscribers, analytics, and posts natively with your AI agent.
Buttondown
Automate your newsletter and subscriber management via Buttondown. manage lists, draft emails, and track tags directly from any AI agent.
FeedBlitz
Manage mailing lists, RSS feeds, and email marketing campaigns through AI.
Maildroppa
Grow your email list and send targeted campaigns with a simple email marketing platform designed for solopreneurs and creators.
AWeber
Manage subscribers, mailing lists, and email campaigns via AWeber. orchestrate newsletters natively via AI.
Kit (ConvertKit)
Automate your creator marketing. manage subscribers, tags, and forms via AI.
Bring your own AI
Change the model, client or framework. Keep Substack connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Substack.
The practical details behind the request, access and result.
Can I use the Substack MCP to see my newsletter stats?
Yes, the Substack MCP lets you pull engagement metrics like open rates and click rates directly into your chat. You can ask about specific posts to see how your audience is responding.
How do I connect Substack to my AI client?
You just need to subscribe to the Connector on Vinkius, get your API token from your Substack publication settings, and provide it to your AI client. It handles the rest.
Can this Connector help me draft my newsletter posts?
Yes, you can ask your agent to create new drafts, set titles, and organize your content. It helps you get started on your writing without having to open the Substack editor first.
Does the Substack MCP track my subscriber growth?
It does. You can query your subscriber counts and see how your audience is growing over time by asking your agent to check your subscriber list.
Can I manage my publication's categories with this Connector?
Yes, the Substack MCP allows you to access and modify your publication's metadata, including your categories and custom domain information.
How does the Substack MCP show my leaderboard position?
You can ask your agent to pull your current leaderboard info. It will show you where your publication stands in the Substack rankings.
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.
One connection away
Give your agent a direct line to Substack.
Connect Substack once. Keep it beside 6,100+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available