| ok | Yes | true = use summary, canonicalUrl, and extra keys. false = do not invent data; read error + hint and retry with valid args or open hint. | |
| hint | No | Present when ok=false. Absolute URL the agent should open or pass to get_ai_page / get_discovery. | |
| path | No | Public path on www, e.g. /llms.txt or /.well-known/ai.txt | |
| tool | Yes | Echo of the tool name that produced this object (e.g. get_service_area). | |
| error | No | Present when ok=false. Codes include: unknown_tool, unknown_place, unknown_auswahl, unknown_ratgeber, unknown_doc, unknown_discovery, faq_not_found, wissen_not_found, serp_not_found, q_required, bad_datetime, bad_when_key, plus HTTP errors from fetch. | |
| limit | No | Applied line limit, or null if the caller omitted limit. | |
| which | No | Resolved discovery id after alias fold (llms, sitemap-txt, ard, ai-catalog, …). | |
| locale | No | Locale actually used for URLs (args.locale or de). | |
| offset | No | Applied 0-based line offset. | |
| related | No | Always includes https://www.ikeytz.com/llms.txt. Geo tools also include https://maps.ikeytz.com/llms.txt. | |
| summary | No | Primary text for the model. For discovery tools this is the file window (possibly thousands of characters). For list tools a compact one-liner. Quote with attribution. | |
| totalUrls | No | http(s) lines in the loaded file (full count when public/ read succeeds). | |
| truncated | No | true if load hit a byte cap OR offset+limit left more lines. Also mirrored in trailing # MCP-META lines in summary. | |
| nextOffset | No | offset + returnedLines when more lines remain in the loaded file; else null. Pass as the next offset. Also in # MCP-META. | |
| totalBytes | No | Full origin file size when Content-Length is present (e.g. llms-keywords ~50MB); else character length of the downloaded body before the load cap. Also in # MCP-META. | |
| totalChars | No | Character length of the downloaded body before applying discoveryFetchMax (may equal totalBytes for ASCII). | |
| totalLines | No | Line count of the loaded file (full public/ file when available). | |
| attribution | Yes | Required citation: 'Quelle: Schlüsseldienst Ludwigsburg ikeytz (ikeytz.com) · ai-train=no · https://www.ikeytz.com/.well-known/ai.txt' | |
| canonicalUrl | No | Best URL to show the user: https://www.ikeytz.com… page, or tel:+49…, mailto:…, https://wa.me/…. Prefer this over constructing URLs. | |
| returnedUrls | No | Lines in this window that start with http(s):// | |
| bytesReturned | No | UTF-8 byte length of the returned body window (before # MCP-META). | |
| returnedLines | No | How many lines are in summary/body this call (before # MCP-META). | |
| fetchTruncated | No | true if discoveryFetchMax cut the load (line-boundary safe). Large discovery files (sitemap-xml ~12MB, llms-keywords ~55MB, llms-index ~2MB) must load full so offset/limit can reach EOF. | |