# Dr. Frank Lipman Developer and Agent Resources

> Public, read-only discovery and retrieval resources for the Dr. Frank Lipman website.

## Available resources

- [llms.txt](https://www.drfranklipman.com/llms.txt): Curated LLM-oriented index with when-to-use guidance.
- [Agent instructions](https://www.drfranklipman.com/agent-instructions.md): Best-fit jobs, safety boundaries, retrieval steps, and citation guidance.
- [XML sitemap](https://www.drfranklipman.com/sitemap.xml): Complete public page and article inventory.
- [robots.txt](https://www.drfranklipman.com/robots.txt): Crawler permissions and sitemap discovery.
- [Homepage Markdown](https://www.drfranklipman.com/index.md): Explicit Markdown alternate for the homepage.
- [Public API index](https://www.drfranklipman.com/api): JSON catalog of the read-only published-content API.
- [OpenAPI specification](https://www.drfranklipman.com/openapi.json): OpenAPI 3.1.1 contract with typed parameters, response schemas, errors, and unique operation IDs.
- [MCP registry manifest](https://www.drfranklipman.com/mcp/server.json): Registry-compatible manifest for the remote MCP server.
- [MCP discovery card](https://www.drfranklipman.com/.well-known/mcp.json): Pre-connection server, transport, resource, and tool metadata.

## Markdown content negotiation

Public human-readable pages support the registered `text/markdown` media type on their canonical URLs:

```sh
curl -H "Accept: text/markdown" https://www.drfranklipman.com/
```

Markdown responses use `Content-Type: text/markdown; charset=utf-8`, include `Accept` in `Vary`, advertise the canonical HTML representation with an HTTP `Link` header, and return the same meaningful 404 or 410 status as the requested resource. Explicit `.md` siblings are also available for link-aware clients.

## Public content API

The unauthenticated REST API provides read-only access to already-published articles and podcasts:

```sh
curl "https://www.drfranklipman.com/api/v1/content?q=resilience&author=frank"
```

Errors follow RFC 9457 Problem Details using `application/problem+json`, stable `code` values, readable messages, and `resolution_hint` guidance. The complete contract is published at [openapi.json](https://www.drfranklipman.com/openapi.json).

## MCP server

The public MCP server is available at [https://www.drfranklipman.com/mcp](https://www.drfranklipman.com/mcp) using Streamable HTTP. It exposes two read-only tools: `search_published_content` and `get_published_content`. The server also publishes `llms.txt`, the OpenAPI document, and its server card as MCP resources.

## Capability boundaries

The API and MCP server provide public editorial retrieval only. They do not expose patient data, private editorial data, authentication, webhooks, appointment booking, form submission, or any write operation. Health content remains general education, not individualized medical advice.