{
  "name": "HeatPumps.co",
  "version": "1.0",
  "description": "HeatPumps.co heat pumps directory and free quote matching. Collect answers in conversation and submit via the quote API with explicit user consent.",
  "site": "https://heat-pumps.co",
  "action": {
    "id": "submit_heat_pumps_quote",
    "aliases": [
      "request_heat_pumps_quote",
      "request_quote",
      "submitQuoteRequest"
    ],
    "method": "POST",
    "url": "https://heat-pumps.co/api/v1/quotes",
    "content_type": "application/json",
    "consent_required": true,
    "consent": "User must explicitly agree to share contact and property details for contractor matching.",
    "required": [
      "consent",
      "name",
      "email",
      "address",
      "city",
      "state",
      "zip",
      "country",
      "service_type",
      "urgency"
    ],
    "optional": [
      "phone",
      "details",
      "agent_source",
      "agent_version",
      "submission_method",
      "home_size"
    ],
    "honeypot": "website",
    "enums": {
      "state": [
        "AL",
        "AK",
        "AZ",
        "AR",
        "CA",
        "CO",
        "CT",
        "DE",
        "FL",
        "GA",
        "HI",
        "ID",
        "IL",
        "IN",
        "IA",
        "KS",
        "KY",
        "LA",
        "ME",
        "MD",
        "MA",
        "MI",
        "MN",
        "MS",
        "MO",
        "MT",
        "NE",
        "NV",
        "NH",
        "NJ",
        "NM",
        "NY",
        "NC",
        "ND",
        "OH",
        "OK",
        "OR",
        "PA",
        "RI",
        "SC",
        "SD",
        "TN",
        "TX",
        "UT",
        "VT",
        "VA",
        "WA",
        "WV",
        "WI",
        "WY",
        "DC"
      ],
      "submission_method": [
        "openapi",
        "mcp",
        "webmcp",
        "agent-skill"
      ],
      "service_type": [
        "air_source",
        "mini_split",
        "ducted",
        "geothermal",
        "commercial",
        "repair"
      ],
      "urgency": [
        "emergency",
        "soon",
        "week",
        "flexible"
      ]
    },
    "example": {
      "consent": true,
      "name": "Jane Doe",
      "email": "jane@example.com",
      "address": "123 King St W",
      "city": "Toronto",
      "state": "AL",
      "zip": "10001",
      "country": "US",
      "agent_source": "chatgpt",
      "submission_method": "openapi",
      "service_type": "air_source",
      "urgency": "emergency"
    },
    "dry_run": {
      "query": "https://heat-pumps.co/api/v1/quotes?dry_run=true",
      "description": "Validate a payload without creating a quote record."
    },
    "human_fallback": "https://heat-pumps.co/quote/"
  },
  "actions": [
    {
      "id": "submit_heat_pumps_quote",
      "aliases": [
        "request_heat_pumps_quote",
        "request_quote",
        "submitQuoteRequest"
      ],
      "method": "POST",
      "url": "https://heat-pumps.co/api/v1/quotes",
      "content_type": "application/json",
      "consent_required": true,
      "consent": "User must explicitly agree to share contact and property details for contractor matching.",
      "required": [
        "consent",
        "name",
        "email",
        "address",
        "city",
        "state",
        "zip",
        "country",
        "service_type",
        "urgency"
      ],
      "optional": [
        "phone",
        "details",
        "agent_source",
        "agent_version",
        "submission_method",
        "home_size"
      ],
      "honeypot": "website",
      "enums": {
        "state": [
          "AL",
          "AK",
          "AZ",
          "AR",
          "CA",
          "CO",
          "CT",
          "DE",
          "FL",
          "GA",
          "HI",
          "ID",
          "IL",
          "IN",
          "IA",
          "KS",
          "KY",
          "LA",
          "ME",
          "MD",
          "MA",
          "MI",
          "MN",
          "MS",
          "MO",
          "MT",
          "NE",
          "NV",
          "NH",
          "NJ",
          "NM",
          "NY",
          "NC",
          "ND",
          "OH",
          "OK",
          "OR",
          "PA",
          "RI",
          "SC",
          "SD",
          "TN",
          "TX",
          "UT",
          "VT",
          "VA",
          "WA",
          "WV",
          "WI",
          "WY",
          "DC"
        ],
        "submission_method": [
          "openapi",
          "mcp",
          "webmcp",
          "agent-skill"
        ],
        "service_type": [
          "air_source",
          "mini_split",
          "ducted",
          "geothermal",
          "commercial",
          "repair"
        ],
        "urgency": [
          "emergency",
          "soon",
          "week",
          "flexible"
        ]
      },
      "example": {
        "consent": true,
        "name": "Jane Doe",
        "email": "jane@example.com",
        "address": "123 King St W",
        "city": "Toronto",
        "state": "AL",
        "zip": "10001",
        "country": "US",
        "agent_source": "chatgpt",
        "submission_method": "openapi",
        "service_type": "air_source",
        "urgency": "emergency"
      },
      "dry_run": {
        "query": "https://heat-pumps.co/api/v1/quotes?dry_run=true",
        "description": "Validate a payload without creating a quote record."
      },
      "human_fallback": "https://heat-pumps.co/quote/"
    },
    {
      "id": "search_heat_pumps_catalog",
      "method": "GET",
      "url": "https://heat-pumps.co/api/v1/products/search",
      "consent_required": false,
      "human_fallback": "https://heat-pumps.co/products/"
    }
  ],
  "documentation": {
    "html": "https://heat-pumps.co/quote/",
    "agents_md": "https://heat-pumps.co/agents.md",
    "agents_json": "https://heat-pumps.co/.well-known/agents.json",
    "openapi": "https://heat-pumps.co/openapi.json",
    "quote_json": "https://heat-pumps.co/.well-known/quote.json",
    "mcp": "https://heat-pumps.co/.well-known/mcp/server-card.json",
    "webmcp_tool": "submit_heat_pumps_quote"
  }
}