Energy Machines · REST / MCP

Developers

Build engineering discovery tools using the same published catalogue as this website. REST and MCP return the same data, with no account or API key required.

Inquiry-led catalogue: no prices, ordering or write operations. Assistants can prepare an inquiry for human review; submit it yourself using the product page or contact the engineering team.

Public REST API

https://heatpumps.energymachines.com/api/public/v1

OpenAPI 3.1 JSON

GET	MCP tool
`/families`	`list_product_families`
`/products`	`search_products`
`/products/{slug}`	`get_product`
`/products/compare`	`compare_products`
`/documents`	`list_documents`
`/documents/{document_id}`	`get_document_url`
`/cases`	`list_cases`
`/cases/{slug}`	`get_case`
`/company`	`get_company_info`
`/inquiry`	`how_to_inquire`

Example requests

curl 'https://heatpumps.energymachines.com/api/public/v1/products?locale=fi&measurement_system=metric&limit=2'
curl 'https://heatpumps.energymachines.com/api/public/v1/families'
curl 'https://heatpumps.energymachines.com/api/public/v1/cases?limit=2'

MCP for assistants

https://heatpumps.energymachines.com/mcp · Streamable HTTP · POST · JSON · stateless

claude mcp add --transport http energy-machines https://heatpumps.energymachines.com/mcp

{
  "mcpServers": {
    "energyMachines": {
      "url": "https://heatpumps.energymachines.com/mcp"
    }
  }
}

MCP server card

Languages, units and filters

All operations accept locale and measurement_system codes configured by the catalogue. Omit them for site defaults. Missing translations use the public page fallback; the returned locale identifies the actual translation. Numeric search filters always use kW and degrees C. Lists accept offset and limit (default 25); follow next_offset until null. Compare slugs use a comma-separated list. The OpenAPI document describes every parameter and response.

Rate limits and caching

REST and MCP share a process-local quota: by default 120 requests per client and 3,000 globally per 60 seconds. Operators may configure these limits. HTTP 429 includes Retry-After in seconds. REST supports ETag / If-None-Match and public caching for 60 seconds (shared caches: 300 seconds). MCP is no-store. REST allows any browser origin for GET; MCP permits the site and approved assistant origins. Tool name and outcome are counted in anonymous daily aggregates; arguments and IPs are never included in those aggregates.

Terms of use

Use public catalogue data for engineering discovery and cite the canonical product and document URLs. Respect caching and Retry-After. Availability and specifications may change. Confirm duty, source/supply temperatures, fluids and simultaneous operating conditions with Energy Machines before design or procurement. This service offers no performance guarantee.