Developers & AI Agents

Everything on this site is available to software and AI agents without an account. The API and MCP server below are read-only, need no authentication, and allow cross-origin requests.

Markdown pages

Every page has a Markdown version at its URL followed by index.md. Each HTML page also advertises it with a Link: <…/index.md>; rel="alternate"; type="text/markdown" response header.

curl https://rajeshpraharaj.com/tech-articles/ai-agents/index.md

Public content API

Base URL: https://rajeshpraharaj.com/api/public/v1/

Method	Path	Purpose
GET	/api/public/v1/articles.json	All tech articles and blog posts (title, description, URL, Markdown URL, tags).
GET	/api/public/v1/tools.json	All browser-based developer tools and AI tools.
GET	/api/public/v1/health	Health check. Returns {"status":"ok"}.
GET	/api/public/v1/openapi.json	OpenAPI 3.1 description of this API.

MCP server

Endpoint: https://rajeshpraharaj.com/mcp (Streamable HTTP transport, JSON responses, no authentication).

Tool	Purpose
search_content	Keyword search across articles and tools.
list_articles	Page through tech articles and blog posts.
list_tools	List developer tools and AI tools.
get_page_markdown	Return the Markdown version of any site page.

Example client configuration:

{
  "mcpServers": {
    "rajeshpraharaj": {
      "type": "http",
      "url": "https://rajeshpraharaj.com/mcp"
    }
  }
}

In-browser tools (WebMCP)

In browsers that support WebMCP, each page registers search_site, list_site_tools, get_page_markdown, and navigate_to_page through document.modelContext.

Discovery documents

Path	Purpose
/.well-known/api-catalog	RFC 9727 API catalog (application/linkset+json).
/.well-known/mcp/server-card.json	MCP server card.
/.well-known/ai-catalog.json	Agentic Resource Discovery (ARD) catalog.
/.well-known/agent-skills/index.json	Agent Skills discovery index.
/llms.txt	llms.txt index of every article and tool, linking to Markdown versions.
/llms-full.txt	Full Markdown text of every page listed in llms.txt, in one file.
/robots.txt	Crawl rules and Content Signals.

Every HTML response also carries RFC 8288 Link headers that point to the API catalog, the OpenAPI description, this page, and the Markdown version of the page.