# Agent guide for ashwingopalsamy.in

This is the public, read-only guide for agents using Ashwin Gopalsamy's website. It describes deployed interfaces only. It is not the repository's private authoring guide.

## Start with the source of truth

- [AI guide](https://ashwingopalsamy.in/ai/) for the maintained profile briefing.
- [llms.txt](https://ashwingopalsamy.in/llms.txt) for concise context.
- [Profile summary JSON](https://ashwingopalsamy.in/api/ai-summary.json) for one authoritative machine-readable object.
- [Sitemap in Markdown](https://ashwingopalsamy.in/sitemap.md) for the public page inventory.
- [API catalog](https://ashwingopalsamy.in/.well-known/api-catalog) for discovery links.

If a fact is not covered by these sources, report that it is not covered rather than inferring it.

## Retrieve pages as Markdown

HTML is the default. Send `Accept: text/markdown` to request a Markdown representation of any HTML page. The response uses `Content-Type: text/markdown`, varies on `Accept`, and may include `x-markdown-tokens`.

Direct Markdown aliases are available for the core pages: [home](https://ashwingopalsamy.in/index.md), [AI](https://ashwingopalsamy.in/ai.md), [FAQ](https://ashwingopalsamy.in/faq.md), [work](https://ashwingopalsamy.in/craft.md), [library](https://ashwingopalsamy.in/library.md), [links](https://ashwingopalsamy.in/links.md), [more](https://ashwingopalsamy.in/more.md), and [colophon](https://ashwingopalsamy.in/colophon.md). Published notes also expose raw Markdown at their normal path with `.md` appended.

## MCP

The site exposes a stateless Streamable HTTP MCP server at `https://ashwingopalsamy.in/mcp`.

- Use `POST /mcp` for MCP JSON-RPC requests.
- `GET /mcp` intentionally returns `405 Method Not Allowed` with discovery links and `Allow: POST, OPTIONS`.
- [MCP Server Card](https://ashwingopalsamy.in/.well-known/mcp/server-card.json) is the canonical card.
- [MCP compatibility manifest](https://ashwingopalsamy.in/.well-known/mcp.json) remains available for older discovery clients.
- [MCP catalog](https://ashwingopalsamy.in/mcp/catalog.json) lists the exact tools, resources, prompts, input schemas, annotations, and public data URLs.
- [MCP status](https://ashwingopalsamy.in/mcp/status.json) reports non-sensitive transport and read-only status.

The MCP tools only search or retrieve public site data. They do not create sessions, write content, issue credentials, access accounts, or process payments.

## WebMCP

When the site is loaded in a compatible browser, it registers equivalent read-only tools through WebMCP. WebMCP is browser registration only. It is not an HTTP endpoint and does not replace the MCP `POST /mcp` transport.

## Boundaries

All agent-facing surfaces on this personal site are read-only discovery or retrieval interfaces. Authentication metadata is discovery-only and unavailable for credential issuance. A2A and commerce compatibility documents do not accept mandates, payments, or checkout actions.