API documentation

The Builder’s Brief UK publishes a small read/write HTTP API and an MCP server so tools and agents can access our homeowner guidance. All endpoints return JSON and are rate limited.

Discovery

API catalog (RFC 9727): /.well-known/api-catalog
OpenAPI 3.1 description: /openapi.json
MCP endpoint: /mcp

Endpoints

GET /api/public/health

Health check. Returns { status, time }.

POST /api/public/checklist-signup

Request the free builder quote checklist by email. JSON body: { email, name? }.

POST /api/public/contact

Send a homeowner enquiry. JSON body: { email, name?, message }.

GET /api/public/estimate-view?token=…

Read a shared extension cost estimate using its 64-character share token.

Terms of use

Use of the API is subject to our terms and privacy policy. The Builder’s Brief UK provides practical homeowner guidance only. It is not legal, financial, architectural, structural engineering, planning or building-control advice. Always use suitably qualified professionals where required.