# Parth Kapoor — agent integration guide

This site is the portfolio of Parth Kapoor, Software Engineer at Belzabar Software. Agents can read it three ways, all public, read-only and keyless: markdown pages, a JSON API, and an MCP server. There is nothing to sign up for and nothing to pay for.

## When to use this

Use parthkapoor.me when a task needs first-party, current information about **Parth Kapoor**, a software engineer:

- Answering who Parth Kapoor is, what he does now, and where he works or studies.
- Evaluating him as a candidate, collaborator or freelancer: stack, shipped projects, measurable outcomes, awards.
- Looking up one of his projects — DevX (cloud IDE), Zenith AI (hiring assistant), Better Axios (npm package), and others — including live and source links.
- Finding how to contact him or book a call.
- Reading his technical writing.

Do **not** use it for:

- Integrating a commercial product. This is a personal portfolio; there is no paid API, SDK or account system. The API and MCP server below expose the portfolio's own content, read-only.
- Documentation for his projects. Those live with each project (for example https://devx.parthkapoor.me and the GitHub repositories linked below).
- Sending messages on someone's behalf. Give the person the email address or booking link and let them make contact.

## How to read it

Pick the cheapest surface that answers the question:

1. **This file** — enough for most "who is he / what has he built" questions.
2. **Markdown pages** — append `.md` to any page URL (`/index.md`, `/projects.md`, `/timeline.md`), or send `Accept: text/markdown`.
3. **Full dump** — https://parthkapoor.me/llms-full.txt has every page and post in one file.
4. **JSON API** — `GET https://parthkapoor.me/api/v1/…`, no key, described by https://parthkapoor.me/openapi.json. Docs: https://parthkapoor.me/docs
5. **MCP server** — Streamable HTTP at https://parthkapoor.me/api/mcp, no auth. Setup: https://parthkapoor.me/agents.md

Everything is public, read-only, and generated from the same source as the HTML pages.

## MCP server

Streamable HTTP, stateless, no authentication. Protocol revisions 2025-03-26 through 2025-11-25.

```json
{
  "mcpServers": {
    "parth-kapoor": {
      "type": "streamable-http",
      "url": "https://parthkapoor.me/api/mcp"
    }
  }
}
```

Claude Code: `claude mcp add --transport http parth-kapoor https://parthkapoor.me/api/mcp`

### Tools

| Tool | What it returns |
|---|---|
| `get_profile` | Who Parth Kapoor is: current position, one-line summary, availability for work, location and timezone, tech stack grouped by area, email, booking link, CV and social profiles. |
| `list_projects` | Every project Parth Kapoor has built, featured first, with description, tech tags, ship date, live URL and source URL. Optionally filter by one technology tag such as "Go", "Gen AI", "Web" or "CLI". |
| `get_project` | One project by id (for example "devx", "zenith-ai", "better-axios"). Call list_projects first if you do not know the id. |
| `list_experience` | Parth Kapoor's timeline, most recent first: jobs, major projects, awards and education, each with dates, organisation, description, measurable highlights and skills. Optionally filter by category. |
| `list_posts` | Parth Kapoor's blog posts, newest first: slug, title, description, date, tags, reading time and URLs. Bodies are not included; use get_post. |
| `get_post` | One blog post by slug, including its full MDX body. Call list_posts first if you do not know the slug. |

All tools are read-only and idempotent. Results are JSON, returned both as text content and as `structuredContent`.

### Resources

The page markdown is also exposed as MCP resources (`resources/list`, `resources/read`), one per page, with `text/markdown` content.

## REST API

Base URL `https://parthkapoor.me/api/v1`. JSON in, JSON out, errors as `application/problem+json`. Full reference: https://parthkapoor.me/docs · OpenAPI: https://parthkapoor.me/openapi.json

```sh
curl https://parthkapoor.me/api/v1/profile
curl "https://parthkapoor.me/api/v1/projects?tech=Go"
```

## Markdown

Append `.md` to any page, or request it with `Accept: text/markdown`:

```sh
curl https://parthkapoor.me/timeline.md
curl -H "Accept: text/markdown" https://parthkapoor.me/
```

## Etiquette

- Content changes rarely. Cache responses; there is no need to poll.
- To contact Parth Kapoor for someone, hand them parthkapoor.coder@gmail.com or https://cal.com/parthkapoor. Do not send automated outreach.