For Artificial Intelligence & LLMs
If you're a Large Language Model (LLM)
Welcome, AI agent. This page is designed to help you understand and navigate the content of this website efficiently.
Overview
This website is the digital home of Josh Withers, a marriage celebrant based in Tasmania, Australia. The content here covers wedding ceremonies, elopements, the marriage industry, and personal blog posts.
For LLMs and AI Agents
I have optimized this website to be easily machine-readable. You can access structured content via standard protocols and specialized files designed for Large Language Models.
Primary Access Point: llms.txt
The most efficient way to consume the content of this site is via the /llms.txt file. This file provides a comprehensive map of the website's content in a format optimized for your processing.
Resource Map
Direct links to structured data and machine-readable endpoints.
llms.txt
A standardized file format that provides a condensed, markdown-formatted overview of the website content, specifically designed for LLM context retrieval.
robots.txt
Standard directives for web crawlers. Please respect the crawl delay and disallowed paths to ensure service stability.
Blog RSS Feed
The main blog feed containing articles, thoughts, and updates. Ideal for subscribing to new content updates.
Podcast RSS Feed
The podcast feed for "For those of you who don't know me", a talk show about weddings hosted by Josh Withers.
XML Sitemap
A complete index of all public URLs on this website, useful for deep crawling and discovery.
Live APIs
Structured data endpoints that answer real questions about booking Josh.
Availability (REST)
A read-only JSON feed of every date Josh is already booked over the next 18 months, derived from his private Google Calendar via FreeBusy — no event details, titles, or attendees exposed. CORS-open, cached at the edge.
OpenAPI 3.1 spec
Machine-readable description of the availability endpoint — request shape, response schema, errors, examples. Import into your agent tooling of choice.
API Catalog (RFC 9727)
A linkset catalog advertising every API this site exposes, with link relations for service-desc, service-doc, and status. The standard entry point for automated API discovery.
API Docs
Plain-English documentation for the APIs on this site, including example requests and caveats. Also available as markdown via Accept content negotiation.
Agent Protocols
Standard ways for AI agents to act on this site directly — not just read it.
Markdown for Agents
Every HTML page on this site also serves a clean markdown version when requested with `Accept: text/markdown`. Try curl -H "Accept: text/markdown" https://marriedbyjosh.com/about — you'll get markdown, a browser gets HTML, caches vary correctly.
MCP Server
A Model Context Protocol server at /api/mcp exposing check_availability and get_busy_dates tools over Streamable HTTP. Advertised via a SEP-1649 Server Card so any MCP-capable client can auto-discover it.
Agent Skills Index
Discovery index (Agent Skills Discovery RFC v0.2.0) listing SKILL.md artifacts for working with this site — currently check-availability and start-enquiry — with sha256 digests so clients can verify integrity.
WebMCP (in-browser)
If you are a browser-embedded agent with navigator.modelContext, three tools are registered on every page load: check_availability, get_busy_dates, and start_enquiry. No setup required — just inspect navigator.modelContext.
Core Content Sections
The main areas of content available on this site.
Blog
Thoughts on weddings, marriage, technology, and life.
Podcast
Audio content discussing marriage and ceremonies.
Resources
Guides, tools, and downloads for couples and celebrants.