hn-mcp-server

endpoint

https://hn.caseyjhand.com/mcp

protocol

http-sse ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is hn-mcp-server live?

Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.

Is hn-mcp-server free to use?

Yes — the hub reached it with no key and no payment.

What tools does hn-mcp-server have?

4 tools: hn_get_stories, hn_get_user, hn_search_content, hn_get_thread.

Is hn-mcp-server safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• hn_get_stories reads unknown 14h ago

  Fetch stories from an HN feed (top, new, best, ask, show, jobs), with title, URL, score, author, and comment count for each story.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "feed"
    ],
    "properties": {
      "feed": {
        "enum": [
          "top",
          "new",
          "best",
          "ask",
          "show",
          "jobs"
        ],
        "type": "string",
        "description": "Which HN feed to fetch. \"top\" includes jobs. \"ask\" and \"show\" are Ask HN / Show HN posts."
      },
      "count": {
        "type": "integer",
        "default": 30,
        "maximum": 100,
        "minimum": 1,
        "description": "Number of stories to return. Larger counts take longer."
      },
      "offset": {
        "type": "integer",
        "default": 0,
        "maximum": 9007199254740991,
        "minimum": 0,
        "description": "Number of stories to skip from the start of the feed. Use with count for pagination."
      }
    },
    "additionalProperties": false
  }

  arguments 36 lines copy
• hn_get_user reads unknown 14h ago

  Get an HN user profile with karma, about, and optionally their most recent submissions resolved into full items.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "username"
    ],
    "properties": {
      "username": {
        "type": "string",
        "minLength": 1,
        "description": "HN username. Case-sensitive. Trimmed; blank or whitespace-only input is rejected."
      },
      "submissionCount": {
        "type": "integer",
        "default": 10,
        "maximum": 50,
        "minimum": 1,
        "description": "Page size — how many submissions to resolve per call. Only used when includeSubmissions is true."
      },
      "submissionOffset": {
        "type": "integer",
        "default": 0,
        "maximum": 9007199254740991,
        "minimum": 0,
        "description": "How many submissions to skip before resolving, counting back from the most recent. Use with submissionCount to page through a long history: request offset 0, then offset submissionCount, and so on. The enrichment block echoes submissionOffset and, when more remain, the offset to send next. Only used when includeSubmissions is true."
      },
      "includeSubmissions": {
        "type": "boolean",
        "default": false,
        "description": "Resolve the user's most recent submissions into full items. Without this, only the submission count is available."
      }
    },
    "additionalProperties": false
  }

  arguments 34 lines copy
