# Substack MCP for AI Agents AI Agent Connect > Substack MCP lets your AI agent handle your newsletter management directly. You can draft new posts, check subscriber growth trends, and pull engagement metrics without leaving your current workspace. It turns your AI into a publication manager that knows your audience and content history. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_YpBi8hRnrhTPJHoHKTYYVNARu6MIIFCBfFP8XLRm/ai-agent-connect - **Tags:** newsletter, publishing, subscriber-analytics, content-drafting, monetization ## Description Managing a newsletter often feels like a chore of jumping between browser tabs. You're writing in one window, then switching to the Substack dashboard to check if your last post hit its open rate goals, then moving back to a spreadsheet to track subscriber counts. 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 can have it pull your recent engagement stats to see what's resonating, check your subscriber growth, or even draft the next post based on your previous style. It makes the entire process of running a publication feel like a conversation rather than a series of administrative tasks. Because it's hosted on the Vinkius marketplace, you can get this connected to your preferred AI client in minutes, letting you stay in your flow while the agent handles the logistics of your content calendar and audience insights. You can quickly see your leaderboard standing or update your publication metadata without ever having to navigate through the complex settings menus of the web interface. It's designed for people who want to spend more time writing and less time doing the manual data entry that comes with growing an audience. ## Tools ### get_post Fetch the details of a specific post. This helps you see the content and status of any single entry. ### get_leaderboard View your publication's ranking on the Substack leaderboard. This helps you track your growth relative to others. ### list_posts Get a list of your recent newsletter posts. Use this to see what's already been published or scheduled. ### get_post_stats Pull engagement metrics for a specific post. You can use this to see open rates and click rates instantly. ### list_subscribers Get a list of your current subscribers. This is useful for understanding your audience size and reach. ### get_publication_info Retrieve your publication's metadata and settings. Use this to check your categories and custom domains. ## Prompt Examples **Prompt:** ``` How many subscribers did I gain this month? ``` **Response:** ``` Based on your latest data, you've gained **185 new subscribers** this month, a growth rate of 4.5%. Your total count is now **4,250**. ``` **Prompt:** ``` What was the open rate on my last newsletter? ``` **Response:** ``` Your last post, 'Q1 Market Insights', had a **52% open rate**. Here's the breakdown: - **Opens**: 2,210 - **Sent**: 4,250 - **Click Rate**: 8% ``` **Prompt:** ``` Draft a post about AI in sales. ``` **Response:** ``` I've created a new draft for you titled **'The Future of AI in Sales'**. It's currently saved as a draft in your Substack account. Would you like me to write an intro or set a subtitle for it? ``` ## Capabilities ### Draft and schedule newsletter posts Create new content entries and set them for publication directly through your agent. ### Pull real-time subscriber growth data Get updated counts on your audience size and growth trends instantly. ### Retrieve engagement metrics for specific posts Check open rates and click rates for any post in your publication history. ### Access publication metadata and categories View and modify your publication settings like categories and custom domains. ### View your publication's leaderboard rankings See where your publication stands on the Substack leaderboard. ### Fetch detailed info on individual posts Get specific details and status updates for any single post in your list. ## Use Cases ### Checking performance A creator wants to know why last week's post performed well. They ask the agent to pull stats for 'Q1 Insights' using get_post_stats. ### Drafting content A writer needs a head start on a new topic. They ask the agent to create a new draft with a specific title using list_posts to check for duplicates first. ### Audience research A marketer wants to know how many new subscribers joined this month. They use list_subscribers to get the latest count. ### Metadata updates A publisher needs to change their publication category. They ask the agent to update the info using get_publication_info. ## Benefits - Stop switching tabs by using list_posts and get_post to manage your content calendar directly in your AI client. - Get instant feedback on what's working by pulling engagement data with get_post_stats without opening the dashboard. - Monitor your audience growth in real-time using list_subscribers to see how many new people are joining your list. - Keep your publication details organized by using get_publication_info to manage categories and metadata. - Track your competitive standing easily by pulling your current rank with get_leaderboard. ## How It Works The bottom line is you get a conversational way to run your entire newsletter without opening the Substack dashboard. 1. Subscribe to the Substack integration on the Vinkius marketplace. 2. Grab your API token from your Substack publication settings. 3. Connect the token to your AI client and start asking questions. ## Frequently Asked Questions **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.