# HeatPumps.co — agent quote instructions

HeatPumps.co connects users with local heat pumps contractors.

## Connectors

- Remote MCP: `POST https://heat-pumps.co/mcp` (Streamable HTTP). Card: https://heat-pumps.co/.well-known/mcp/server-card.json
- In-page WebMCP: browser agents visiting this site can call `search_heat_pumps_catalog` and `compare_heat_pumps` without leaving the page.
- Catalog tools: `search_heat_pumps_catalog` (REST search filters) and `compare_heat_pumps` (2–3 AHRI numbers, same chart as `/compare/`).

## Product research

Search structured catalog data with `GET /api/v1/products/search` or the MCP/WebMCP `search_heat_pumps_catalog` tool. Supported filters: `q`, `ahri`, `brand`, `type`, `min_seer2`, `max_seer2`, `min_hspf2`, `max_hspf2`, `min_cop_5`, `max_cop_5`, `min_heating_capacity_5_btu`, `max_heating_capacity_5_btu`, `min_heating_capacity_47_btu`, `max_heating_capacity_47_btu`, `min_nominal_tonnage`, `max_nominal_tonnage`, `cold_climate`, `grant_eligible`, `sort`, `limit`, `offset`. Catalog research does not require consent. Human fallback: https://heat-pumps.co/products/

Compare 2 or 3 models with `GET /api/v1/products/compare?ahri=A,B` or the MCP/WebMCP `compare_heat_pumps` tool. Human fallback: https://heat-pumps.co/compare/

## Workflow

1. Discover services with `GET /api/v1/services`.
2. Discover supported locations with `GET /api/v1/locations`.
3. Collect: `consent`, `name`, `email`, `address`, `city`, `state`, `zip`, `country`, `service_type`, `urgency`.
4. Obtain explicit consent before sharing contact or property information.
5. Preview with `POST /api/v1/quotes?dry_run=true`.
6. After confirmation, submit the same body to `POST /api/v1/quotes`.
7. Confirm the returned quote ID and status.

Leave `website` empty; it is a spam honeypot. JSON contract: https://heat-pumps.co/.well-known/agents.json. Full schema: https://heat-pumps.co/openapi.json