---
title: Sudhanva developer resources
description: Read-only API endpoints, OpenAPI contract, errors, and usage guidance.
canonical: https://sudhanva.me/developers/
last-updated: 2026-08-22
---

# Sudhanva developer resources

The sudhanva.me API is a public, read-only interface for retrieving Sudhanva
Narayana's published profile and blog metadata. No authentication is required.
All API responses are JSON, cross-origin reads are allowed, and errors include
a stable code, a message, a resolution hint, and a documentation URL.

## Endpoints

- `GET /api/v1` — versioned discovery document
- `GET /api/v1/profile` — public profile and expertise
- `GET /api/v1/posts` — post metadata; optional `limit`, `tag`, and `cursor` filters
- `GET /api/v1/posts/{slug}` — metadata for one published post

The [OpenAPI 3.1 specification](https://sudhanva.me/openapi.json) defines unique
operation IDs, typed parameters, and response schemas suitable for generating
function tools. Use a standard HTTP client, cache successful reads, and keep
request rates reasonable.

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

## MCP

The public MCP Streamable HTTP endpoint is `https://sudhanva.me/mcp`. It
implements JSON-RPC 2.0 initialization plus tools and resources for the same
published data. All exposed tools are read-only and require no authentication.
The [MCP server card](https://sudhanva.me/.well-known/mcp/server-card.json)
advertises the connection details.

## Versioning and deprecation

The stable API is versioned in the URL under `/api/v1`. The standalone
[versioning and deprecation policy](https://sudhanva.me/developers/versioning/)
defines a minimum 90-day migration window and RFC 9745/RFC 8594 signaling. No
version is currently deprecated.

- [Developer documentation index](https://sudhanva.me/docs/)
- [MCP connection guide](https://sudhanva.me/developers/mcp/)
- [Official CLI](https://sudhanva.me/developers/cli/)
- [Authentication](https://sudhanva.me/docs/authentication/)
- [Webhooks](https://sudhanva.me/docs/webhooks/)
- [Agent guide](https://sudhanva.me/llms.txt)
- [Detailed agent instructions](https://sudhanva.me/agent-instructions.md)
- [Privacy](https://sudhanva.me/privacy/)