Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Hn Tech Signal MCP

by malkreideversion 0.5.0i★ 1iRuns on your computerRepository ↗
Registry nameio.github.malkreide/hn-tech-signal-mcp

How to install

What it does

MCP server for tech & AI signal intelligence: HackerNews, arXiv, Lobste.rs and GitHub

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Search & AI memory

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

by google-research★ 35,6381 skills

Skill · How-to guide

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

by BigBodyCobain★ 11,6051 skills

Skill · How-to guide

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

by gosom★ 8,2361 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity4/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score16/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Hn Tech Signal MCP. Follow https://mcp.popnx.com/i/malkreide-hn-tech-signal-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Hn Tech Signal MCP for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "hn-tech-signal": { "command": "uvx", "args": [ "hn-tech-signal-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Hn Tech Signal MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  3. Paste these settings and save the file

    {
      "mcpServers": {
        "hn-tech-signal": {
          "command": "uvx",
          "args": [
            "hn-tech-signal-mcp"
          ]
        }
      }
    }
  4. Quit Claude and open it again

  5. Try it

    Use Hn Tech Signal MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Hn Tech Signal MCP or shows a Hn Tech Signal MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Hn Tech Signal MCP yet

Hn Tech Signal MCP runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Hn Tech Signal MCP

  • Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • Install Python (uv) on your computer first (one time)
  • Install Python (uv) on your computer first (one time)
  • Install Python (uv) on your computer first (one time)

