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
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/hackernewsOne 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/mcpSet it up in your clientBoth 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.
getItemReturns one Hacker News item.Arguments
Name Type Required idnumberYes Returns
HackerNewsIteminterface 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/getItemCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hackernews.getItem(8863);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hackernews.getItem(8863))curl -X POST https://api.bowmark.ai/v1/sites/hackernews/getItem \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":8863}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.hackernews.getItem(8863);getThreadReturns a Hacker News story or comment with its entire nested comment thread in one call.Arguments
Name Type Required argsHackerNewsGetThreadArgs | number | stringYes interface HackerNewsGetThreadArgs { id: number | string; depth?: number; }Returns
HackerNewsThreadinterface 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/getThreadCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hackernews.getThread({ id: 8863 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hackernews.getThread({"id": 8863}))curl -X POST https://api.bowmark.ai/v1/sites/hackernews/getThread \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":8863}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.hackernews.getThread({ id: 8863 });searchKeyword-searches every Hacker News story through HN's own search (hn.algolia.com), returning title, link, points, comment count and date per hit.Arguments
Name Type Required querystringYes Returns
HackerNewsSearchHit[]interface HackerNewsSearchHit { id: number; title: string; url: string | null; author: string | null; points: number | null; commentCount: number | null; createdAt: string | null; hnUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/hackernews/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hackernews.search("dropbox");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hackernews.search("dropbox"))curl -X POST https://api.bowmark.ai/v1/sites/hackernews/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"dropbox"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.hackernews.search("dropbox");searchCommentsSearch Hacker News comments for community discussion and opinion on a topic.Arguments
Name Type Required 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/searchCommentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hackernews.searchComments({ query: "dropbox" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hackernews.searchComments({"query": "dropbox"}))curl -X POST https://api.bowmark.ai/v1/sites/hackernews/searchComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"dropbox"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/topStoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hackernews.topStories({ limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hackernews.topStories({"limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/hackernews/topStories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.hackernews.topStories({ limit: 3 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/hackernews/<function> - OpenAPI
/v1/sites/hackernews/openapi.json