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.

Try it live

Real requests to the endpoints above, run from your browser — no auth, nothing hidden. Hover a button to see the equivalent curl command.

Liveness check

Plain REST GET, no auth, not rate-limited.

MCP: get_profile

Profile, skills, and social links.

MCP: list_projects

Every shipped project, with stack and links.

MCP: get_contact_info

How to reach Vivek — email, phone, contact form path.

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