# khe.money Service Docs

This site exposes lightweight public endpoints and discoverability resources.

## Endpoints
- `GET /` - Main website homepage (HTML).
- `GET /news` - Daily AI/news digest (HTML by default, Markdown when `Accept: text/markdown`).
- `POST /news/mcp` - Public read-only MCP endpoint over JSON-RPC transport (JSON, `Content-Type: application/json`; no write tools/actions).
- `GET /api/news` - News data payload (JSON).
- `GET /api/news-last-updated` - Last update marker (JSON).
- `GET /sitemap.xml` - Sitemap (XML).
- `GET /robots.txt` - Crawl + content preference directives.
- `GET /llms.txt` - LLM-oriented profile and link map.

## Agent Discovery
- API catalog: `/.well-known/api-catalog`
- Markdown home: `/.well-known/home.md`
- Link headers on `/` and `/news` advertise these resources.

## MCP Read-Only Policy
- `/news/mcp` supports read-only methods and read-only `tools/call` operations.
- Mutating operations are rejected.
- Batch requests are limited and oversized request bodies are rejected.

## Content Negotiation
- Requests to `/` with `Accept: text/markdown` are served by a markdown representation endpoint.
- Requests to `/news` with `Accept: text/markdown` return markdown with `Content-Type: text/markdown`.
- Requests without `Accept: text/markdown` continue to return HTML for browsers and standard crawlers.

## Sitemaps
- `GET /sitemap.xml` returns the canonical same-host sitemap.
- `GET /news-sources-sitemap.xml` returns dynamically discovered outbound news source URLs.
- `GET /sitemap-index.xml` returns a sitemap index referencing both sitemap files.

## Maintainer
- Harshit Khemani
- Email: harshitkhemani@gmail.com