data
Hacker News MCP, CLI, and Lua Integration for AI Agents
Hacker News integration docs for AI agents: MCP gateway setup, Hacker News CLI commands, Lua API reference, credentials, and function schemas.
5 functions 5 read 0 write No credentials auth
Hacker News for agents
No credentials required; available in web and CLI hosts when runtime dependencies are installed.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Machine-Readable Metadata
- integration_slug
hackernews- route_slug
hackernews- package
hackernews- auth_strategy
noneNo credentials- cli_setup_supported
true- cli_runtime_supported
true- mcp_gateway_supported
true- lua_supported
true- supports_multi_account
false
Quick Links
Lua APIAgent-facing namespace and function reference. Hacker News CLIHeadless setup and direct function calls. Hacker News MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.
Hacker News MCP Client Matrix
Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Hacker News.
Claude Code Hacker News MCP setup for Claude Code. Cursor Hacker News MCP setup for Cursor. Codex Hacker News MCP setup for Codex. OpenAI Agents Hacker News MCP setup for OpenAI Agents SDK. Claude Agent SDK Hacker News MCP setup for Claude Agent SDK. Vercel AI SDK Hacker News MCP setup for Vercel AI SDK. LangChain Hacker News MCP setup for LangChain. LangGraph Hacker News MCP setup for LangGraph. CrewAI Hacker News MCP setup for CrewAI. MCP clients Hacker News MCP setup for Generic MCP Clients.
Hacker News CLI Matrix
Use these pages for direct Hacker News CLI workflows in scripts, CI, cron, and agent wrappers.
CI Hacker News CLI for CI. Cron Jobs Hacker News CLI for cron jobs. Shell Scripts Hacker News CLI for shell scripts. Headless Automation Hacker News CLI for headless automation. Coding Agents Hacker News CLI for coding agents.
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
hackernews.hackernews_get_item | Read read | 1 | Fetch a Hacker News item (story, comment, job, poll, or poll option) by its numeric ID. Returns all available fields: title, URL, text, author (by), score, time, descendants, and kids (child comment IDs). Use this to look up any HN item when you know its ID. |
hackernews.hackernews_get_user | Read read | 1 | Fetch a Hacker News user profile by username. Returns karma score, about text, account creation date, and lists of submitted item IDs (submissions) and comment IDs. |
hackernews.hackernews_list_top_stories | Read read | 1 | Fetch the current top stories from Hacker News. Returns up to N stories with full item data (title, URL, score, author, comment count). The "top" list is ranked by the HN algorithm (a combination of score, recency, and flags). |
hackernews.hackernews_list_new_stories | Read read | 1 | Fetch the newest stories from Hacker News. Returns up to N stories with full item data (title, URL, score, author, comment count). These are the most recently submitted stories, not yet ranked by the HN algorithm. |
hackernews.hackernews_list_best_stories | Read read | 1 | Fetch the highest-scoring (best) stories from Hacker News. Returns up to N stories with full item data (title, URL, score, author, comment count). These are the stories with the highest scores, regardless of age. |