PickSkill
← Back

MarceauSolutions/hvac-quotes-mcp

README.md
Rendered from GitHub raw
View raw ↗

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