MarceauSolutions/hvac-quotes-mcp
🐍 🏠 ☁️ - HVAC equipment RFQ management for contractors - submit quotes to distributors, track responses, and compare pricing
Quick Install
{
"mcpServers": {
"marceausolutions-hvac-quotes-mcp": {
"command": "npx",
"args": [
"-y",
"marceausolutions-hvac-quotes-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
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:
- Submit RFQs to matching distributors in Florida
- Return RFQ IDs for tracking
- 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:
- RFQ Submission: Sends email requests to distributors (mocked by default)
- Async Response: Distributors respond in 24-48 hours (simulate for testing)
- Quote Comparison: Compare received quotes for best value
License
MIT