MyLeadTech HVAC
HVAC MCP server — fault codes, model lookup and answers cited to the OEM manual page.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http myleadtech-hvac 'https://mcp.myleadtech.app/mcp/' --header 'Authorization: <MyLeadTech API key from https://web.myleadtech.app, sent as a Bearer token.>'
{
"mcpServers": {
"myleadtech-hvac": {
"type": "http",
"url": "https://mcp.myleadtech.app/mcp/",
"headers": {
"Authorization": "<MyLeadTech API key from https://web.myleadtech.app, sent as a Bearer token.>"
}
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
MyLeadTech MCP
HVAC MCP server — fault codes, model lookup and answers cited to the OEM manual page.
This repository holds the connection details and registry metadata for the hosted MyLeadTech MCP server. There is no server code here: the server runs at the endpoint below.
- Endpoint:
https://mcp.myleadtech.app/mcp/ - Transport: Streamable HTTP
- Auth: API key from the MyLeadTech dashboard, sent as
Authorization: Bearer <api_key>. The site also lists OAuth sign-in with a MyLeadTech account for clients that support it. - Brands served: Carrier, Trane, Lennox
- Sandbox: 100 free units a month. Equipment lookups and clarifying questions don't count. A retried request with the same idempotency key is never charged twice.
Tools
| Tool | What it does | Parameters |
|---|---|---|
resolve_equipment | Turns a model or nameplate reference into brand and equipment, and reports coverage. Not charged. | reference, market (default us), language (default en-US) |
search_hvac_documents | Finds passages and citations in manufacturer documents. | question, brand, model_reference, fault_code, language, limit (default 5), operation_id |
get_hvac_source | Returns a cited passage with bounded context. | source_id |
answer_hvac_question | A written answer with numbered, page-level sources. | question, brand, model_reference, fault_code, language, limit (default 5), operation_id |
get_hvac_document_page | A source page as PNG, or a signed single-page PDF link when format is pdf. | document_version_id, page_number, format (default png), region |
operation_id makes a retry replay the earlier result instead of charging again.
Install
Create an API key in the dashboard first.
Claude Code
claude mcp add --transport http myleadtech https://mcp.myleadtech.app/mcp/ --header "Authorization: Bearer YOUR_API_KEY"
Without --header, Claude Code can sign you in with your MyLeadTech account instead.
Cursor
Paste into .cursor/mcp.json:
{
"mcpServers": {
"myleadtech": {
"url": "https://mcp.myleadtech.app/mcp/",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
VS Code
Paste into .vscode/mcp.json:
{
"servers": {
"myleadtech": {
"type": "http",
"url": "https://mcp.myleadtech.app/mcp/",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Other clients
Any MCP client that supports remote Streamable HTTP servers: endpoint https://mcp.myleadtech.app/mcp/, header Authorization: Bearer <api_key>.
Example
Call answer_hvac_question with:
{ "question": "What refrigerant does the 27TPA8 use?", "brand": "carrier", "model_reference": "27TPA8" }
Response shape (contract example ar-00/1, answer/ok.json, copied unchanged; not a live call):
{
"request_id": "55555555-5555-4555-8555-555555555501",
"contract_version": "ar-00/1",
"service_revision": "2026.10.06-doc",
"publication": {
"branch": "main",
"snapshot_ref": "main-20261006-5ed-carrier-263ch"
},
"status": "ok",
"partial": false,
"missing": [],
"degraded": [],
"usage": {
"operation": "answer",
"debited": true,
"units": null
},
"answer": "The 27TPA8 is a Performance Series 2-stage heat pump for R-454B indoor units only.",
"claims": [
{
"text": "Uses Puron Advance (R-454B) refrigerant.",
"source_id": "chunk:1a9595df-e0cb-4dfe-83d8-504e1da1757a"
}
],
"limits": [],
"passages": [
{
"source_id": "chunk:1a9595df-e0cb-4dfe-83d8-504e1da1757a",
"document_version_id": "65a562f3-1c45-4071-be67-30b35eac7393",
"document_type": "product_data",
"text": "27TPA8 Performance Series 2-Stage Heat Pump with Puron Advance™ (R-454B) Refrigerant …",
"pages": [
1
],
"printed_label": null,
"applicability": "established",
"rank": 1,
"citations": []
}
]
}
Links
- Developer docs: https://myleadtech.app/developers/docs
- MCP guide: https://myleadtech.app/developers/mcp
- REST OpenAPI spec: https://api.myleadtech.app/v1/openapi.json
- Site: https://myleadtech.app
- Get an API key: https://web.myleadtech.app
License
MIT, for the files in this repository only (README and configuration). The MyLeadTech service and the manufacturer documents it cites are not covered.
الأسئلة الشائعة
ما هو MyLeadTech HVAC؟
HVAC MCP server — fault codes, model lookup and answers cited to the OEM manual page.
كيف أثبّت MyLeadTech HVAC؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http myleadtech-hvac 'https://mcp.myleadtech.app/mcp/' --header 'Authorization: <MyLeadTech API key from https://web.myleadtech.app, sent as a Bearer token.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج MyLeadTech HVAC إلى مفتاح API؟
نعم. يتطلب Authorization، وتضبطها في إعداداته.
هل MyLeadTech HVAC مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون MyLeadTech HVAC؟
ينشره MyLeadTech. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.