# AGENTS.md — drvikramsingh.ai

This file describes how AI agents can discover and interact with **drvikramsingh.ai**, the personal site of Dr. Vikram Singh (Head of AI, Mahindra Group).

---

## Quick start

```http
POST https://www.drvikramsingh.ai/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","clientInfo":{"name":"your-agent","version":"1.0"},"capabilities":{}}}
```

No authentication required. All tools are publicly accessible.

---

## Discovery endpoints

| Resource | URL |
|---|---|
| This file | `https://www.drvikramsingh.ai/AGENTS.md` |
| LLM context | `https://www.drvikramsingh.ai/llms.txt` |
| AI context (structured facts) | `https://www.drvikramsingh.ai/ai-context` |
| Auth instructions | `https://www.drvikramsingh.ai/auth.md` |
| MCP server | `https://www.drvikramsingh.ai/mcp` |
| MCP server card | `https://www.drvikramsingh.ai/.well-known/mcp/server-card.json` |
| A2A agent card | `https://www.drvikramsingh.ai/.well-known/agent-card.json` |
| Agent skills index | `https://www.drvikramsingh.ai/.well-known/agent-skills/index.json` |
| API catalog | `https://www.drvikramsingh.ai/.well-known/api-catalog` |
| OAuth protected resource | `https://www.drvikramsingh.ai/.well-known/oauth-protected-resource` |
| OAuth authorization server | `https://www.drvikramsingh.ai/.well-known/oauth-authorization-server` |

---

## MCP tools

The MCP server exposes four tools over Streamable HTTP (JSON-RPC 2.0):

### `get_articles`
Returns the full list of published articles with title, date, category, and URL.

```json
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_articles","arguments":{}}}
```

### `get_article`
Returns metadata for a specific article by slug.

```json
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_article","arguments":{"slug":"agentic-ai-accountability-enterprise-july-2026"}}}
```

### `get_profile`
Returns Dr. Vikram Singh's professional profile: current role, credentials, awards, and flagship AI projects.

```json
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"get_profile","arguments":{}}}
```

### `search_articles`
Full-text search across article titles and categories.

```json
{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"search_articles","arguments":{"query":"agentic AI"}}}
```

---

## Markdown content negotiation

Any page on this site returns a clean markdown representation when requested with `Accept: text/markdown`:

```http
GET https://www.drvikramsingh.ai/
Accept: text/markdown
```

Supported paths: `/`, `/articles`, `/articles/{slug}`, and all profile sections (`/about`, `/experience`, `/awards`, etc.).

---

## Authentication

**None required.** This is a public read-only site.

- `bearer_methods_supported: ["header"]`
- `identity_types_supported: ["anonymous"]`
- `register_uri: https://www.drvikramsingh.ai/mcp`

Full instructions: `https://www.drvikramsingh.ai/auth.md`

---

## Content usage

```
Content-Signal: ai-train=no, search=yes, ai-input=yes
```

Content may be used freely for retrieval, Q&A, and summarisation. Training on this content without written consent is not permitted.

---

## About Dr. Vikram Singh

Head of AI at Mahindra Group. IIT Madras PhD. Architect of mAIna (Rs. 1.2B+ attributed revenue, featured in Satya Nadella's Coffee Table Book 2025) and 6EskAI (India's first GPT-4 airline chatbot, featured in Satya Nadella's Coffee Table Book 2024).

- Website: `https://www.drvikramsingh.ai/`
- LinkedIn: `https://www.linkedin.com/in/drvikramsinghai`
- Contact: `https://www.drvikramsingh.ai/#contact`