Public read-only interface
Dr. Frank Lipman developer and agent resources.
These resources help agents and developers discover and retrieve public editorial content without changing the experience for human visitors.
Available resources
- llms.txt →
Curated agent index with when-to-use guidance.
- Agent instructions →
Best-fit jobs, safety boundaries, and retrieval guidance.
- Public API index →
JSON catalog for the read-only published-content API.
- OpenAPI 3.1.1 →
Typed operations, parameters, responses, and Problem Details errors.
- MCP manifest →
Registry-compatible manifest for the Streamable HTTP server.
- MCP discovery card →
Public transport, capability, resource, and tool metadata.
- XML sitemap →
Complete public page and article inventory.
- robots.txt →
Crawler permissions and sitemap discovery.
Markdown content negotiation
Canonical public pages serve Markdown when the client prefers the registered text/markdown media type. Explicit .md alternates are advertised for link-aware clients.
curl -H "Accept: text/markdown" https://www.drfranklipman.com/Markdown responses include the correct content type, an HTTP alternate link, and Accept in the Vary header. Missing and retired resources retain meaningful 404 and 410 statuses.
Public content API
The unauthenticated REST API provides read-only search and retrieval for already-published articles and podcasts. Every operation has a unique operation ID, typed parameters, typed response schemas, and documented Problem Details errors in the OpenAPI specification.
curl "https://www.drfranklipman.com/api/v1/content?q=resilience&author=frank"MCP server
The public MCP endpoint at /mcp uses Streamable HTTP and exposes two read-only tools: search_published_content and get_published_content. It also publishes the agent index, OpenAPI document, and server card as resources.
Connect to https://www.drfranklipman.com/mcp. No API key is required.
Errors and capability boundaries
REST errors use application/problem+json with a stable code, message, and resolution hint. The API and MCP server expose no patient data, private editorial data, authentication, webhooks, appointment booking, form submission, or write operations. Health content remains general education, not individualized medical advice.
INVALID_ARGUMENT— correct the listed fields using the OpenAPI contract.NOT_FOUND— search the content endpoint or consult the sitemap.METHOD_NOT_ALLOWED— use GET, HEAD, or OPTIONS.