Social

Substack MCP Server

Connect your account, then chat with AI to run tools.

Read Substack publications, posts, and personalized feeds. Browse any publication's posts, read full post content, explore categories, and access your personalized reader feed — all through Substack's API.

4 tools
Agent guide included
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Substack — workflow patterns, data models, and gotchas for your AI agent.

Substack

Read Substack publications and posts. Browse categories, read full post content, and access your personalized reader feed.

Data Model

  • Publication — A Substack newsletter identified by subdomain (e.g. tonylewislondon for tonylewislondon.substack.com).
  • Post — An article with title, subtitle, body HTML, reactions, comments, audience type, wordcount.
  • Category — One of 31 Substack categories (Technology, Culture, Business, etc.) with subcategories.
  • Feed Item — A personalized reader feed entry showing posts, notes, and comments from subscriptions.

What You Can Do

Read Publications

Browse any Substack publication's posts by subdomain. Get titles, dates, reaction counts, comment counts, and audience type (everyone vs paid). No need to know the publication URL — just the subdomain.

Read Full Posts

Get full post content by slug. Returns the complete HTML body, wordcount, reactions, comments, subtitle, and metadata. Works for any public post on any publication.

Browse Categories

List all 31 Substack categories with their subcategories. Useful for discovering publications in a topic area.

Personalized Feed

Access your authenticated reader feed showing posts, notes, and comments from your subscriptions. Returns publication metadata, user profiles, and engagement context.

Gotchas

  • Subdomain required: Publication tools need the subdomain (e.g. tonylewislondon), not the full URL.
  • Public posts only: Post content is available for posts with audience: "everyone". Paid-only posts return truncated content.
  • Cookie auth: The token is your substack.sid session cookie from substack.com/settings. It expires after ~30 days.
  • Rate limits: Respect Substack's rate limits — space requests at least 2 seconds apart.
  • Feed is personalized: The reader feed returns content based on your subscriptions and Substack's recommendations.

Tools in this Server (4)

Substack Get Feed

Get your personalized Substack reader feed showing posts, notes, and comments from your subscriptions. Requires authentication. Filter by tab: 'for-yo...

Substack Get Post

Read the full content of a Substack post by subdomain and slug. Returns the complete HTML body, title, subtitle, wordcount, reactions, comments, publi...

Substack Get Posts

List posts from any Substack publication by subdomain. Returns title, subtitle, date, audience type, reaction count, comment count, and slug for each ...

Substack List Categories

List all Substack categories (Technology, Culture, Business, etc.) with their subcategories, slugs, and emoji. Useful for discovering publications in ...

Frequently Asked Questions

What is the Substack MCP server?

Read Substack publications, posts, and personalized feeds. Browse any publication's posts, read full post content, explore categories, and access your personalized reader feed — all through Substack's API. It provides 4 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Substack to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/substack. Authentication is handled automatically.

How many tools does Substack provide?

Substack provides 4 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Substack require?

Substack uses API Key. Substack requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Substack to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/substack

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Ready to use Substack?

Sign in to connect your credentials and start running tools from the chat.

Substack MCP Server & Skill — 4 Tools