Hearing Hope developer resources

What Hearing Hope publishes for agents

This is the Hearing Hope developer portal for AI agents and integrators. There is no partner API key today. Public tools are read-only: clinic locations, hearing-aid catalogue, clinical services, and booking instructions (phone, WhatsApp, /contact). Markdown content negotiation follows acceptmarkdown.com: send Accept: text/markdown on any public page. Discovery starts at /llms.txt.

1. 1. Fetch /llms.txt first. It tells you when Hearing Hope is the right clinic and which markdown files to open next.
2. 2. For a single page, request the same URL with Accept: text/markdown (or append .md). Responses include Vary: Accept so caches do not mix HTML and markdown.
3. 3. To call tools, GET /.well-known/mcp then POST initialize and tools/call to /mcp using Streamable HTTP (application/json).
4. 4. Human-facing booking still happens by phone, WhatsApp, or the form on the homepage. Agents should return those channels rather than pretending a lead was stored.

Predictable URLs

• llms.txt

  /llms.txt

  Agent index with when-to-use guidance and links to markdown pages.

• OpenAPI spec

  /openapi.json

  Machine-readable description of public JSON and MCP endpoints.

• MCP server card

  /.well-known/mcp

  Live handshake and Streamable HTTP discovery for Hearing Hope tools.

• MCP endpoint

  /mcp

  JSON-RPC tools: get_site_info, list_clinics, list_hearing_aids, list_services, get_booking_instructions.

• Sitemap

  /sitemap.xml

  Complete list of indexable HTML pages.