Developers

Developer API
for Shreyansh Kumar Singh's portfolio

Structured, first-party facts about Shreyansh Kumar Singh, AI & full-stack engineer — his profile, nine project case studies, experience, skills, technical notes and FAQ answers — as a read-only JSON API with an OpenAPI 3.1 spec, an MCP server for AI agents, and a markdown view of every page. No key, no sign-up.

OpenAPI spec →Try /api/v1 llms.txt

01Quick start

Every endpoint is a plain GET that returns JSON. For example, his profile:

curl https://www.shreyanshkumarsingh.com/api/v1/profile

One project's full case study, and a search across the whole portfolio:

curl https://www.shreyanshkumarsingh.com/api/v1/projects/nythera-ai-penetration-testing-agent
curl "https://www.shreyanshkumarsingh.com/api/v1/search?q=RAG%20pipeline&limit=3"

Every response includes absolute URLs to the matching page on this site — please link or cite those.

02Endpoints

Base URL: https://www.shreyanshkumarsingh.com/api/v1
GET /profile: Get his profile. Who Shreyansh Kumar Singh is: summary, role, location, current employer, education, availability, expertise and profile links. Start here.
GET /projects: List projects. The nine independent projects with stack, case-study URL and source URL when public.
GET /projects/{slug}: Get a project case study. One project's full case study: problem, what he built, the hardest decision, the result, facts, research findings and links. Slugs come from the list endpoint.
GET /experience: Get professional experience. His production work at RamanByte Pvt. Ltd., Pune, since January 2023: company facts, how the work runs, and six case studies.
GET /skills: Get skills. Skills grouped by area, each linked to the work that evidences it.
GET /notes: List technical notes. Short technical articles, each answering one question first-hand from a system he built.
GET /notes/{slug}: Get a technical note. One note in full: the question, the direct answer, and its sections. Slugs come from the list endpoint.
GET /faq: Get FAQ answers. Every FAQ answer, grouped (about him, his work, hiring and availability).
GET /search: Search the portfolio. Keyword search across FAQ answers, project case studies and technical notes; returns the best-matching passages with URLs. Parameters: q (required, 2–200 characters), limit (1–10, default 5).
GET /contact: Get contact details. Email, contact page, location, time zone and availability. The phone number is intentionally not exposed to automated clients.

03Authentication, limits and errors

Authentication: none. The API is public and read-only — GET, HEAD and OPTIONS only. CORS is open (Access-Control-Allow-Origin: *), so you can call it from a browser.
Rate limit: 120 requests per minute per IP address. Over that you get 429 with a Retry-After header.
Caching: responses are cacheable for 5 minutes (Cache-Control); the content changes only when the site does.
Errors are always JSON with the same shape, whatever the status (400, 404, 405, 429, 500):

{
  "error": {
    "code": "not_found",
    "message": "No project with slug \"x\".",
    "hint": "Valid slugs: …",
    "docs": "https://www.shreyanshkumarsingh.com/developers"
  }
}

Contact data: the API returns his email and the contact page. The phone number is shown to people on /contact and is intentionally not available to automated clients.

04OpenAPI and function calling

The full description is at /openapi.json (OpenAPI 3.1; also at /api/openapi.json). Every operation has a unique operationId, a description, typed parameters and a response schema, so it can be imported into Postman or Insomnia, used to generate a client, or handed to an LLM as function-calling tools.

05MCP server for AI agents

The same data is available to AI assistants over the Model Context Protocol (Streamable HTTP, read-only, no auth):

https://www.shreyanshkumarsingh.com/api/mcp

Tools: get_profile, list_projects, get_project, get_experience, get_skills, search_site, get_contact, plus every page as a markdown resource. Discovery: /.well-known/mcp/server-card.json and /.well-known/ai-catalog.json.

06Markdown and plain text

Any page as markdown: request it with Accept: text/markdown, or add .md — for example /about.md or /index.md.
Summaries for language models: /llms.txt and /llms-full.txt.
New notes: RSS feed. Every page: sitemap.xml.

07Questions

Something missing or wrong? Email shreyanshkumarsingh208@gmail.com or use the contact page.

Developer APIfor Shreyansh Kumar Singh's portfolio