---
title: Agent and API docs
description: Machine-readable surfaces for sneharamchandani.com, all public and read-only.
canonical: https://www.sneharamchandani.com/docs
last-updated: 2026-09-15
---

# Agent and API docs

Every surface here is public and read-only. There is no authentication, no API key, and no
write endpoint.

## Endpoints

- `GET / POST https://www.sneharamchandani.com/ask` - natural language questions over published content (NLWeb 0.55). JSON or SSE.
- `POST https://www.sneharamchandani.com/mcp` - MCP server (Streamable HTTP, JSON-RPC 2.0) with profile, blog, FAQs, and contact tools.
- `POST https://www.sneharamchandani.com/mcp/docs` - documentation MCP server for search and reading.
- `GET https://www.sneharamchandani.com/openapi.json` - OpenAPI 3.1 description of /ask and /mcp.
- `GET https://www.sneharamchandani.com/llms.txt` - when-to-use guidance and navigation index.
- `GET https://www.sneharamchandani.com/.well-known/api-catalog` - RFC 9727 API catalog.
- `GET https://www.sneharamchandani.com/.well-known/agent-card.json` - A2A agent card.
- `GET https://www.sneharamchandani.com/.well-known/mcp/server-card.json` - MCP server card.

## Markdown

Every page is available as markdown by appending `.md` or sending `Accept: text/markdown`.

## Versioning and deprecation

URLs are versioned by path prefix, currently /v1/. Breaking changes ship under a new
prefix and older prefixes keep working for at least 12 months. A deprecated version
announces its end with Deprecation and Sunset response headers at least 90 days ahead
(RFC 9745 and RFC 8594).

## Errors

Errors use RFC 9457 application/problem+json with a stable code and a resolution hint.
API paths return a 401 with a WWW-Authenticate hint pointing at
https://www.sneharamchandani.com/.well-known/oauth-protected-resource.

Sitemap: https://www.sneharamchandani.com/sitemap.xml
Agent guide: https://www.sneharamchandani.com/llms.txt