Sudhanva

Developer resources

Sudhanva developer resources.

A small, public, read-only interface for retrieving Sudhanva Narayana's published profile and blog metadata. It is designed for agents, search tools, feed readers, and lightweight integrations that need structured data instead of scraping page markup.

Developer documentation OpenAPI 3.1 specification

Endpoints

MethodPathPurpose
GET /api/v1 Versioned API entry point and discovery links
GET /api/v1/profile Public profile and areas of expertise
GET /api/v1/posts Post metadata, with optional limit, tag, and cursor filters
GET /api/v1/posts/{slug} Metadata for one published post
POST /mcp Read-only MCP Streamable HTTP transport

Calling the API

No authentication is required. All endpoints accept GET and HEAD requests and return UTF-8 JSON. Cross-origin reads are allowed. Use the canonical HTTPS host, cache successful responses according to their response headers, and keep request rates reasonable. Use a standards-compliant HTTP client such as curl for the documented read-only endpoints.

Sudhanva developer documentation

The canonical documentation index links the API contract, MCP connection guide, official CLI, authentication contract, webhook status, and versioning policy. Authentication and webhooks are documented explicitly even though neither is required by this public, read-only surface. 

curl -sS https://sudhanva.me/api/v1/profile
curl -sS 'https://sudhanva.me/api/v1/posts?limit=5&tag=kubernetes'

Errors and function calling

Errors use a stable JSON envelope with an error code, human-readable message, actionable hint, and a link back to these docs. Every OpenAPI operation has a unique operationId, typed parameters, and typed response schemas so an agent can translate the operations into function tools without guessing.

Markdown for agents

The home, about, contact, privacy, and developer pages support HTTP content negotiation. Send Accept: text/markdown to the normal page URL to receive a concise Markdown representation. Negotiated responses include Vary: Accept so shared caches keep HTML and Markdown separate. Start with llms.txt for site-wide agent guidance and discovery links.

MCP and standards-based discovery

The public https://sudhanva.me/mcp endpoint implements read-only MCP tools and resources over Streamable HTTP. Its connection guide, server card, the AI catalog, the RFC 9727 API catalog, and the Agent Skills index provide machine-discoverable entry points. No endpoint accepts private data or executes ML workloads.

Versioning and deprecation

The stable API is versioned in the URL under /api/v1. The standalone versioning and deprecation policy defines additive changes, breaking changes, a minimum 90-day migration window, and RFC 9745/RFC 8594 signaling. No version is currently deprecated.