Für KI-Agenten & Entwickler

Entwickler-Portal

Die GTÜ Prüfstelle Am Kuchenberg stellt ihre Terminbuchung, Preise und Verfügbarkeiten als offene KI-Schnittstellen (MCP + A2A) bereit. So können Assistenten wie ChatGPT, Claude, Gemini & Co. direkt Termine vermitteln.

Endpunkte

MCP

POST https://gtue-hein.de/api/mcp

A2A

POST https://gtue-hein.de/api/a2a

Agent Card

GET https://gtue-hein.de/.well-known/agent-card.json

Service Graph

GET https://gtue-hein.de/.well-known/service-graph.json

Trust

GET https://gtue-hein.de/.well-known/agent-trust.json

Health

GET https://gtue-hein.de/api/public/health

Authentifizierung

Aktuell öffentlich zugänglich (keine API-Keys nötig). Requests werden über User-Agent identifiziert und protokolliert.

Für Buchungen gelten Rate-Limits und Tages-Quoten pro Agent. Der Betreiber kann einzelne Skills sperren oder den Notfall-Schalter aktivieren (dann HTTP 503).

A2A Skills (JSON-RPC 2.0)

inspection.recommend

Empfiehlt passende Prüfart inkl. Preis und Doku.

Beispiel-Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "parts": [],
      "metadata": {
        "skill": "inspection.recommend",
        "input": {
          "vehicle_type": "pkw",
          "first_registration_year": 2018
        }
      }
    }
  }
}

inspection.urgent

HU-Plakette abgelaufen? Nächster Notfall-Slot.

Beispiel-Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "parts": [],
      "metadata": {
        "skill": "inspection.urgent",
        "input": {
          "plate_expiry": "2026-08"
        }
      }
    }
  }
}

services.list

Alle Prüfarten mit Preis und Dauer.

Beispiel-Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "parts": [],
      "metadata": {
        "skill": "services.list",
        "input": {}
      }
    }
  }
}

documents.required

Benötigte Unterlagen für eine Prüfart.

Beispiel-Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "parts": [],
      "metadata": {
        "skill": "documents.required",
        "input": {
          "inspection_type": "pkw_hu"
        }
      }
    }
  }
}

inspection.slots

Verfügbare Termine im Zeitraum.

Beispiel-Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "parts": [],
      "metadata": {
        "skill": "inspection.slots",
        "input": {
          "inspection_type": "pkw_hu",
          "from": "2026-07-10",
          "to": "2026-07-20"
        }
      }
    }
  }
}

inspection.next_slot

Nächster freier Termin.

Beispiel-Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "parts": [],
      "metadata": {
        "skill": "inspection.next_slot",
        "input": {
          "inspection_type": "pkw_hu",
          "prefer": "morning"
        }
      }
    }
  }
}

inspection.book

Termin buchen. Bei Retry gleichen idempotency_key mitgeben.

Beispiel-Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "parts": [],
      "metadata": {
        "skill": "inspection.book",
        "input": {
          "start_time": "2026-07-10T09:00:00+02:00",
          "inspection_type": "pkw_hu",
          "customer": {
            "name": "…",
            "email": "…",
            "phone": "…"
          },
          "idempotency_key": "uuid"
        }
      }
    }
  }
}

inspection.status

Status einer Buchung prüfen.

Beispiel-Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "parts": [],
      "metadata": {
        "skill": "inspection.status",
        "input": {
          "booking_id": "uuid"
        }
      }
    }
  }
}

contact.info

Adresse, Telefon, Zahlungsmittel.

Beispiel-Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "parts": [],
      "metadata": {
        "skill": "contact.info",
        "input": {}
      }
    }
  }
}

business.hours

Live-Öffnungsstatus.

Beispiel-Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "parts": [],
      "metadata": {
        "skill": "business.hours",
        "input": {}
      }
    }
  }
}

MCP (Model Context Protocol)

Alle 10 Tools stehen auch als MCP zur Verfügung. Konfiguration in Claude Desktop / Cursor / ChatGPT:

{
  "mcpServers": {
    "gtue-hein": { "url": "https://gtue-hein.de/api/mcp" }
  }
}

Datenschutz & Kontakt

Personenbezogene Daten (Name, E-Mail, Telefon) werden nur zur Terminabwicklung verarbeitet. Details in der Datenschutzerklärung.

Fragen oder Missbrauch melden: info@gtue-hein.de