ampworth-com

ampworth-com Discovery API

Where everything else is.

Documentation GitHub OpenAPI

Operations 2

GET /api/v1 Discovery #

GET /api/v1/openapi.json This description #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/ampworth-com:ampworth-com-discovery-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  description: 'Open and unauthenticated: no key, no sign-up, and CORS open to any origin. Requests are rate limited per address. Every path here also answers under /api in place of /api/v1, identically and permanently; a later version will get a prefix of its own and leave both alone. These calculators follow the published MCS methods, for understanding a system and checking a quotation. Anything that gets installed still needs a design and a site survey from a certified installer.'
  summary: UK home energy calculators and reference material, following the published MCS standards.
  title: Ampworth Discovery API
  version: '1.0'
servers:
- url: https://ampworth.com
security: []
tags:
- description: Where everything else is.
  name: Discovery
paths:
  /api/v1:
    get:
      description: 'The calculator ids, the document endpoints and the two MCP URLs: everything needed to find the rest.'
      operationId: discovery
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Discovery'
          description: OK
        '429':
          $ref: '#/components/responses/429'
      summary: Discovery
      tags:
      - Discovery
  /api/v1/openapi.json:
    get:
      description: The OpenAPI 3.1 description of this API.
      operationId: openapi
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
          description: OK
        '429':
          $ref: '#/components/responses/429'
      summary: This description
      tags:
      - Discovery
components:
  schemas:
    Discovery:
      properties:
        alias:
          description: The short address, which answers exactly as this version does and never moves to a later one.
          type: string
        calculators:
          properties:
            count:
              type: integer
            describe:
              type: string
            detail:
              type: string
            ids:
              items:
                type: string
              type:
              - 'null'
              - array
            index:
              type: string
          required:
          - index
          - count
          - detail
          - ids
          - describe
          type: object
        description:
          type: string
        documents:
          properties:
            categories:
              type: string
            detail:
              type: string
            documents:
              type: integer
            index:
              type: string
            kinds:
              items:
                type: string
              type:
              - 'null'
              - array
            perspectives:
              type: string
            questions:
              type: integer
            search:
              type: string
          required:
          - index
          - search
          - categories
          - perspectives
          - detail
          - kinds
          - documents
          - questions
          type: object
        mcp:
          properties:
            all:
              type: string
            calculators:
              type: string
            documents:
              type: string
            transport:
              type: string
          required:
          - all
          - calculators
          - documents
          - transport
          type: object
        name:
          type: string
        notice:
          type: string
        openapi:
          description: The OpenAPI 3.1 description of this API.
          type: string
        standards:
          type: string
        version:
          type: string
      required:
      - name
      - version
      - description
      - openapi
      - alias
      - calculators
      - documents
      - mcp
      - standards
      - notice
      type: object
    Error:
      properties:
        error:
          properties:
            code:
              type: string
            fields:
              items:
                properties:
                  field:
                    type: string
                  message:
                    type: string
                required:
                - field
                - message
                type: object
              type:
              - 'null'
              - array
            message:
              type: string
          required:
          - code
          - message
          type: object
      required:
      - error
      type: object
  responses:
    '429':
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Too many requests from this address. Wait for the number of seconds in Retry-After.
      headers:
        Retry-After:
          schema:
            type: integer
externalDocs:
  description: The developer page, with the MCP servers as well
  url: https://ampworth.com/developers