MarceauSolutions/hvac-quotes-mcp

mcp-name: io.github.wmarceau/hvac-quotes

HVAC equipment RFQ (Request for Quote) management via MCP for Claude Desktop.

Features

• Submit RFQs to HVAC equipment distributors
• Check RFQ status and track responses
• Get and compare quotes from multiple distributors
• Simulate quotes for testing workflows

Installation

pip install hvac-quotes-mcp

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "hvac-quotes": {
      "command": "hvac-quotes-mcp",
      "env": {
        "HVAC_MOCK_EMAIL": "true"
      }
    }
  }
}

Available Tools

submit_rfq

Submit a Request for Quote to HVAC distributors.

Equipment types: ac_unit, furnace, heat_pump, air_handler, condenser,
                 evaporator_coil, mini_split, thermostat, ductwork, other

check_rfq_status

Check the status of a submitted RFQ.

get_quotes

Get all quotes received for an RFQ.

compare_quotes

Compare quotes from multiple distributors - identifies best price, fastest delivery, and recommended option.

simulate_quote

(Testing) Simulate a quote response from a distributor without waiting for real email responses.

Example Usage

Ask Claude:

"I need a 3-ton AC unit delivered to Naples, FL. Can you get me quotes from distributors?"

Claude will:

1. Submit RFQs to matching distributors in Florida
2. Return RFQ IDs for tracking
3. You can check status later or simulate quotes for testing

Environment Variables

Variable	Description	Default
HVAC_MOCK_EMAIL	Use mock email mode for testing	true
SMTP_HOST	SMTP server hostname	-
SMTP_PORT	SMTP server port	587
SMTP_USER	SMTP username	-
SMTP_PASS	SMTP password	-
SMTP_FROM	From email address	-
HVAC_DB_PATH	SQLite database path	temp directory

How It Works

Unlike instant-response APIs, this MCP models real-world HVAC procurement:

1. RFQ Submission: Sends email requests to distributors (mocked by default)
2. Async Response: Distributors respond in 24-48 hours (simulate for testing)
3. Quote Comparison: Compare received quotes for best value

License

MIT