Layer E · Agent Actions & Developers
AI Agents & Developers Guide
Technische Referenz für Browser-Agenten (WebMCP) und externe MCP-Clients über den zustandslosen Streamable-HTTP-Endpunkt /mcp.
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
- /llms.txt — Kompaktes Markdown-Faktenblatt
- /.well-known/mcp/server-card.json — MCP Server Card
- /.well-known/api-catalog — RFC 9727 Linkset (
application/linkset+json) - /.well-known/agent-skills/index.json & SKILL.md — Agent Skills Discovery
- /.well-known/poppy.json — Öffentliche Website-Deklaration
- /robots.txt & /sitemap.xml — Crawler-Signale & Sitemap