Hacker News MCP server for AI agents

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

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

Connect

Just Hacker News

An MCP server for Hacker News 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/hackernews
Every site

One MCP server for Hacker News 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 5
  • getItemReturns one Hacker News item.

    Arguments

    NameTypeRequired
    idnumberYes

    Returns HackerNewsItem

    interface HackerNewsItem {
      id: number;
      type: string;
      title: string | null;
      url: string | null;
      text: string | null;
      by: string | null;
      score: number | null;
      time: string | null;
      commentCount: number | null;
      kids: number[];
      parent: number | null;
      hnUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/hackernews/getItem

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.hackernews.getItem(8863);
  • getThreadReturns a Hacker News story or comment with its entire nested comment thread in one call.

    Arguments

    NameTypeRequired
    argsHackerNewsGetThreadArgs | number | stringYes
    interface HackerNewsGetThreadArgs {
      id: number | string;
      depth?: number;
    }

    Returns HackerNewsThread

    interface HackerNewsComment {
      id: number;
      by: string | null;
      text: string;
      time: string | null;
      score: number | null;
      replies: HackerNewsComment[];
    }
    
    interface HackerNewsThread {
      id: number;
      by: string | null;
      title: string | null;
      text: string | null;
      time: string | null;
      score: number | null;
      replies: HackerNewsComment[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/hackernews/getThread

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.hackernews.getThread({ id: 8863 });
  • searchCommentsSearch Hacker News comments for community discussion and opinion on a topic.

    Arguments

    NameTypeRequired
    argsstring | HackerNewsSearchCommentsArgsYes
    interface HackerNewsSearchCommentsArgs {
      query: string;
      since?: string | number;
      until?: string | number;
      sort?: "relevance" | "date";
      limit?: number;
    }

    Returns HackerNewsCommentHit[]

    interface HackerNewsCommentHit {
      id: number;
      text: string;
      author: string | null;
      createdAt: string | null;
      parentId: number | null;
      storyId: number | null;
      storyTitle: string | null;
      storyUrl: string | null;
      hnUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/hackernews/searchComments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.hackernews.searchComments({ query: "dropbox" });
  • topStoriesReturns the stories on the Hacker News front page (or the new, best, Ask HN, Show HN or job list) in rank order.

    Arguments

    NameTypeRequired
    list"top" | "new" | "best" | "ask" | "show" | "job"No
    limitnumberNo

    Returns HackerNewsItem[]

    interface HackerNewsItem {
      id: number;
      type: string;
      title: string | null;
      url: string | null;
      text: string | null;
      by: string | null;
      score: number | null;
      time: string | null;
      commentCount: number | null;
      kids: number[];
      parent: number | null;
      hnUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/hackernews/topStories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.hackernews.topStories({ limit: 3 });

Use it from code