MyLeadTech HVAC

HVAC MCP server — fault codes, model lookup and answers cited to the OEM manual page.

Hosted MCP Server

npx add-mcp 'https://mcp.myleadtech.app/mcp/'

Installs into Claude Code, Codex, Cursor and more

Documentation

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": []
    }
  ]
}

License

MIT, for the files in this repository only (README and configuration). The MyLeadTech service and the manufacturer documents it cites are not covered.