---
title: "For agents"
description: "Every machine-readable interface this site publishes, and how to call it."
url: https://jeffkazzee.dev/for-agents/
---

# For agents

Everything this site publishes for machine consumers, and how to call it.

The most useful thing here is the guide libraries: 1,450 free
guides and recipes. The `list_guide_libraries` tool returns them.

## Interfaces

- [/api/mcp](https://jeffkazzee.dev/api/mcp) (Model Context Protocol 2026-07-28): Streamable HTTP. POST JSON-RPC. Tools for the free guide libraries, the projects, and the writing.
- [/api/a2a](https://jeffkazzee.dev/api/a2a) (Agent2Agent 1.0): JSON-RPC binding. SendMessage returns an answer about the guides, the work, or availability.

## Discovery

- [/.well-known/api-catalog](https://jeffkazzee.dev/.well-known/api-catalog) (RFC 9727): A linkset naming every service endpoint on this domain and the document that describes it.
- [/.well-known/mcp/server-card.json](https://jeffkazzee.dev/.well-known/mcp/server-card.json) (Model Context Protocol): Where the MCP endpoint is, which transport it speaks, and what it can do.
- [/.well-known/agent-card.json](https://jeffkazzee.dev/.well-known/agent-card.json) (Agent2Agent): The agent identity for this site, its interfaces, and the skills it answers.
- [/.well-known/agent-skills/index.json](https://jeffkazzee.dev/.well-known/agent-skills/index.json) (Agent Skills discovery 0.2.0): Skills published by this site, each with a SKILL.md and a sha256 digest.
- [/.well-known/ard.json](https://jeffkazzee.dev/.well-known/ard.json) (Agentic Resource Discovery): Agentic Resource Discovery entries for the endpoints and documents on this domain.

## Content

- [/llms.txt](https://jeffkazzee.dev/llms.txt) (llmstxt.org): What this site is, what is on it, and where the machine interfaces live.
- [/llms-full.txt](https://jeffkazzee.dev/llms-full.txt) (llmstxt.org): Every guide library, project, and post, in one file.

## Policy

- [/robots.txt](https://jeffkazzee.dev/robots.txt) (RFC 9309 and Content Signals): Standard crawl directives plus Content-Signal preferences for ai-train, search, and ai-input, and an Agentmap pointer to the ARD catalog.
- [/auth.md](https://jeffkazzee.dev/auth.md) (auth.md): States that nothing here is behind a credential, and explains why no OAuth metadata is published. Read it instead of probing for a login.

## Markdown for any page

Send `Accept: text/markdown` to any URL on this domain, or append `.md` to the
path. Responses carry `Content-Type: text/markdown` and an estimated
`X-Markdown-Tokens` count.

## Calling the MCP server

```bash
curl -sX POST https://jeffkazzee.dev/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

## What is deliberately not published

This site has no user accounts and issues no credentials. `/auth.md` says so
directly, so an agent does not have to probe for a login.

There is no OAuth metadata, because those documents describe how to obtain and
present credentials for a protected resource. Nothing here is protected, so
publishing them would describe a handshake that cannot complete.