Vivek Sharma — Developer Resources

API endpoints and the MCP server exposed by Vivek Sharma's portfolio, for agents and tools that want to call it directly instead of scraping HTML.

MCP server

Model Context Protocol server using the Streamable HTTP transport. Point any MCP client at the endpoint below to call Vivek Sharma's profile, projects, skills, and experience as tools instead of scraping this site.

https://the-vivek-sharma.vercel.app/api/mcphttps://the-vivek-sharma.vercel.app/.well-known/mcp

Tools: get_profile, list_projects, get_project, list_skills, list_experience, get_contact_info.

REST API

Full OpenAPI 3.1 specification (operation IDs, typed request/response schemas, structured error codes) published at /openapi.json.

Versioned by URL path — /api/v1/* is current. /api/health and /api/contact are permanent, unversioned aliases of the same endpoints (no separate removal timeline); a breaking change ships as /api/v2/* instead of altering /v1/* in place. Every response carries an API-Version header.

GET https://the-vivek-sharma.vercel.app/api/v1/health

Liveness check. Returns { status: "ok", timestamp }. Not rate-limited.

POST https://the-vivek-sharma.vercel.app/api/v1/contact

Submits the contact form (name, email, message, recaptchaToken). Rate-limited to 3 requests per IP per 10 minutes — every response carries RateLimit and RateLimit-Policy headers (draft-ietf-httpapi-ratelimit-headers), plus Retry-After on a 429.

Every error response is JSON: { error: { code, message, hint } } — no HTML error pages on /api/*.

Machine-readable files