Technews Port

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 7, 2026

Hacker News top, new, and best stories, items, users, and full-text search.

The publisher's own server: Port

VerifiedSTDIODesktop onlyWeb Search & ScrapingCommunication & Collaboration

Overview

AI-generated overview

Read-only Hacker News reader that lets an assistant fetch top, new and best stories, single items, user profiles, and full-text story search.

What you can do
  • Fetch the ranked top, new and best story lists, with title, author, score, comment count, URL and timestamp already parsed
  • Look up a single Hacker News item by numeric id, including stories, comments, jobs and polls
  • Read a user's public profile: creation time, karma, about text and submitted item ids
  • Search Hacker News stories by query through the Algolia HN Search API
When to use it
Useful when you want an assistant to follow tech news, summarize what is trending on Hacker News, or look up a specific story, comment thread or user without leaving the chat. It is read-only, so it suits research and digest workflows rather than posting or moderation.
Requirements
Runs locally over stdio, either via npx with the npm package or via the published container image. No account, API key, environment variable or header is needed; it calls Hacker News' public Firebase and Algolia APIs, so network access is required. Desktop only.
Before you install
All tools are read-only lookups; nothing is posted, voted or changed. Queries and lookups go to Hacker News' public APIs and to Algolia's search service, so search terms are sent to a third party. Results reflect a live site, so an id in a ranked list may be missing from the fetched items.

Installation

In SourceWeft

  1. Open Technews Port in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

technews-port

technews-port is a small reader for Hacker News that speaks to the site's own public APIs, so there is no scraping and nothing to sign up for. It pulls the ranked front-page lists (top, new, and best), any single item by its numeric id, and any user's public profile from the official Firebase API, and it searches story text through the Algolia HN Search API — the one capability the Firebase API does not have.

Story lists come back with the items already fetched, in ranked order, not just bare ids: the headline, author, score, and comment count are right there for each entry.

Install

bash
npx @reneturcios/technews-port top --limit 10

Or run the container image:

bash
docker run -i ghcr.io/cloudcorprecords/technews-port

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

Every command prints JSON.

bash
# The three ranked lists (default 30 stories, capped at 100)technews-port toptechnews-port new --limit 10technews-port best --limit 5
# One item, one usertechnews-port item 8863technews-port user pg
# Full-text story search via Algolia (default 20 hits)technews-port search "show hn" --limit 10
technews-port --version

Exit codes: 0 on success, 1 when the lookup fails (an unknown item or user, or an upstream error, named in the message), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

bash
npx -y @reneturcios/technews-port mcp

MCP client configuration:

json
{  "mcpServers": {    "technews-port": {      "command": "npx",      "args": ["-y", "@reneturcios/technews-port", "mcp"]    }  }}

Tools

ToolInputWhat it returns
get_top_storieslimit (integer, optional)The current top stories: the ranked item ids plus each story parsed — title, author, score, comment count, URL, and timestamp.
get_new_storieslimit (integer, optional)The newest stories, same shape as get_top_stories.
get_best_storieslimit (integer, optional)The best stories, same shape as get_top_stories.
get_itemitem_id (integer, required)One item of any kind (story, comment, job, poll): its type, author, text or title, score, child comment ids, and deleted/dead flags.
get_userusername (string, required)The user's public profile: creation time, karma, about text, and submitted item ids.
search_storiesquery (string, required), limit (integer, optional)Stories matching the query, from Algolia: title, URL, author, points, comment count, and posting time per hit.

If an id in a ranked list disappears between reading the list and fetching the item — it happens on a live site — the id stays in item_ids and the item is simply absent from items.

Development

bash
npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, no networknpm run dev     # run the CLI from source via tsx

The core takes an injectable fetch function, and the test suite routes a fake fetch by URL to hand-written payloads shaped like real Firebase and Algolia responses — the tests never touch the network.

License

MIT — see LICENSE.

Source: README.md at commit cd8b447

Tools

6

get_top_stories

Get the current top stories on Hacker News.

Parameterslimit

get_new_stories

Get the newest stories on Hacker News.

Parameterslimit

get_best_stories

Get the best stories on Hacker News.

Parameterslimit

get_item

Get a Hacker News item by its ID.

Parametersitem_idrequired

get_user

Get a Hacker News user profile by username.

Parametersusernamerequired

search_stories

Search Hacker News stories by query.

Parameterslimitqueryrequired

Version history

1
  1. v0.1.0LatestOct 31, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Port integrations

Port

io.portOfficial publisher

Port's remote MCP server connects Port.io to an IDE, LLM or agent platform, letting an assistant work with your Port.io environment through OAuth-authenticated,

Streamable HTTPWeb executableAuth
Developer ToolsCredential requiredOct 24, 2026

GravityPort

Published by GitHub account fengseekling-coder

MCP server bundled with the GravityPort desktop app that lets Claude, Codex and other clients search and record a local library of AI-generated images, videos…

STDIODesktop only
Files & StorageNot validated yetNov 7, 2026

Worktrack Port

Published by GitHub account CloudCorpRecords

Jira issues and Confluence pages via the REST APIs, as MCP tools.

STDIODesktop only
Communication & CollaborationNot validated yetNov 3, 2026

Videohub Port

Published by GitHub account CloudCorpRecords

YouTube videos, channels, playlists, comments and transcripts as MCP tools.

STDIODesktop only
Not validated yetNov 3, 2026

Tasklist Port

Published by GitHub account CloudCorpRecords

Tasklist Port's local MCP server; no sign-in required; STDIO.

STDIODesktop only
Not validated yetNov 3, 2026