B · Others in Search & AI memory that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Hn Tech Signal MCP for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user hn-tech-signal -- uvx hn-tech-signal-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Hn Tech Signal MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --scope user hn-tech-signal -- uvx hn-tech-signal-mcp
  4. Type /mcp in Claude Code

    You should see Hn Tech Signal MCP listed as connected

  5. Try it

    Use Hn Tech Signal MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Hn Tech Signal MCP or shows a Hn Tech Signal MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Hn Tech Signal MCP for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "hn-tech-signal": { "command": "uvx", "args": [ "hn-tech-signal-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Hn Tech Signal MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Open the AI chat in Cursor in Agent mode

  4. Try it

    Use Hn Tech Signal MCP and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Hn Tech Signal MCP or shows a Hn Tech Signal MCP tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Hn Tech Signal MCP for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "hn-tech-signal": { "type": "stdio", "command": "uvx", "args": [ "hn-tech-signal-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Hn Tech Signal MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Open the AI chat in VS Code in Agent mode

  4. Try it

    Use Hn Tech Signal MCP and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Hn Tech Signal MCP or shows a Hn Tech Signal MCP tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Hn Tech Signal MCP💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user hn-tech-signal -- uvx hn-tech-signal-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "hn-tech-signal": {
      "command": "uvx",
      "args": [
        "hn-tech-signal-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "hn-tech-signal": {
      "command": "uvx",
      "args": [
        "hn-tech-signal-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "hn-tech-signal": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "hn-tech-signal-mcp"
      ]
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
36/wk
Connection
Runs on your computer
Latest versioni
0.5.0
Published to registryi
Sep 27, 2026
Code last changedi
Nov 3, 2026
Maker
malkreide
Packages
pypi: hn-tech-signal-mcp
Website
github.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account malkreide, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 16 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for hn-tech-signal-mcp@0.5.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/malkreide-hn-tech-signal-mcp.svg)](https://mcp.popnx.com/en/servers/malkreide-hn-tech-signal-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Search & AI memoryi

  • More stars than 76% of the other 6447 servers in this category
  • Published to the registry more recently than 42% of the other 6447 servers in this category
  • Basic checks equal to or better than 99% of the other 6447 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Hn Tech Signal MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 16 days ago, and the latest version (0.5.0) reached the registry 2 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

by every-appWidely used★ 28.3KUpdated 5 days ago

Runs in the cloud✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

by exa-labsWidely used★ 5.2KUpdated 2 months ago

Runs in the cloud✓ service owner · exa.aiTried by the PopNx team

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

by MicrosoftDocsWidely used★ 2KUpdated 12 months ago

Runs in the cloud✓ service owner · microsoft.comTried by the PopNx team

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

by proxysoulGrowing★ 1.6KUpdated 2 months ago

Runs in the cloud✓ empryo.com
Compared with similar ones
This one
Hn Tech Signal MCP
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoYesYesYesNoNo
Basic checks3/35/52/44/44/44/4
LicenseMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

🇨🇭 Part of the [Swiss Public Data MCP Portfolio](https://github.com/malkreide)

📡 hn-tech-signal-mcp

MCP server for global tech & AI signal intelligence — aggregates HackerNews, arXiv, Lobste.rs and GitHub into a structured briefing. No API key required.

🇩🇪 Deutsche Version

Demo

Overview

hn-tech-signal-mcp turns any AI assistant into a proactive tech intelligence analyst. The server aggregates four signal layers — research frontier, developer discourse, curated signal, and open-source practice — into a single, structured briefing.

No authentication required. All four data sources are public APIs. Optional: set GITHUB_TOKEN for higher GitHub rate limits (5,000 req/h vs. 60 req/h unauthenticated).

Anchor demo query: *"Give me a tech signal digest on AI today — what is happening in research, developer discourse and open source?"*


Signal Architecture

FRONTIER    arXiv API      → Latest AI/ML papers (cs.AI, cs.LG, cs.CL, cs.CV)

DISCOURSE HackerNews → Six feeds + Algolia search + comment threads Lobste.rs → Curated, lower-noise tech signal PRACTICE GitHub Search → What engineers are actually building right now HN Show HN → What individuals are shipping this week

Think of the four layers as a radar: arXiv shows what's coming over the horizon, HN and Lobste.rs show what practitioners are discussing, and GitHub shows what teams are actually shipping.

Within the discourse layer there are two levels of depth. The feeds and the search tell you *what* is being discussed; hn_discussion tells you *what is actually being argued* — the counter-arguments and the "we tried this in production" replies that carry the real signal.


Features

  • 🔬 Research frontier – Latest arXiv papers by category (cs.AI, cs.LG, cs.CL, and more)
  • 🔍 arXiv full-text search – Find papers by keyword, title, or author
  • 🗣️ HackerNews feeds – top, best, new, Ask HN, Show HN and YC job posts
  • 🔎 HackerNews search – Full history via Algolia, with date range filter
  • 💬 HackerNews comment threads – Read the actual discussion under a story, nested, with a bounded fetch budget
  • 🔧 Lobste.rs hottest – Curated developer signal, filterable by tag
  • 🛠️ GitHub trending AI repos – Search by topic, stars, sort by activity or popularity
  • 📋 Tech signal digest – One-call cross-source briefing in Markdown
  • ☁️ Dual transport – stdio for Claude Desktop, Streamable HTTP for cloud deployment
#ToolSourceDescription
1hn_top_storiesHackerNewsSix feeds: top/best/new/ask/show/job, with score filter
2hn_searchHN AlgoliaFull-text search across all HN history
3hn_discussionHackerNewsNested comment thread under a story
4arxiv_latestarXivLatest papers by category (cs.AI etc.)
5arxiv_searcharXivSearch papers by keyword/title/author
6lobsters_hotLobste.rsCurated tech stories, filterable by tag
7github_trending_aiGitHubTrending AI repos by topic and stars
8tech_signal_digestAll sourcesAggregated Markdown briefing
HackerNews feeds
FeedContentUpstream size
topFront page as ranked right now500 items
bestHighest-voted recent stories200 items
newNewest submissions, unfiltered500 items
askAsk HN — what practitioners are stuck on~30 items
showShow HN — what people are shipping200 items
jobYC portfolio job posts (type: "job", no comments, score always 1)~30 items

ask and job are short feeds upstream, so a large limit may return fewer stories than requested.


Prerequisites

  • Python 3.11+
  • uv or pip
  • No API key required
  • Optional: GITHUB_TOKEN for higher GitHub rate limits

Installation

# Recommended: uvx (no install step needed)

uvx hn-tech-signal-mcp

Alternative: pip

pip install hn-tech-signal-mcp


Quickstart

# Start the server (stdio mode for Claude Desktop)

uvx hn-tech-signal-mcp

With optional GitHub token for higher rate limits

GITHUB_TOKEN=ghp_yourtoken uvx hn-tech-signal-mcp

Try immediately in Claude Desktop:

*"Give me a tech signal digest on AI today"*

*"What are the latest cs.AI papers from the last 48 hours?"*

*"What is HackerNews discussing about MCP this week?"*

*"Show me trending GitHub repos for the topic 'ai-agents'"*


Configuration

Environment Variables
VariableDefaultDescription
GITHUB_TOKEN–Optional. GitHub personal access token. Without it: 60 req/h. With it: 5,000 req/h. The token is only sent to api.github.com, never to other upstreams.
MCP_TRANSPORTstdioTransport: stdio or streamable_http
MCP_HOST127.0.0.1Bind host for HTTP transport. Non-loopback values require MCP_BEARER_TOKEN.
MCP_PORT8000Port for HTTP transport
MCP_BEARER_TOKEN–Required when MCP_HOST is not loopback. Shared secret to gate the HTTP endpoint.
Claude Desktop Configuration
{

"mcpServers": { "hn-tech-signal": { "command": "uvx", "args": ["hn-tech-signal-mcp"], "env": { "GITHUB_TOKEN": "ghp_yourtoken_optional" } } } }

Config file locations:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

After restarting Claude Desktop, all 7 tools are available.

Cloud Deployment (Streamable HTTP)

For use via claude.ai in the browser (e.g. on managed workstations):

Render.com (recommended):

  1. Push/fork the repository to GitHub
  2. On render.com: New Web Service → connect GitHub repo
  3. Optionally set GITHUB_TOKEN in the Render dashboard
  4. In claude.ai under Settings → MCP Servers, add: https://your-app.onrender.com/mcp
# Local HTTP mode (binds 127.0.0.1 by default)

MCP_TRANSPORT=streamable_http MCP_PORT=8000 python -m hn_tech_signal_mcp.server

Public bind (requires bearer token, intended behind a reverse proxy that terminates TLS)

MCP_TRANSPORT=streamable_http \ MCP_HOST=0.0.0.0 \ MCP_BEARER_TOKEN="$(openssl rand -hex 32)" \ python -m hn_tech_signal_mcp.server

Hardening: the server refuses to bind to non-loopback hosts unless

MCP_BEARER_TOKEN is set. Run cloud deployments behind a TLS-terminating

reverse proxy (Render, Fly, Caddy, …) and treat MCP_BEARER_TOKEN as the

shared client secret your proxy enforces.


Architecture

┌─────────────────┐    ┌─────────────────────────────────┐    ┌───────────────────────┐

│ Claude / AI │────▶│ HN Tech Signal MCP │────▶│ HackerNews Firebase │ │ (MCP Host) │◀────│ (MCP Server) │────▶│ HN Algolia Search │ └─────────────────┘ │ │────▶│ arXiv.org (Atom API) │ │ 8 Tools │────▶│ Lobste.rs JSON API │ │ Stdio | Streamable HTTP │────▶│ GitHub Search API │ └─────────────────────────────────┘ └───────────────────────┘

Architecture decision

This server uses Architecture A (live API only, two paths per source). There is no bulk dump to fall back on.

Rationale (verified live on 2026-07-28 against the official HackerNews API):

  • All six feed endpoints ({top,best,new,ask,show,job}stories.json) answer HTTP 200 with 29–500 IDs. No auth, no rate-limit headers, Cache-Control: no-cache.
  • HackerNews publishes no bulk export, so caching is entirely this server's responsibility. TTLs live in CACHE_TTL.
  • The Firebase API has no search. Historical and full-text queries go through the Algolia index instead — that is the second path, used by hn_search.
  • item/ .json is one request per item. Feeds and comment threads therefore fan out, which is why both are bounded (HN_MAX_CONCURRENCY, max_comments).

Consequences:

  • Every upstream call retries with exponential backoff (2s / 4s / 8s) on network errors, 5xx and 429. Other 4xx fail fast.
  • One process-wide pooled httpx.AsyncClient, closed via the FastMCP lifespan.
  • Unknown item IDs return HTTP 200 with a null body rather than a 404 — hn_discussion translates that into an explicit "no item found" message.

Project Structure

hn-tech-signal-mcp/

├── src/ │ └── hn_tech_signal_mcp/ │ ├── init.py │ ├── server.py # All 8 tools │ └── outputs.py # outputSchema models, one per tool ├── tests/ │ ├── init.py │ └── test_server.py # 64 unit + 12 live tests ├── pyproject.toml ├── CHANGELOG.md ├── CONTRIBUTING.md ├── LICENSE ├── README.md # This file (English) └── README.de.md # German version


MCP Protocol Version

This server speaks two protocol eras over the same endpoint. The client's first request on a connection decides which one applies; a later claim from the other era is refused.

EraRevisionWho reaches it
initialize handshake2024-11-05 … `2025-11-25`What today's clients speak. The server answers with the revision asked for, or with the 2025-11-25 ceiling when the request asks for something newer.
Per-request envelope`2026-07-28`A request carrying the 2026-07-28 _meta envelope opens a modern connection.

Both revisions are pinned in tests/test_protocol_version.py and asserted against the installed SDK, so a Dependabot bump of mcp cannot move either one silently.

Spoken, not just named: tests/test_modern_era.py actually connects — in-process in every era (2026-07-28, auto, legacy) and over HTTP with single POSTs, no initialize and no Mcp-Session-Id, against the ASGI app that MCP_TRANSPORT=streamable_http starts. It checks server/discover, tools/list with its freshness hint, tools/call with the Mcp-Name header, the serverInfo stamp in the _meta of every response, and that no feature deprecated by SEP-2577 (sampling, roots, logging) is involved. Two negative controls sit alongside: a wrong Mcp-Method header is rejected with -32020, and the same request under 2025-11-25 still requires a session.

Known, SDK-side: server/discover advertises resources and prompts (with listChanged / subscribe) although this server registers neither — MCPServer always installs those handlers. Switching that off would mean touching private attributes; instead the tests assert that both lists answer empty and without error.

Note that the SDK's LATEST_PROTOCOL_VERSION is an alias for the modern era, not for the handshake era — pinning against it alone would leave the era that current clients actually negotiate free to drift.

Update policy. When the gate fails, do not edit the constant blindly: read the spec changelog between the two revisions, verify the server still behaves, then move the constant, this section, README.de.md and

Only the beginning is shown; read the rest in the repo