Energy Machines · MCP / REST
Use the Energy Machines catalogue from an AI agent
Our public MCP server gives AI assistants read-only access to the same published catalogue as this website: products, specifications, datasheets and installation cases. No account or API key is needed.
1. Tell your agent to use it
Paste this into your agent's instructions or the start of a conversation:
Use the Energy Machines public MCP server at https://heatpumps.energymachines.com/mcp (Streamable HTTP, no authentication) for anything about Energy Machines industrial heat pumps. Start by reading the catalogue_overview resource to learn the valid locales, units and filters. Then use search_products, get_product and compare_products, and cite the canonical product and datasheet URLs you used. Treat nominal ratings and individual temperature limits as screening data, not a confirmed operating point, and say clearly what is unknown. Never submit anything: when I want to inquire, use how_to_inquire to prepare a draft for me to review and send myself.If your agent cannot add MCP servers but can make web requests, give it the REST API instead: https://heatpumps.energymachines.com/api/public/v1 (OpenAPI description: https://heatpumps.energymachines.com/api/public/v1/openapi.json).
2. Add the server to your client
Server URL: https://heatpumps.energymachines.com/mcp. Transport: Streamable HTTP. Authentication: none.
https://heatpumps.energymachines.com/mcpClaude Code
claude mcp add --transport http energy-machines https://heatpumps.energymachines.com/mcpClaude apps: Settings → Connectors → Add custom connector, then paste the server URL.
Clients configured with an mcpServers JSON file
{
"mcpServers": {
"energy-machines": {
"url": "https://heatpumps.energymachines.com/mcp"
}
}
}Other clients may call this a remote MCP server or a custom connector. Choose HTTP / Streamable HTTP and no authentication.
3. Things to ask
We have 30 °C waste water from a process cooling loop and need about 1.5 MW of heat at 60 °C. Which Energy Machines heat pumps could fit? Explain your assumptions.Compare the specifications of the two best candidates side by side and link their datasheets.Find installation cases similar to a district-heating project and summarise them.Draft an inquiry about the selected heat pump for me to review. Do not send it.What the server offers
Tools
list_ | List public families containing published products. Use their stable slugs in the family filter. |
search_ | Search published products. Numeric filters use canonical kW and degrees C. Follow next_offset; confirm design-point performance with the manufacturer. |
get_ | Read a published product, flexible specifications, public media and documents. Missing values are unknown, never zero. |
compare_ | Compare the union of specification keys across published products; missing values are null. |
list_ | List public documents linked to published products; never the asset library or internal paths. |
get_ | Resolve a document still linked to a published product. Does not download its contents. |
list_ | List published installation case studies with canonical URLs and public product reference text. |
get_ | Read a published installation case, public media and converted flexible specifications. |
get_ | Read only known public company, technology, history and contact sections. |
how_ | Explain human-reviewed inquiry preparation. No drafts, email sending or submissions are performed. |
Prompts
select_ | Builds a shortlist from public catalogue evidence, asking for missing duty and temperature conditions. |
draft_ | Drafts an inquiry for a selected product, for human review. Never submits. |
Resources
energymachines:/ | Start here: locales, measurement systems, units, families and valid filter tokens. |
energymachines:/ | Published product families. |
energymachines:/ | A full published product. |
Languages, units, limits
The catalogue is inquiry-led: there are no prices, orders or write operations. Agents can prepare an inquiry draft; a person submits it from the product page or contacts the engineering team.
Kaikki toiminnot hyväksyvät mallistoon määritetyt locale- ja measurement_system-koodit. Ilman niitä käytetään sivuston oletuksia. Puuttuva käännös korvataan julkisen sivun varakäännöksellä; vastauksen locale kertoo käytetyn kielen. Numeeriset hakurajat annetaan aina kilowatteina ja Celsius-asteina. Listojen offset ja limit (oletus 25) ohjaavat sivutusta; jatka next_offset-arvosta kunnes se on null. Vertailun slugs on pilkuilla erotettu lista. OpenAPI kuvaa kaikki parametrit ja vastaukset.
REST ja MCP jakavat prosessikohtaisen kiintiön: oletuksena 120 pyyntöä asiakkaalta ja yhteensä 3 000 pyyntöä 60 sekunnissa. Ylläpitäjä voi muuttaa rajoja. HTTP 429 sisältää Retry-After-odotusajan sekunteina. REST tukee ETag / If-None-Match -otsakkeita sekä julkista 60 sekunnin välimuistia (jaettu välimuisti: 300 sekuntia). MCP käyttää no-store-käytäntöä. REST sallii selaimen GET-pyynnöt kaikista alkuperistä; MCP sallii sivuston ja hyväksytyt avustajat. Vain toiminnon nimi ja tuloksen tila lasketaan anonyymeihin päiväkoosteisiin, ei argumentteja tai IP-osoitteita.
REST API
The REST API returns the same data as the MCP tools. Each MCP tool has a GET endpoint under https://heatpumps.energymachines.com/api/public/v1.
REST-rajapinnan kuvaus · OpenAPI 3.1 description
Example requests
curl 'https://heatpumps.energymachines.com/api/public/v1/products?limit=2'
curl 'https://heatpumps.energymachines.com/api/public/v1/products?min_heating_capacity_kw=1000&min_supply_temp_c=60&min_source_temp_c=30'
curl 'https://heatpumps.energymachines.com/api/public/v1/families'
curl 'https://heatpumps.energymachines.com/api/public/v1/cases?limit=2'Terms of use
Käytä julkisia tietoja suunnittelun esiselvitykseen ja viittaa tuotteiden ja dokumenttien kanonisiin osoitteisiin. Noudata välimuistia ja Retry-After-aikaa. Tiedot ja saatavuus voivat muuttua. Vahvista teho, lähde- ja menolämpötilat, nesteet ja samanaikaiset käyttöolosuhteet Energy Machinesilta ennen suunnittelua tai hankintaa. Palvelu ei anna suorituskykytakuuta.