Quickstart

In brief

Three steps: get an ak_live_ key, send a diagnostic request, read the sourced JSON response. Contractual host: api.askmarcel.app/v1.

1. Create a Developer key

Go to https://app.askmarcel.app/developers, sign in and create a secret key (ak_live_ prefix). The Developer tier includes 250 requests/month — enough for a POC.

2. Call POST /v1/diagnostic

Send brand, model and error code. The API returns steps, spare-part hint and manufacturer citation (manual, page, section).

curl -s https://api.askmarcel.app/v1/diagnostic \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{"brand":"Mitsubishi","model":"Ecodan PUHZ-W85","error_code":"E7"}'

3. Read the response

Each response includes steps[], source (manual, page, section), confidence and optionally part (spare-part reference). Display as-is in your UI or pass to your agent.

Example response

{
  "diagnostic": "Indoor/outdoor unit communication fault",
  "steps": [
    "Check S1-S2-S3 terminal block (continuity)",
    "Verify link polarity (not reversed)"
  ],
  "part": { "label": "Communication board" },
  "source": {
    "manual": "Ecodan installer manual",
    "page": 34,
    "section": "5.2"
  },
  "confidence": { "score": 0.97, "level": "high" }
}

What's next?

Full reference: https://api.askmarcel.app/v1/openapi.json
AI agent connection: see the MCP page
Platform guides: Claude Desktop, n8n, Make…