akashpriyadarshi.is-a.dev developer resources: API, MCP server, llms.txt

Every machine-readable surface on this personal portfolio site. No auth, no keys, no rate-pain: read-only endpoints with per-instance buckets advertised in RateLimit headers. No write API exists; collaboration goes through the human contact links.

Surfaces

Any page, Accept: text/markdown (or .md suffix) — Markdown negotiation: Agent-readable page text
/llms.txt — Agent guide: Index + when-to-use guidance
/llms-full.txt — Full dump: Every post and project in one file
POST /mcp — MCP server: 7 tools: get_profile, list_projects, get_project, list_posts, get_post, get_contact_options, search_site
/mcp/server-card — Server card: Pasteable client config (also /.well-known/mcp)
/api/v1/ — JSON API: Read-only, typed in /openapi.json
/openapi.json — OpenAPI spec: application/openapi+json
/sitemap.xml — Sitemap: Every public page
/feed.xml — RSS feed: Latest essays

Errors

Every /api error is RFC 9457 application/problem+json with stable codes:

bad_request (400) — invalid input, e.g. bad slug or missing ?q=
not_found (404) — unknown path or id/slug
method_not_allowed (405) — writes rejected; read-only API, Allow header tells what works

Rate limits

RateLimit-Policy: "default";q=120;w=60 and RateLimit ride on every /api and /mcp response. Buckets are per server instance (serverless has no shared store), so treat them as a live signal, not a global cap.

Contact: ydv.akash2006@gmail.com · https://akashpriyadarshi.is-a.dev