hn-mcp
Provides search capabilities over Hacker News submissions via the Algolia API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@hn-mcp Check my recent HN submissions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π hn-mcp β Post to Hacker News via MCP
The only MCP server that can write to Hacker News. All 7+ existing HN MCP servers are read-only. This one submits stories, posts comments, and checks your submissions.
Tools
Tool | What it does |
| Login to HN (persists cookies across restarts) |
| Submit a story (link post or Ask HN) |
| Post a comment or reply |
| Check your recent posts with scores |
| Search HN via Algolia |
Related MCP server: @cyanheads/hn-mcp-server
Setup
cd hn-mcp
uv syncClaude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"hackernews": {
"command": "uv",
"args": ["run", "--directory", "/Users/YOU/path/to/hn-mcp", "python3", "server.py"],
"env": {
"HN_USERNAME": "your_hn_username",
"HN_PASSWORD": "your_hn_password"
}
}
}
}Cursor / Windsurf
Add to your MCP config:
{
"hackernews": {
"command": "uv",
"args": ["run", "--directory", "/Users/YOU/path/to/hn-mcp", "python3", "server.py"],
"env": {
"HN_USERNAME": "your_hn_username",
"HN_PASSWORD": "your_hn_password"
}
}
}Usage
Just talk naturally:
"Submit my dispatch to Hacker News as Show HN"
"Post a comment on item 12345 explaining our scanner"
"Check how my last HN submission is doing"
"Search HN for axios supply chain attack"
How it works
HN has no write API. This server:
Logs in via HTTP POST with session cookies
Extracts FNID/HMAC CSRF tokens from forms
Submits via POST (same as clicking "submit" in the browser)
Persists cookies to
~/.hn-mcp-cookies.pklfor reuse
Security
Credentials via environment variables (never in code)
Session cookies at
~/.hn-mcp-cookies.pklNo data sent anywhere except
news.ycombinator.comandhn.algolia.com
License
MIT β booklib-ai
Available Tools
5 toolshn_commentADestructive
Post a comment on a Hacker News story or reply to a comment. Requires login.
Inputs: params (required). Returns: result
hn_loginA
Login to Hacker News. Persists session cookies to disk so you stay logged in across restarts.
Inputs: params (required). Returns: result
hn_my_submissionsARead-only
Get your recent HN submissions with their scores and comment counts.
Inputs: params (required). Returns: result
hn_searchBRead-only
Search Hacker News stories via Algolia.
Inputs: params (required). Returns: result
hn_submitADestructive
Submit a story to Hacker News. Requires login first. For link posts: provide title + url. For Ask HN / text posts: provide title + text (no url).
Inputs: params (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: login, search, submit, comment, and viewing own submissions. There is no overlap or ambiguity between them.
All tools use the 'hn_' prefix and mostly follow a verb pattern, but 'hn_my_submissions' is a noun phrase with a possessive, breaking the verb pattern slightly.
With 5 tools covering login, search, submission, comments, and personal submissions, the count is well-scoped for a Hacker News client without being excessive.
The set covers basic HN interactions but misses common actions like upvoting, viewing specific stories, or reading comments. These gaps may require workarounds.
Maintenance
Related MCP Connectors
Dive into the latest and greatest from the tech world with our Hacker News MCP server.
Hacker News MCP β search and retrieve stories from Hacker News
Deterministic Hacker News developer sentiment, themes & feature requests via MCP. No API key.
Skills, agents and memory in the cloud, plus a gateway to your other MCP servers.
Related MCP Servers
- AlicenseDqualityDmaintenanceAn MCP server that enables AI assistants to access real-time Hacker News data including top stories, story details, comments, and search functionality.154 npm3MIT
- AlicenseNot gradedqualityBmaintenanceMCP server for Hacker News providing tools to fetch stories, threads, users, and search content via Firebase and Algolia APIs.245 npm7Apache 2.0
- AlicenseAqualityCmaintenanceMCP server for Hacker News that enables AI agents to search stories, read comments, and track tech trends via the public Hacker News API and Algolia HN Search.1030 npm4MIT
- AlicenseAqualityBmaintenanceMCP server enabling AI agents to interact with Hacker News, including fetching full comment trees with depth control, searching stories and comments, and retrieving user profiles.635 PyPI5MIT