AskMarcel — HVAC Technical Knowledge MCP Server

Manufacturer-sourced HVAC technical documentation for AI agents: search, diagnostics, error codes, procedures and product sheets across 126 brands and 905 models.

AskMarcel is a remote, hosted MCP server (Streamable HTTP). There is nothing to install or self-host — point your MCP client at the endpoint and authenticate. The server connects AI agents to real manufacturer documentation so answers cite the exact manual and page number instead of hallucinating.

• Endpoint: https://mcp.askmarcel.app
• Registry name: io.github.askmarcel/mcphvac
• Docs & API key: https://app.askmarcel.app/developers
• Reference: https://app.askmarcel.app/developers/reference
• Free Developer tier: 250 API calls / month

Why AskMarcel

General-purpose LLMs guess at HVAC specifics — refrigerant charge, error-code meanings, wiring, fault trees. AskMarcel grounds every response in indexed manufacturer PDFs and returns the source page, so a field technician or an agent can trust and verify the answer. See HVAC-Bench for measured accuracy vs. raw LLM output.

• 126 brands · 905 models · 400,000+ error codes indexed
• Deterministic error-code lookup (not a guess)
• Sourced one-shot lookups (diagnose) and multi-turn guided troubleshooting for air-to-water heat pumps (diagnose_guided)
• FR / EN, focused on the European HVAC/RACH market

Tools

The server exposes 7 tools. Full reference in docs/tools.md.

Quick start

1. Get an API key

Create a free key at https://app.askmarcel.app/developers (250 calls/month on the Developer tier). The server also supports OAuth 2.0 (PKCE + Dynamic Client Registration) for clients that discover auth automatically.

2. Connect your MCP client

Ready-to-use configs live in examples/. The general form for any Streamable HTTP MCP client:

{
  "mcpServers": {
    "askmarcel": {
      "type": "streamable-http",
      "url": "https://mcp.askmarcel.app",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop / Cursor / VS Code: see the matching file in examples/. Replace YOUR_API_KEY with your key.

3. Ask a question

Once connected, prompt naturally, e.g.:

"Daikin Altherma showing error U4 — what does it mean and how do I clear it?"

The agent calls get_error_code / diagnose and returns the cause, the fix steps, and the source manual page.

MCP vs Chat API

AskMarcel exposes two separate integration surfaces — do not mix their protocols:

The MCP server does not use the AI SDK chat stream (text-delta, data-* parts). If you build a custom agent with the Vercel AI SDK, use MCP tools via JSON-RPC — not the web chat endpoint.

Authentication

Two supported methods (details in docs/authentication.md):

1. API key (Bearer): Authorization: Bearer YOUR_API_KEY
2. OAuth 2.0: discovery via https://mcp.askmarcel.app/.well-known/oauth-protected-resource

Claude Skills

The skills/ folder contains ready-to-use Agent Skills that wrap these tools into HVAC workflows:

• hvac-error-lookup — turn a brand + error code into a sourced explanation and fix.
• hvac-diagnostic — one-shot symptom lookup with citations (diagnose).
• hvac-guided-diagnosis — multi-turn guided troubleshooting for air-to-water heat pumps (diagnose_guided).

REST API SDK

For custom agents that call the REST API directly (not MCP), use the npm package @askmarcel/sdk — includes guidedTurn() for POST /v1/diagnostic/turn.

Links

• MCP endpoint — https://mcp.askmarcel.app
• Developer portal & API key — https://app.askmarcel.app/developers
• API reference — https://app.askmarcel.app/developers/reference
• Templates — https://app.askmarcel.app/templates
• Official MCP Registry — io.github.askmarcel/mcphvac
• Website — https://askmarcel.app

License

Code and content in this repository (documentation, examples, skills) are released under the MIT License. The AskMarcel hosted service and its underlying data are proprietary and governed by the AskMarcel terms.

🇫🇷 En français

AskMarcel est un serveur MCP distant et hébergé (Streamable HTTP) qui connecte les agents IA à la documentation technique HVAC/RACH sourcée constructeur. Rien à installer : on pointe son client MCP sur l'endpoint et on s'authentifie. Chaque réponse cite le manuel et la page exacte plutôt que d'halluciner.

• Endpoint : https://mcp.askmarcel.app
• Nom registre : io.github.askmarcel/mcphvac
• Doc & clé API : https://app.askmarcel.app/developers
• Tier Developer gratuit : 250 appels / mois
• Couverture : 126 marques · 905 modèles · 400 000+ codes erreur indexés

7 outils : search_technical_docs (recherche), get_procedure (procédure complète), get_error_code (lookup déterministe marque + code), get_product_sheet (fiche produit), get_pdf_page_snapshot (URL signée d'une page PDF), diagnose (lookup sourcé en un aller-retour), diagnose_guided (dépannage guidé multi-tours PAC Air/Eau).

Skills : lookup code erreur, diagnostic one-shot, diagnostic guidé PAC — voir skills/.

SDK REST (npm) : @askmarcel/sdk pour intégrer l'API REST (guidedTurn() → POST /v1/diagnostic/turn).

Connexion rapide : créez une clé sur https://app.askmarcel.app/developers, puis utilisez une des configs du dossier examples/ (Claude Desktop, Cursor, VS Code). Remplacez YOUR_API_KEY par votre clé.

MCP vs Chat API : ce dépôt documente le serveur MCP (JSON-RPC sur mcp.askmarcel.app). Le chat web/mobile utilise une API distincte (SSE AI SDK v5 sur /api/chat) — les deux protocoles ne sont pas interchangeables.

Détails des outils : docs/tools.md · Authentification : docs/authentication.md.