• hn_search_content reads unknown 14h ago

  Search Hacker News stories, comments, polls, and jobs via Algolia — by keyword, by filters alone, or both. Filterable by content type, author, parent story, date range, and minimum points.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "properties": {
      "page": {
        "type": "integer",
        "default": 0,
        "maximum": 9007199254740991,
        "minimum": 0,
        "description": "Page number for pagination (0-indexed)."
      },
      "sort": {
        "enum": [
          "relevance",
          "date"
        ],
        "type": "string",
        "default": "relevance",
        "description": "Sort order. \"relevance\" for best match, \"date\" for most recent first."
      },
      "tags": {
        "enum": [
          "story",
          "comment",
          "poll",
          "job",
          "ask_hn",
          "show_hn",
          "front_page"
        ],
        "type": "string",
        "description": "Filter results by content type: \"story\", \"comment\", \"poll\", or \"job\", or the story subsets \"ask_hn\", \"show_hn\", and \"front_page\". Omit to search all types."
      },
      "view": {
        "enum": [
          "full",
          "compact"
        ],
        "type": "string",
        "default": "full",
        "description": "How much of each hit to return. \"full\" includes every field. \"compact\" omits the two body-text fields — `text` and `highlights.text` — which together can repeat a long comment twice per hit; everything else (id, title, url, domain, author, points, comment count, timestamp, parent story, title highlight, matchedWords) is unchanged. Use \"compact\" to scan many results, then pass a hit id to hn_get_thread to read the body you skipped."
      },
      "count": {
        "type": "integer",
        "default": 30,
        "maximum": 50,
        "minimum": 1,
        "description": "Number of results to return."
      },
      "query": {
        "type": "string",
        "minLength": 1,
        "description": "Search terms. Supports simple keywords — Algolia handles stemming and relevance. Trimmed before searching; blank or whitespace-only input is rejected. Omit for a filter-only search, which needs at least one of tags, author, storyId, minPoints, or a dateRange bound."
      },
      "author": {
        "type": "string",
        "minLength": 1,
        "description": "Filter results to a specific author. Useful for finding a user's posts on a topic (hn_get_user only shows recent submissions). Trimmed before filtering; omit the field to search all authors rather than passing a blank string."
      },
      "storyId": {
        "type": "integer",
        "maximum": 9007199254740991,
        "description": "Restrict results to one discussion: the id of a story or poll root, combined with the other filters. Pair with tags \"comment\" to search within a thread. Take it from hits[].storyId or the root item of hn_get_thread — a comment id matches nothing.",
        "exclusiveMinimum": 0
      },
      "dateRange": {
        "type": "object",
        "properties": {
          "end": {
            "type": "string",
            "pattern": "^(\\d{4})(?:-(\\d{2})(?:-(\\d{2})(?:T(\\d{2}):(\\d{2})(?::(\\d{2})(?:\\.\\d{1,3})?)?(?:Z|[+-](\\d{2}):(\\d{2}))?)?)?)?$",
            "description": "Exclusive upper bound — only items created strictly before this instant match. Same formats and UTC reading as start, and must be later than start. A date-only end excludes that whole UTC day: to include it, pass the next day or a full timestamp."
          },
          "start": {
            "type": "string",
            "pattern": "^(\\d{4})(?:-(\\d{2})(?:-(\\d{2})(?:T(\\d{2}):(\\d{2})(?::(\\d{2})(?:\\.\\d{1,3})?)?(?:Z|[+-](\\d{2}):(\\d{2}))?)?)?)?$",
            "description": "Exclusive lower bound — only items created strictly after this instant match. ISO 8601: YYYY, YYYY-MM, YYYY-MM-DD, or YYYY-MM-DDThh:mm[:ss[.sss]] with an optional Z or ±hh:mm offset. Reduced and date-only forms mean UTC midnight at the start of that period; a date-time without an offset is read as UTC."
          }
        },
        "description": "Filter to a creation-time window with a start, an end, or both. An empty object is rejected — omit dateRange instead."
      },
      "minPoints": {
        "type": "integer",
        "maximum": 9007199254740991,
        "minimum": 0,
        "description": "Minimum score. Applies to stories and polls, including the ask_hn, show_hn, and front_page subsets. Comments and jobs carry no points in the search index, so any minPoints excludes them — combining it with tags \"comment\" or \"job\" is rejected."
      }
    },
    "additionalProperties": false
  }

  arguments 90 lines copy
• hn_get_thread reads unknown 8h ago

  Get an item and its comment tree as a threaded discussion, with child comments resolved recursively. Use depth 0 for an item-only lookup. A long thread comes back in pages: pass the returned nextCursor as cursor to continue.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "itemId"
    ],
    "properties": {
      "depth": {
        "type": "integer",
        "default": 3,
        "maximum": 10,
        "minimum": 0,
        "description": "How many levels of replies to resolve. 0 = just the item, no comments. 1 = direct replies only. Replies below this depth are never fetched — to read them, raise depth or call again with a specific comment's itemId to drill into its subtree. Ignored when cursor is set: the depth the cursor was issued with applies."
      },
      "cursor": {
        "type": "string",
        "description": "nextCursor from a previous call, passed with the same itemId, to continue the traversal at the next unseen comment without repeating or skipping any. Omit to start from the top."
      },
      "itemId": {
        "type": "integer",
        "maximum": 9007199254740991,
        "minimum": -9007199254740991,
        "description": "ID of the story, comment, job, poll, or poll option to fetch the thread for."
      },
      "maxComments": {
        "type": "integer",
        "default": 50,
        "maximum": 200,
        "minimum": 1,
        "description": "Maximum comments in one response, across all depth levels. Highest-ranked top-level comments resolve first; replies fill in only after the level above is exhausted. A response also stops at a fixed 64,000-byte text budget. When either limit stops the traversal, nextCursor continues it."
      }
    },
    "additionalProperties": false
  }

  arguments 34 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.

Served from the same domain, which is what was measured. Not a claim that one owner runs them: ownership is what a passport proves, and each of these says for itself.

• brapi.caseyjhand.com brapi-mcp-server mcp · 22 tools
• usaspending.caseyjhand.com usaspending-mcp-server mcp · 18 tools
• onebusaway.caseyjhand.com onebusaway-mcp-server mcp · 16 tools
• secedgar.caseyjhand.com secedgar-mcp-server mcp · 16 tools
• courtlistener.caseyjhand.com courtlistener-mcp-server mcp · 14 tools
• openfda.caseyjhand.com openfda-mcp-server mcp · 14 tools
• gbif-biodiversity.caseyjhand.com gbif-biodiversity-mcp-server mcp · 13 tools
• openfec.caseyjhand.com openfec-mcp-server mcp · 12 tools

101 more sit on this domain. All of them.