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

# Sudhanva developer resources

The sudhanva.me API is a public interface for retrieving Sudhanva Narayana's
published data and composing temporary profile-insight results. 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
- `POST /api/v1/profile-insights` — create an idempotent insight job
- `GET /api/v1/profile-insights/{job_id}` — poll an insight job
- `POST /api/v1/batch` — combine up to 20 public profile and post reads

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'
curl -sS https://sudhanva.me/api/v1/profile-insights \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: recruiter-example-001' \
  --data '{"audience":"recruiter","focus":["production-ml"]}'
```

## MCP

The documentation and public-data MCP endpoint is `https://sudhanva.me/mcp`.
The separate action endpoint `https://sudhanva.me/mcp/product` creates and polls
temporary profile-insight jobs. Both implement MCP Streamable HTTP and require
no authentication.
The [MCP server card](https://sudhanva.me/.well-known/mcp/server-card.json)
advertises the connection details.

The [A2A Agent Card](https://sudhanva.me/.well-known/agent-card.json) advertises
the grounded public research agent. The [auth.md walkthrough](https://sudhanva.me/auth.md)
documents a separate protected profile mirror for testing anonymous agent auth.

## NLWeb and Schema Feeds

`POST https://sudhanva.me/ask` implements NLWeb 0.55 conversational search over
the published profile, case studies, and writing metadata. Set
`prefer.streaming` to receive Server-Sent Events. The
[Schema Map](https://sudhanva.me/schemamap.xml) advertises the Schema.org JSON
Lines and RSS feeds.

## 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/)
- [NLWeb and Schema Feed guide](https://sudhanva.me/developers/nlweb/)
- [Profile-insights guide](https://sudhanva.me/docs/profile-insights/)
- [Official CLI](https://sudhanva.me/developers/cli/)
- [Official Python, Ruby, and Go SDKs](https://sudhanva.me/developers/sdks/)
- [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/)