# Agent guide — benmcadams.info

You've reached the personal site of **Ben McAdams** (Senior engineer at Zapier, building agents.).
This document is written for AI agents visiting the site — human-readable but structured for machine consumption.

## MCP server

Streamable HTTP endpoint: https://benmcadams.info/api/mcp

Available tools:
- `about` — Quick summary of the site and available tools.
- `get_resume` — Full JSON Resume of Ben McAdams.
- `list_writing` — List blog posts (metadata only).
- `get_post` — Get the full markdown of a post by slug.
- `search_writing` — Keyword search over post bodies.
- `get_portfolio` — Portfolio of agent, DX, and product work.

Server card: https://benmcadams.info/.well-known/mcp.json
Also mirrored at: https://benmcadams.info/.well-known/mcp/server-card.json

## Markdown mirrors

Every page has a markdown-formatted mirror. Two ways to access:

1. Append `.md` to any page URL — e.g. `/resume.md`, `/writing/hello-world.md`
2. Send `Accept: text/markdown` on the canonical URL

Full content bundle: https://benmcadams.info/llms-full.txt (all pages, all posts, in one document)

## Discovery files

- https://benmcadams.info/llms.txt — Index for language models
- https://benmcadams.info/llms-full.txt — Full content bundle
- https://benmcadams.info/sitemap.xml — Sitemap (XML)
- https://benmcadams.info/sitemap.md — Sitemap (markdown)
- https://benmcadams.info/feed.xml — RSS feed of writing
- https://benmcadams.info/robots.txt — Crawler directives
- https://benmcadams.info/.well-known/ai-catalog.json — Agent capability catalog (ARD)
- https://benmcadams.info/.well-known/mcp.json — MCP server card
- https://benmcadams.info/agents.json — Root agent manifest

## Writing

- [Hello, world](https://benmcadams.info/writing/hello-world.md) — 2026-07-12
- [Notes on agent discovery](https://benmcadams.info/writing/agent-discovery-notes.md) — 2026-07-10

## Contact

- GitHub: https://github.com/BenMcGit
- LinkedIn: https://www.linkedin.com/in/benmcgit/