MCP.Market

Readhn MCP server

by xodn348·io.github.xodn348/readhn·v0.2.0·5 stars
No reviews yet

AI-native HackerNews MCP Server. Find HN content that matters with explainable quality signals.

B75/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B75/100

full report

Adoption
New

5 stars12 downloads/wk

Reviews

Write one

Nobody has reviewed Readhn yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Readhn tools (6)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • discover_stories
  • expert_brief
  • find_experts
  • search
  • story_brief
  • thread_analysis

Public scan report

scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it

no findings
  • Code scan9 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 201 days ago4/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 75/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Readhn compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
75/100
higher than 45% of 48,255 servers
Tools
6
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
5
more than 83% of 28,688 servers
Downloads a week
12
more than 3% of 12,191 servers with a package

What its tools let an agent do: 6 read

Install Readhn in Claude Code, Cursor or VS Code

claude mcp add readhn -- uvx readhn
Add to Cursor

What the publisher says

From the Readhn repository's README, as published. We do not edit it. Read it on GitHub

readhn

<!-- mcp-name: io.github.xodn348/readhn -->

AI-native HackerNews MCP Server. Find HN content that matters with explainable quality signals.

What It Does

Discover — Filter stories by keywords, scores, time. Get ranked results with quality signals.

Trust — Find domain experts. See who's talking and why they matter. EigenTrust propagation from seed experts.

Understand — Every result explains WHY. 5 signals: practitioner depth (30%), thread depth (20%), expert involvement (20%), velocity (15%), references (15%).

Quick Start

# Install
pip install readhn

# Auto-configure supported AI agents
readhn setup

readhn setup detects Claude Code, Codex, Cursor, Claude Desktop, Cline, Windsurf, and OpenCode config paths and adds the readhn MCP server.

Useful setup flags:

readhn setup --list              # Show detected agents
readhn setup --dry-run           # Preview config changes only
readhn setup --agents "Cursor"  # Configure only specific agents

After setup, your AI agent auto-discovers readhn and uses it when you ask HN questions.

Usage

Ask your AI agent:

  • "Show me top HN stories about Rust this week"
  • "Find experts who write about databases on HN"
  • "What did practitioners say about Kubernetes networking?"

The agent calls readhn tools, gets results with quality signals, and explains why each result matters.

Configuration (Optional)

export HN_KEYWORDS="ai,llm,rust,distributed-systems,databases"  # Default filter keywords
export HN_MIN_SCORE="50"                                         # Minimum story score
export HN_EXPERTS="tptacek,simonw,antirez,ept,jepsen"           # Seed experts for trust
export HN_TIME_HOURS="24"                                        # Time window

How It Works

When you ask HN questions, your AI agent uses these tools:

  • discover_stories() — Top stories filtered by keywords/score/time, ranked by quality signals
  • search() — Algolia search with explainable ranking
  • find_experts() — Find domain experts using EigenTrust on comment graph
  • expert_brief() — User profile + activity + trust score
  • story_brief() — Story + top comments + signals in one call
  • thread_analysis() — Full comment tree with quality signals per comment

Every response includes signals breakdown: why each result was chosen.

License

MIT

Nothing above is checked by us. What we check is on the safety report.

Readhn: common questions

Is Readhn MCP server safe?
Mostly: it is graded B (75/100). Read the Readhn safety report
How do I install Readhn?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Readhn need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Readhn maintained?
The last commit was 238 days ago (2026-03-11). The latest release is v0.2.0.
How does Readhn compare with other MCP servers?
safety score 75/100 (higher than 45% of 48,255 servers); tools 6 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.