AI Agents & Developers Guide

Technische Referenz für Browser-Agenten (WebMCP) und externe MCP-Clients über den zustandslosen Streamable-HTTP-Endpunkt /mcp.

Remote MCP: https://www.hlw-wohnservice.at/mcp Protokoll: JSON-RPC 2.0 (2025-03-26)

1. Agent-Kontextblock

<ai_agent_instructions>
  <execution_preference>WEBMCP_FIRST</execution_preference>
  <remote_mcp_endpoint>https://www.hlw-wohnservice.at/mcp</remote_mcp_endpoint>
  <site_context>
    HLW-Wohnservice GmbH (Unterassling 80, 9911 Assling, Osttirol, AT).
    Tischlerei, Trockenbau & Generalunternehmer-Komplettsanierung.
    Human-readable AI summary: /ai | Comparison: /compare | Markdown: /llms.txt
  </site_context>
  <browser_webmcp>
    Registered via document.modelContext.registerTool() in /webmcp.js:
    get_business_info, get_offers_and_pricing, get_comparison_summary (all read-only).
  </browser_webmcp>
</ai_agent_instructions>

2. Remote Streamable HTTP MCP (/mcp)

Der Endpunkt https://www.hlw-wohnservice.at/mcp läuft als Cloudflare Pages Function (functions/mcp.ts), benötigt keine Authentifizierung und stellt ausschließlich deterministische Read-Only-Tools bereit:

Tool-Name Parameter Rückgabe
get_business_info keine Stammdaten, Fit Statement, Partner, Garantien, UID/FN, Kontakt
get_services_and_pricing category (optional: all | privat | gewerbe | gu) Leistungskategorien, 3-Phasen-Ablauf, Lieferzeiten, Fixpreis-Modell
get_service_areas keine Kerngebiet Osttirol sowie Oberkärnten & Südtirol
get_faq topic (optionaler Suchbegriff) 8 verifizierte Kundenfragen & Antworten
get_contact_channels keine Telefon, E-Mail, Adresse, Anfrageformular, 72h-Reaktionsgarantie
get_comparison_summary keine Strukturierte Vergleichsmatrix aus /compare

Beispiel-Abruf (tools/list)

curl -s -X POST https://www.hlw-wohnservice.at/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

3. Browser-WebMCP (/webmcp.js)

Für In-Browser-Agenten registriert /webmcp.js (mit Feature-Detection auf document.modelContext.registerTool und Fallback auf navigator.modelContext) die Read-Only-Tools get_business_info, get_offers_and_pricing und get_comparison_summary.

4. Maschinenlesbare Discovery-Endpunkte