{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_q6xabeftrr37","handle":"mcp-server-hacker-news","url":"https://wellknown.network/agents/mcp-server-hacker-news","links":{"self":"https://wellknown.network/agents/mcp-server-hacker-news/record.json","html":"https://wellknown.network/agents/mcp-server-hacker-news","markdown":"https://wellknown.network/agents/mcp-server-hacker-news/record.md","api":"https://wellknown.network/api/v1/agents/mcp-server-hacker-news","status":"https://wellknown.network/api/v1/agents/mcp-server-hacker-news/status","claim":"https://wellknown.network/agents/mcp-server-hacker-news/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-server-hacker-news/claim.json","badge":"https://wellknown.network/agents/mcp-server-hacker-news/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-server-hacker-news/history","tools":"https://wellknown.network/api/v1/agents/mcp-server-hacker-news/tools"},"ard":{"identifier":"urn:air::server:mcp-server-hacker-news","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-server-hacker-news","summary":"Hacker News integration server for Model Context Protocol (MCP)","description":"# MCP Hacker News Server\n\nThis project is a Hacker News information retrieval server implementation for the Model Context Protocol (MCP). It uses the FastMCP framework to provide HN API functionality.\n\n## Available Tools\n\n### get_top_stories\n\nA function that retrieves the current top stories from Hacker News.\n\n- `limit` (int, optional): Number of articles to retrieve. Defaults to 10.\n  - **Returns**: A list of story object\n\n### get_story\n\nA function that retrieves details of a specific story.\n\n- `id` (string, required): The story ID to retrieve\n  - **Returns**: A story object containing title, url, score, etc.\n\n## Installation\n\n### Using `uv` (Recommended)\n\nNo special installation is required when using `uv`. You can run `mcp-server-hacker-news` directly using `uvx`.\n\n### Using PIP\n\nAlternatively, you can install `mcp-server-hacker-news` using pip:\n\n```bash\npip install mcp-server-hacker-news\n```\n\nAfter installation, you can run the server as follows:\n\n```bash\nmcp-server-hacker-news\n```\n\n## Configuration\n\n### Configure for Claude.app\n\nAdd to your Claude settings:\n\n<details>\n<summary>Using uvx</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"hacker-news\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-server-hacker-news\"]\n    }\n  }\n}\n```\n\n</details>\n\n### Configure for VS Code\n\nFor quick installation, use one of the one-click install buttons below...\n\n[![Install with UV in VS Code](https://img.shields.io/badge/VS_Code-UV-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=hacker-news&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-hacker-news%22%5D%7D)\n\n### Command Line Options\n\nYou can specify the following options when running the server:\n\n- `--sse`: Enable SSE transport\n\n  - **Choices**: `on`, `off`\n  - **Default**: `off`\n  - **Description**: Enables SSE transport when set to \"on\"\n\n- `--host`: Host to bind the server\n\n  - **Default**: `localhost`\n  - **Description**: Specifies the host…","publisher":null,"homepage":null,"repository":null,"version":"0.1.4","license":null,"protocols":["mcp"],"tags":["automation","hacker-news","llm","mcp","model-context-protocol"],"pricing":null,"endpoints":[{"url":"pypi:mcp-server-hacker-news","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.news","name":"News & Feeds","confidence":1,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.825,"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":"mcp-server-hacker-news","registry":"pypi","observedAt":"2026-10-28T13:24:51.914Z","publishedAt":"2025-06-03T16:02:49.201201Z","latestVersion":"0.1.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-server-hacker-news","url":"https://pypi.org/project/mcp-server-hacker-news/","firstSeenAt":"2026-09-10T03:20:39.642Z","fetchedAt":"2026-10-28T13:23:46.660Z","normalizedAt":"2026-10-28T13:23:46.660Z"}]},"firstSeenAt":"2026-09-10T03:20:39.642Z","updatedAt":"2026-10-28T13:24:51.914Z"}