HVAC Quotes MCP

1# HVAC Quotes MCP
2 
3mcp-name: io.github.wmarceau/hvac-quotes
4 
5HVAC equipment RFQ (Request for Quote) management via MCP for Claude Desktop.
6 
7## Features
8 
9- **Submit RFQs** to HVAC equipment distributors
10- **Check RFQ status** and track responses
11- **Get and compare quotes** from multiple distributors
12- **Simulate quotes** for testing workflows
13 
14## Installation
15 
16```bash
17pip install hvac-quotes-mcp
18```
19 
20## Claude Desktop Configuration
21 
22Add to your `claude_desktop_config.json`:
23 
24```json
25{
26  "mcpServers": {
27    "hvac-quotes": {
28      "command": "hvac-quotes-mcp",
29      "env": {
30        "HVAC_MOCK_EMAIL": "true"
31      }
32    }
33  }
34}
35```
36 
37## Available Tools
38 
39### submit_rfq
40Submit a Request for Quote to HVAC distributors.
41 
42```
43Equipment types: ac_unit, furnace, heat_pump, air_handler, condenser,
44                 evaporator_coil, mini_split, thermostat, ductwork, other
45```
46 
47### check_rfq_status
48Check the status of a submitted RFQ.
49 
50### get_quotes
51Get all quotes received for an RFQ.
52 
53### compare_quotes
54Compare quotes from multiple distributors - identifies best price, fastest delivery, and recommended option.
55 
56### simulate_quote
57(Testing) Simulate a quote response from a distributor without waiting for real email responses.
58 
59## Example Usage
60 
61Ask Claude:
62 
63> "I need a 3-ton AC unit delivered to Naples, FL. Can you get me quotes from distributors?"
64 
65Claude will:
661. Submit RFQs to matching distributors in Florida
672. Return RFQ IDs for tracking
683. You can check status later or simulate quotes for testing
69 
70## Environment Variables
71 
72| Variable | Description | Default |
73|----------|-------------|---------|
74| `HVAC_MOCK_EMAIL` | Use mock email mode for testing | `true` |
75| `SMTP_HOST` | SMTP server hostname | - |
76| `SMTP_PORT` | SMTP server port | `587` |
77| `SMTP_USER` | SMTP username | - |
78| `SMTP_PASS` | SMTP password | - |
79| `SMTP_FROM` | From email address | - |
80| `HVAC_DB_PATH` | SQLite database path | temp directory |
81 
82## How It Works
83 
84Unlike instant-response APIs, this MCP models real-world HVAC procurement:
85 
861. **RFQ Submission**: Sends email requests to distributors (mocked by default)
872. **Async Response**: Distributors respond in 24-48 hours (simulate for testing)
883. **Quote Comparison**: Compare received quotes for best value
89 
90## License
91 
92MIT
93