{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_h3yupjrqhc4d","handle":"hacker-news-mcp-py","url":"https://wellknown.network/agents/hacker-news-mcp-py","links":{"self":"https://wellknown.network/agents/hacker-news-mcp-py/record.json","html":"https://wellknown.network/agents/hacker-news-mcp-py","markdown":"https://wellknown.network/agents/hacker-news-mcp-py/record.md","api":"https://wellknown.network/api/v1/agents/hacker-news-mcp-py","status":"https://wellknown.network/api/v1/agents/hacker-news-mcp-py/status","claim":"https://wellknown.network/agents/hacker-news-mcp-py/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/hacker-news-mcp-py/claim.json","badge":"https://wellknown.network/agents/hacker-news-mcp-py/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/hacker-news-mcp-py/history","tools":"https://wellknown.network/api/v1/agents/hacker-news-mcp-py/tools"},"ard":{"identifier":"urn:air::server:hacker-news-mcp-py","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"hacker-news-mcp-py","summary":"MCP server for searching Hacker News stories via Algolia","description":"# Hacker News MCP\n\nMCP server for searching Hacker News stories through the Algolia Hacker News Search API.\n\nThe server is read-only and is designed to run through `uvx`.\n\nThe PyPI distribution name is `mcp-hacker-news` (the name `hacker-news-mcp` is rejected as too similar to existing projects).\n\n## Install and Run\n\nInstall from PyPI with pip:\n\n```bash\npip install mcp-hacker-news\nhacker-news-mcp\n```\n\n(`mcp-hacker-news` is also installed as a command.)\n\nOr run with uv:\n\n```bash\nuvx mcp-hacker-news\n```\n\nDuring local development:\n\n```bash\nuv run hacker-news-mcp\n```\n\n## MCP Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"hacker-news\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-hacker-news\"]\n    }\n  }\n}\n```\n\n## Running from a Local Source Copy\n\nIf you want to run a local copy of this repository instead of resolving the package\nthrough `uvx`, clone the source code and install dependencies:\n\n```bash\ngit clone https://github.com/m-higuchi/hacker-news-mcp\ncd hacker-news-mcp\nuv sync\n```\n\nThen use the following MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"hacker-news\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"/path/to/hacker-news-mcp\",\n        \"run\",\n        \"hacker-news-mcp\"\n      ]\n    }\n  }\n}\n```\n\nReplace `/path/to/hacker-news-mcp` with the **absolute path** to the directory where you cloned this repository (the folder that contains `pyproject.toml`).\n\n## Backend API\n\nThis server uses Algolia's Hacker News Search API as the primary backend:\n\n```text\nhttps://hn.algolia.com/api/v1\n```\n\nStory searches always include `tags=story`. Date range searches call `/search_by_date` and convert ISO dates into Algolia `created_at_i` numeric filters.\n\n## Tools\n\n### `search_stories_by_date`\n\nSearch stories within a date range.\n\nInput:\n\n```json\n{\n  \"query\": \"AI\",\n  \"start_date\": \"2026-04-01\",\n  \"end_date\": \"2026-04-27\",\n  \"limit\": 20,\n  \"page\": 0\n}\n```\n\nBehavior:\n\n- `start_date` and `end_date` accept `YYYY-MM-DD` or ISO datetime strings.\n- Date-on…","publisher":{"name":"hacker-news-mcp contributors","url":null},"homepage":"https://github.com/m-higuchi/hacker-news-mcp","repository":"https://github.com/m-higuchi/hacker-news-mcp","version":"0.2.0","license":"MIT License\n        \n        Copyright (c) 2026 hacker-news-mcp…","protocols":["mcp"],"tags":["algolia","hacker-news","mcp","model-context-protocol"],"pricing":null,"endpoints":[{"url":"pypi:hacker-news-mcp-py","type":"package_pypi","auth":null,"probeable":false,"listed":true}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.news","name":"News & Feeds","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":1,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"hacker-news-mcp-py","registry":"pypi","observedAt":"2026-11-09T06:27:54.872Z","publishedAt":"2026-04-27T19:35:11.806352Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"hacker-news-mcp-py","url":"https://pypi.org/project/hacker-news-mcp-py/","firstSeenAt":"2026-09-09T17:20:29.709Z","fetchedAt":"2026-11-09T06:26:41.893Z","normalizedAt":"2026-11-09T06:26:41.893Z"}]},"firstSeenAt":"2026-09-09T17:20:29.709Z","updatedAt":"2026-11-09T06:27:54.872Z"}