APIs and MCP servers

Lists the calculator IDs, the document endpoints, and the two MCP URLs.

curl https://ampworth.com/api/v1

Lists the two MCP servers in the Agentic Resource Discovery (ARD) format, so an agent can find them from the domain alone. The older address, /.well-known/ai-catalog.json, serves the same file.

curl https://ampworth.com/.well-known/ard.json

Describes the whole API in OpenAPI 3.1. Each calculator has its own path, with request and result schemas inferred from the code that runs it. You can load it into a client generator, Postman, or Swagger UI.

curl https://ampworth.com/api/v1/openapi.json

Returns every calculator, the Microgeneration Certification Scheme (MCS) standard it follows, a worked example request, and the URL that runs it.

curl https://ampworth.com/api/v1/calculators

Returns the fields it takes as a JSON Schema, an example request, and the reference data those fields draw on, such as the solar zones and the design locations.

curl https://ampworth.com/api/v1/calculators/solar-pv-output

Send the request as JSON. The API rejects unknown fields rather than ignoring them, so a typo returns an error instead of a wrong answer.

curl -X POST https://ampworth.com/api/v1/calculators/solar-pv-output \
  -H 'Content-Type: application/json' \
  -d '{"postcode":"BS1 5TR","capacityKwp":4.4,"orientation":30,"inclination":35}'

Put the fields in the query string instead of a JSON body, with each parameter named after its JSON field. For a list field, such as a room's elements, send the JSON array as the value. The answer is the same as for a POST, and an unknown parameter returns an error. Use this from a client that can follow a link but can't send a request body, such as an assistant that browses the web. Each calculator's description includes a working exampleUrl.

curl 'https://ampworth.com/api/v1/calculators/solar-pv-output?postcode=BS1+5TR&capacityKwp=4.4&orientation=30&inclination=35'

Lists every guide, article, and question set. To filter the list, add ?kind= or ?category=. To include the full text, add ?full=true.

curl 'https://ampworth.com/api/v1/documents?kind=guide'

Searches titles, summaries, and text, and ranks the results. When a query matches one question in a question set, the response includes that question and its answer.

curl 'https://ampworth.com/api/v1/documents/search?q=flow+temperature'

Returns the full text as Markdown, with the MCS documents it draws on and any calculators that do its arithmetic.

curl https://ampworth.com/api/v1/documents/guides/sizing-a-heat-pump

This stateless server uses streamable HTTP and has every tool from the two servers below, so one connection gives you the calculators and the documents. Use it with a client that connects one server per integration, such as a ChatGPT plugin.

{
  "mcpServers": {
    "ampworth": {
      "type": "http",
      "url": "https://ampworth.com/mcp"
    }
  }
}

This stateless server uses streamable HTTP and exposes every calculator as a tool, plus list_calculators. Its schemas come from the same structs that the JSON API decodes.

{
  "mcpServers": {
    "ampworth-calculators": {
      "type": "http",
      "url": "https://ampworth.com/mcp/calculators"
    }
  }
}

This stateless server uses streamable HTTP and has three tools: search_documents, get_document, and list_documents.

{
  "mcpServers": {
    "ampworth-documents": {
      "type": "http",
      "url": "https://ampworth.com/mcp/documents"
    }
  }
}