MyLeadTech HVAC

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.