What you can do with Substack

Built for

Newsletter research, content strategy, creator analysis, media monitoring, reader workflows

Example workflows

Research a publication

Turns publication post history into editorial research.

Try this

Read recent posts from this Substack publication, summarize the main themes, audience, publishing cadence, and strongest article ideas.

Analyze a full post

Uses full public post content for content analysis.

Try this

Fetch this Substack post by subdomain and slug, then summarize the argument, structure, evidence, and reusable ideas.

Explore a category

Uses category discovery to guide publication research.

Try this

List Substack categories and suggest publications or topic areas to research for B2B SaaS content strategy.

Summarize my reader feed

Turns a personalized feed into a prioritized reading list.

Try this

Review my personalized Substack feed, group posts by topic, and list which ones deserve a deeper read today.

Context to know first

What Substack data can MCPBundles read?

It can browse publications by subdomain, list posts, fetch full public post content by slug, list categories, and read a personalized feed when a valid session token is connected.

What is a Substack subdomain?

A publication subdomain is the part before substack.com, such as example in example.substack.com. Publication tools use that short value.

Can it read paid-only posts?

Public posts are the reliable path. Paid-only posts can return truncated or limited content depending on the connected reader session and Substack access.

Related editorial

Substack Workflows with AI

How AI agents can browse any Substack publication, read full posts, explore categories, and summarise your personalised reader feed.

Read article

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.

What Substack data can MCPBundles read?

It can browse publications by subdomain, list posts, fetch full public post content by slug, list categories, and read a personalized feed when a valid session token is connected.

What is a Substack subdomain?

A publication subdomain is the part before substack.com, such as example in example.substack.com. Publication tools use that short value.

Can it read paid-only posts?

Public posts are the reliable path. Paid-only posts can return truncated or limited content depending on the connected reader session and Substack access.

What are the best Substack workflows?

The strongest workflows are publication research, full-post summarization, category exploration, competitor newsletter analysis, and personalized feed triage.

Setup Instructions

Connect Substack to any MCP client in minutes

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

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Substack and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Substack will appear under Not connected — select it and click Connect to complete OAuth.
Name: Substack
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/substack
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use Substack?

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

Substack MCP Server & Skill — 4 Tools