Substack MCP server for AI agents

Let Claude, ChatGPT or your own agent read Substack: 3 typed functions through one MCP server. No Substack API key needed.

Functions
3
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Substack

An MCP server for Substack alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/substack
Every site

One MCP server for Substack and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 3
  • postReads one Substack post by URL (or publication + slug): title, authors, date, likes, comments and the full body as HTML and plain text.

    Arguments

    NameTypeRequired
    urlstring
    A post URL, e.g. "https://lenny.substack.com/p/some-post".
    No
    publicationstringNo
    slugstringNo

    Returns SubstackPost

    interface SubstackPublication {
      id: number | null;
      name: string;
      /** Pass as posts({ publication }). */
      subdomain: string | null;
      customDomain: string | null;
      url: string | null;
    }
    
    interface SubstackPostSummary {
      id: number;
      title: string;
      subtitle: string | null;
      slug: string;
      url: string;
      publishedAt: string | null;
      /** "everyone" is free; "only_paid" / "founding" are paywalled. */
      audience: string | null;
      type: string | null;
      likes: number | null;
      comments: number | null;
      wordCount: number | null;
      coverImage: string | null;
      publication: SubstackPublication | null;
    }
    
    interface SubstackPost extends SubstackPostSummary {
      authors: { name: string; handle: string | null }[];
      /** For a paywalled post, only the free preview. */
      bodyHtml: string | null;
      bodyText: string | null;
      paywalled: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/substack/post

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.substack.post({});
  • postsLists a Substack newsletter's posts, newest first, from the publication's own archive.

    Arguments

    NameTypeRequired
    publicationstring
    "lenny", "lenny.substack.com", "www.lennysnewsletter.com" or any URL on the newsletter.
    Yes
    limitnumber
    1-50, default 12.
    No
    cursorstring
    The nextCursor a previous posts() call returned, for the next, older page.
    No

    Returns SubstackPostsResult

    interface SubstackPublication {
      id: number | null;
      name: string;
      /** Pass as posts({ publication }). */
      subdomain: string | null;
      customDomain: string | null;
      url: string | null;
    }
    
    interface SubstackPostSummary {
      id: number;
      title: string;
      subtitle: string | null;
      slug: string;
      url: string;
      publishedAt: string | null;
      /** "everyone" is free; "only_paid" / "founding" are paywalled. */
      audience: string | null;
      type: string | null;
      likes: number | null;
      comments: number | null;
      wordCount: number | null;
      coverImage: string | null;
      publication: SubstackPublication | null;
    }
    
    interface SubstackPostsResult {
      publication: string;
      posts: SubstackPostSummary[];
      /** Pass back as cursor for the next, older page. Null at the end. */
      nextCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/substack/posts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.substack.posts({ publication: "lenny", limit: 3 });

Use it from code