# AGENTS.md — alpeshnakrani.com

Guide for AI agents and automated clients visiting this website. (This is a
site guide, distinct from any repository-level AGENTS.md used by coding
agents working on the source.)

## What this site is

Alpesh Nakrani's personal site: books, essays, and an "About" page. Content
is static, server-rendered HTML — no login, no paywall, no client-side
rendering required to read it.

## Where to start

- [`/llms.txt`](/llms.txt) — short, agent-oriented summary and key links
- [`/developers/`](/developers/) — human-readable index of every
  machine-readable surface below
- [`/sitemap-index.xml`](/sitemap-index.xml) — full URL list
- [`/rss.xml`](/rss.xml) — essays feed

## Machine-readable surfaces

| Purpose | Path |
|---|---|
| OpenAPI spec | `/openapi.json` |
| Agent card (A2A) | `/.well-known/agent-card.json` |
| Agent directory | `/.well-known/agents.json` |
| MCP discovery | `/.well-known/mcp.json` |
| MCP server card | `/.well-known/mcp/server-card.json` |
| WebMCP manifest | `/.well-known/webmcp.json` |
| Agent skills index | `/.well-known/agent-skills/index.json` |
| API catalog (RFC 9727) | `/.well-known/api-catalog` |
| Health | `/.well-known/health` |
| Auth guide | `/auth.md` |

## Access

Every endpoint above is public, read-only, and requires no authentication.
See [`/auth.md`](/auth.md) for the full agent-authentication statement. This
site does not currently offer write access, so agents should not expect
`/agent/register` or similar provisioning endpoints to do anything beyond
acknowledge the request.

## Content use

`robots.txt` declares `Content-Signal: search=yes, ai-input=yes, ai-train=yes`
and the `Content-Usage` response header sets `train-ai=y, search=y`: this
content may be indexed, cited, and used for AI training.

## Contact

Alpesh Nakrani — <https://alpeshnakrani.com/about/>