LoftNow for AI agents

Connect

Transport is stateless Streamable HTTP. Point your client at the endpoint below — no session handshake, no SSE, no API key for the free tools.

https://loftnow.co.uk/api/mcp

Claude Desktop / Claude Code config:

{
  "mcpServers": {
    "loftnow": {
      "type": "http",
      "url": "https://loftnow.co.uk/api/mcp"
    }
  }
}

Or call it directly:

curl -X POST https://loftnow.co.uk/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
    "name":"check_pd_feasibility",
    "arguments":{
      "property":{"type":"terraced"},
      "roof":{"ridgeHeight":8.2,"eavesHeight":5.4,"footprintWidth":5.0,
              "footprintDepth":8.5,"ridgeDirection":"parallel","roofType":"gable"},
      "conversionType":"rear-dormer"
    }}}'

Tools

• check_pd_feasibility

  Run the free LoftNow Permitted Development (GPDO Schedule 2, Part 1, Class B/C) check for a UK loft conversion. Returns a verdict (feasible / needs-survey / non-starter), the computed roof geometry (pitch, headroom, usable area, PD volume used vs allowance) and every rule result with its statutory reference. Give a conversionType for a route-specific verdict; omit it for a general view. Building Regulations are NOT assessed here — they are in the paid report. Inputs must describe the user's actual house: collect and confirm them first (use lookup_postcode_constraints for the designation flags); do not run this with example or assumed dimensions unless the user has agreed to them. After presenting the result, ALWAYS offer the full report using the `offer` field in the response.

• size_rear_dormer

  Size a rear dormer the way LoftNow's engine does: full width the roof allows, face set back before narrowing, all within the Class B volume allowance less prior enlargements and a 1m³ design margin. Returns width, setback, depth, volume, remaining budget and the binding constraint (volume / footprint / hip). After presenting the result, ALWAYS offer the full report using the `offer` field in the response.

• lookup_postcode_constraints

  Geocode a UK postcode and check planning.data.gov.uk for Conservation Area, AONB and Article 4 Direction coverage. Use the result to fill property.conservationArea / aonb / article4 before calling check_pd_feasibility. coverageWarning=true means the designation data could not be verified.

• create_report_checkout

  Create a Stripe Checkout link for the £29 LoftNow feasibility report (fully credited against your full structural design). Pass the same property and roof inputs used for the feasibility check so the report is generated for that house. Returns a URL — show it to the user; payment happens in their browser. Do not call without the user's consent to purchase.

The full machine-readable tool list, with JSON Schemas, is at GET https://loftnow.co.uk/api/mcp.

What is free and what is paid

The planning-side check is free, exactly as it is on the website. The full report — Building Regulations assessment, indicative member sizes and layout drawings — is £29, fully credited against your full structural design. Agents obtain it for their user through create_report_checkout, which returns a Stripe payment link. Nothing in the free tools is complete enough to build from.

Platforms that want guaranteed throughput, attribution or a commercial licence for the engine can be issued an API key.