Skip to main content
Glama
ccozad

hackernews-mcp

by ccozad
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_hackernewsA

Search Hacker News stories and comments via HN's Algolia API.

Use this to find HN discussion on a topic, surface Ask HN / Show HN posts, or pull the most recent items in a time window. Returns a JSON object with a hits array.

Parameters:

  • query (str, required): the search phrase, e.g. "rust async runtime".

  • tag (str): which item kind to search. One of "story" (default), "comment", "ask_hn", "show_hn", or "all".

  • time_range (str): restrict by recency. One of "past_24h", "past_week", "past_month", or "all_time" (default).

  • sort (str): "relevance" (default) ranks by Algolia relevance; "date" returns newest first.

  • limit (int): number of hits to return, 1-50 (default 10).

Each hit has: id, title, url, points, author, num_comments, created_at (ISO8601), and excerpt (a highlighted snippet when Algolia provides one). For comment hits, title/url/points are usually null and the matched text appears in excerpt. An empty search returns {"hits": []} rather than an error.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.3/5.0

Scored across 1 tool

Disambiguation5/5

Only one tool exists, so there is no possibility of confusion between tools. The search_hackernews tool has a clear, distinct purpose.

Naming Consistency5/5

With a single tool, naming consistency is not an issue. The name 'search_hackernews' follows a clear verb_noun pattern.

Tool Count2/5

For a server named hackernews-mcp, a single search tool is too few. Users would expect additional tools for fetching stories, comments, user info, and posting, making the scope feel incomplete.

Completeness2/5

The server lacks basic operations for Hacker News interaction, such as getting a story by ID, fetching top stories, or user information. Only search is supported, leaving significant gaps.

Maintenance

ActivityInactive
ResponsivenessResponsive

Resources