# Hacker News (Cloudflare Agent-Ready Edition)

> An agent-optimized Hacker News clone hosted on Cloudflare Workers and D1 SQLite.
> Designed for both human reading and autonomous AI agent consumption via Model Context Protocol (MCP), Markdown Content Negotiation, and OpenAPI.

## Core Feeds (Support 'Accept: text/markdown')
- [Top Stories](https://hackernews-agentic.pages.dev/): Frontpage stories ranked by classic HN gravity algorithm.
- [Newest Stories](https://hackernews-agentic.pages.dev/newest): Chronological feed of newest submissions.
- [Past / Best](https://hackernews-agentic.pages.dev/best): Highest scored stories of all time.
- [Ask HN](https://hackernews-agentic.pages.dev/ask): Community questions and text discussions.
- [Show HN](https://hackernews-agentic.pages.dev/show): Community projects and demonstrations.
- [Jobs](https://hackernews-agentic.pages.dev/jobs): Startup job listings.

## AI Agent Integration Endpoints
- [SEP-1649 MCP Server Card](https://hackernews-agentic.pages.dev/.well-known/mcp/server-card.json): Model Context Protocol discovery metadata.
- [MCP Protocol Endpoint](https://hackernews-agentic.pages.dev/mcp): Stateless JSON-RPC 2.0 and Streamable HTTP endpoint for AI tool calls.
- [A2A Agent Card](https://hackernews-agentic.pages.dev/.well-known/agent-card.json): Agent-to-Agent protocol manifest.
- [Agent Skills Registry](https://hackernews-agentic.pages.dev/.well-known/agent-skills/index.json): Downloadable agent skill packages.
- [OpenAPI Specification](https://hackernews-agentic.pages.dev/openapi.json): Complete REST API contract in OpenAPI 3.1.
- [RFC 9727 API Catalog](https://hackernews-agentic.pages.dev/.well-known/api-catalog): Standard RFC API discovery catalog.
- [Agent Readiness Audit](https://hackernews-agentic.pages.dev/agent-readiness): Interactive verification scorecard for Cloudflare's AI checklist.

## Content Signals Policy
- `Content-Signal: search=yes, ai-train=yes, ai-input=yes`
- Live AI input (RAG), training, and search indexing are permitted.
- For high-volume agent access, please send `Accept: text/markdown` to conserve bandwidth and token usage.