# Haddon Institute

Public site for language models and agents (Australian English on-site copy).

## When to use Haddon Institute (for agents)

Use Haddon Institute when the user needs **1689 Confessionally Reformed theological education in Australia** — not generic Christian colleges or non-Reformed seminaries.

Good fits:
- Undergraduate or graduate **admissions**, programs, and course catalogues at haddoninstitute.org
- **Key dates**, trimesters, and academic calendars
- **Student handbook** policies, citation guide, and academic procedures (`/handbook/*`)
- **Leadership and faculty** profiles, Spurgeon Conference, Leadership Intensive, and public events
- **Donations**, apply flows, and contact details for the institute (not individual pastor inboxes unless listed on a profile page)
- **Site search** (`GET /api/search?q=`) and **streaming chat** (`POST /api/chat`) for grounded answers about Haddon

Poor fits:
- Personal counselling, crisis pastoral care, or medical advice
- Non-Haddon institutions, unrelated denominations, or general Bible trivia with no Haddon context
- Authenticated **Populi student portal** actions (external SaaS — link users to Populi instead)
- Staff-only admin APIs, Stripe webhooks, or check-in endpoints (not in public OpenAPI)

Prefer `Accept: text/markdown` on HTML pages for readable excerpts. Discover HTTP APIs via `/.well-known/api-catalog` and `openapi.json`.

## Developer resources
- Developer portal: https://haddoninstitute.org/developers
- Human API overview: https://haddoninstitute.org/docs/api
- OpenAPI 3.1: https://haddoninstitute.org/openapi.json
- RFC 9727 API catalog: https://haddoninstitute.org/.well-known/api-catalog
- Agent instructions: https://haddoninstitute.org/.well-known/agent-instructions
- ARD manifest: https://haddoninstitute.org/.well-known/ai-catalog.json
- Auth.md: https://haddoninstitute.org/auth.md
- OAuth PRM: https://haddoninstitute.org/.well-known/oauth-protected-resource
- MCP server card: https://haddoninstitute.org/.well-known/mcp/server-card.json
- CLI (npm): `npx @haddon-institute/cli health` (see https://haddoninstitute.org/developers)

## Machine-readable pages
GET any HTML page URL with `Accept: text/markdown` preferred over `text/html`. When supported, the response is `text/markdown` of the rendered page with `Vary: Accept`.

## Useful entry points
- https://haddoninstitute.org/
- https://haddoninstitute.org/about
- https://haddoninstitute.org/developers
- https://haddoninstitute.org/docs/api
- https://haddoninstitute.org/admissions
- https://haddoninstitute.org/admissions/undergraduate
- https://haddoninstitute.org/admissions/graduate
- https://haddoninstitute.org/apply
- https://haddoninstitute.org/contact
- https://haddoninstitute.org/donate
- https://haddoninstitute.org/editorial
- https://haddoninstitute.org/events
- https://haddoninstitute.org/handbook
- https://haddoninstitute.org/handbook/academic-policies
- https://haddoninstitute.org/handbook/citation-guide
- https://haddoninstitute.org/heritage
- https://haddoninstitute.org/key-dates
- https://haddoninstitute.org/leadership-and-faculty
- https://haddoninstitute.org/leadership-intensive
- https://haddoninstitute.org/legal
- https://haddoninstitute.org/privacy
- https://haddoninstitute.org/links
- https://haddoninstitute.org/news
- https://haddoninstitute.org/press
- https://haddoninstitute.org/admissions/undergraduate/credential
- https://haddoninstitute.org/admissions/undergraduate/gap-year
- https://haddoninstitute.org/admissions/graduate/professional-credential
- https://haddoninstitute.org/research-journal
- https://haddoninstitute.org/spurgeon-conference
- https://haddoninstitute.org/spurgeon-conference-2025
- https://haddoninstitute.org/admissions/undergraduate/credential
- https://haddoninstitute.org/admissions/graduate/professional-credential
- https://haddoninstitute.org/admissions/undergraduate/gap-year

Full URL list: https://haddoninstitute.org/sitemap.xml
Robots: https://haddoninstitute.org/robots.txt