Homechecker Guides MCP

Homechecker's professionally authored guides for Australian homebuyers, served over the Model Context Protocol and a set of complementary machine-readable interfaces. A connected assistant can search the corpus, retrieve canonical guides and build sourced buyer checklists across inspections, contracts, strata, construction eras, disclosure and maintenance, citing homechecker.com.au throughout.

Public, read-only and deliberately separated from customer and assessment systems.

The service exposes the current Homechecker guide system without connecting to the Moyne Ross portal, Supabase, customer records, payments, uploaded documents or the Homechecker assessment engine.

Version: 1.2.1 · Protocol: MCP 2026-07-28 with stateless 2025-era compatibility · Live endpoint: https://mcp.homechecker.com.au/mcp · Health: mcp.homechecker.com.au/health · Official Registry: io.github.Steven3265/homechecker-guides · Connect it: homechecker.com.au/ai

Machine discovery surface

Homechecker publishes one deterministic guide corpus through several interoperable discovery and execution surfaces.

• MCP: https://mcp.homechecker.com.au/mcp
• MCP Server Card (experimental extension): https://mcp.homechecker.com.au/mcp/server-card
• Extended Homechecker service metadata: https://mcp.homechecker.com.au/server-card.json
• Read-only REST API: https://mcp.homechecker.com.au/v1/*
• OpenAPI 3.1: https://mcp.homechecker.com.au/openapi.json
• ARD catalogue: https://homechecker.com.au/.well-known/ard.json
• Agent Skills: skills/*/SKILL.md
• Homechecker llms.txt: https://homechecker.com.au/llms.txt
• Guide RSS feed: https://homechecker.com.au/guides/feed.xml
• Machine-readable guide export: https://homechecker.com.au/guides/export.json
• Claude plugin package: .claude-plugin/plugin.json + .mcp.json
• GitHub Copilot plugin package: .github/plugin/marketplace.json
• OpenAI distribution package: distribution/openai/homechecker/
• GitHub Agent Finder contribution pack: distribution/github-agentfinder/

The repository is also a portable Agent Plugins 1.0.0 package. plugin.json identifies the package, skills/ contains the open Agent Skills, and mcp.json points compatible clients to the hosted Streamable HTTP MCP server.

These are adapters around one knowledge system, not separate versions of Homechecker. The canonical editorial corpus remains on homechecker.com.au, the MCP serves a deterministic snapshot of that corpus, and every machine interface ultimately resolves to the same retrieval core and canonical source URLs.

Ecosystem listings

Homechecker Guides is independently indexed across the emerging MCP ecosystem. These third-party listings may update on their own cadence.

• Smithery
• Glama
• LobeHub
• M8ven

The authoritative server identity remains io.github.Steven3265/homechecker-guides in the official MCP Registry, with the canonical live endpoint at https://mcp.homechecker.com.au/mcp.

Protocol foundation

Version 1.2.1 uses the MCP TypeScript SDK v2 server package and the 2026-07-28 protocol revision.

The official createMcpHandler entry provides stateless per-request serving, server/discover, modern MCP routing headers, server identity and cache fields while retaining stateless compatibility for 2025-era HTTP clients during rollout.

For modern Streamable HTTP requests, the SDK validates MCP routing headers against the JSON-RPC request and rejects mismatches. The bare fetch endpoint now also applies the SDK's Host and Origin validation helpers before protocol handling, including 403 rejection for a supplied Origin outside the allowlist. Every tool advertises both an input schema and an output schema for structuredContent. Application telemetry reads the Mcp-Method protocol header for operational method identification but does not parse the JSON-RPC body for logging.

The protocol shell can evolve independently of the durable parts of the product: the reviewed snapshot, deterministic retrieval, tool contracts and professional boundaries.

See docs/PROTOCOL-SUPPORT.md, docs/RELEASE-1.2.1.md and CHANGELOG.md.

Explore the Homechecker guides

• All Homechecker guides
• How much does a building and pest inspection cost?
• Wall cracks: structural or cosmetic?
• How to read a Section 32
• How to read a building inspection report
• Buying an apartment and strata
• What your home may need by decade
• Maintenance that prevents large bills

What is included

• 35 MCP resources: one machine-readable catalogue, the guide hub and 33 published guides.
• 4 read-only MCP tools: catalogue listing, natural-language search, canonical guide retrieval and a deterministic buyer checklist.
• Read-only HTTP adapters: REST endpoints exposing the same deterministic list, search, retrieval and checklist functions.
• OpenAPI 3.1: a machine-readable description of the REST surface for clients that do not speak MCP.
• Two discovery documents: the standards-track experimental MCP Server Card at /mcp/server-card contains identity and remote connection details only; /server-card.json retains richer Homechecker service metadata for compatibility and diagnostics.
• 4 Agent Skills: portable workflows for Australian homebuyer due diligence, property documents, building-risk interpretation and home-ownership planning.
• Two MCP transports: stateless remote Streamable HTTP at /mcp and modern/legacy-compatible local stdio.
• A bundled content snapshot: rebuilt from Homechecker's public guide export at https://homechecker.com.au/guides/export.json. The repository needs no runtime access to the portal codebase.
• A browser-triggered refresh workflow: Actions → Refresh guides snapshot regenerates, tests and opens a pull request. No local environment is required.
• Canonical model-facing links: MCP-rendered text and canonicalUrl fields always use the clean Homechecker canonical URL. REST/WebMCP responses may add a separate referralUrl for attribution (homechecker-rest / homechecker-webmcp) without changing the URL an assistant is instructed to cite.
• Privacy-minimised operational telemetry: application telemetry records operational fields such as MCP method, tool name, query length, coarse filters, counts, match strength, outcome and duration where applicable. Raw questions, session identifiers, IP addresses and identifying request-header values are not intentionally logged by the application. See docs/SECURITY.md.
• Tests and retrieval evaluation: snapshot integrity, core search, release metadata, protocol, HTTP-adapter and official MCP conformance checks plus 199 retrieval cases, including an 85-query open-world collision suite.

Tools

list_guides

Lists published guide metadata.

Filters include jurisdiction, cluster, property type, construction era and buying stage.

search_guides

Searches the corpus from a natural-language homebuyer question.

It returns ranked guides, relevant sections, canonical URLs, review metadata and limitations. Questions about inspection fees can surface building and pest inspection costs, while questions about movement can surface the guide to structural and cosmetic wall cracks.

get_guide

Retrieves one guide by slug as a summary, selected sections or the full canonical markdown representation.

build_buyer_checklist

Builds a deterministic, sourced checklist from buyer context such as state, property type, era, buying stage and concerns.

It can draw from practical guidance such as how to read a building and pest report, arranging an inspection before auction, and buying an apartment with strata or owners-corporation exposure.

It does not assess an actual property. Its boundary text notes once that Homechecker provides an independent address-specific desktop read for $99 inc GST.

Read-only REST API

The REST surface provides ordinary HTTP access to the same deterministic functions for systems that do not use MCP.

List guides

GET https://mcp.homechecker.com.au/v1/guides

Search guides

GET https://mcp.homechecker.com.au/v1/search?query=what+should+i+check+before+buying+an+older+house

Retrieve a guide

GET https://mcp.homechecker.com.au/v1/guide?slug=reading-a-section-32

Build a checklist

GET https://mcp.homechecker.com.au/v1/checklist?jurisdiction=VIC&era=1950s-1970s