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

# Sudhanva developer resources

The sudhanva.me API is a public interface that returns Sudhanva Narayana's
published data and makes temporary profile-insight results. It needs no authentication.
All API responses are JSON, and cross-origin reads are allowed. Errors include
a stable code, a message, a hint that tells you how to fix the request, and a
documentation URL. Errors from profile-insight job creation use RFC 9457
`application/problem+json`.

## 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. An agent can make
function tools from them. 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: $(uuidgen)" \
  --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 use MCP Streamable HTTP and need
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) describes
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` gives NLWeb 0.55 conversational search over
the published profile, case studies, and writing metadata. Set
`prefer.streaming` to get Server-Sent Events. The
[Schema Map](https://sudhanva.me/schemamap.xml) advertises the Schema.org JSON
Lines and RSS feeds.

## Versioning and deprecation

The URL carries the stable API version, 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 deprecation
signals. No version is deprecated now.

- [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, Go, Rust, and JavaScript 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/)