Skip to main content
Glama

ikeytz - Schlüsseldienst Ludwigsburg

Get Sitemap Txt

get_sitemap_txt
Read-only

WHAT: Fetch /sitemap.txt (same URL set as sitemap.xml). ~9076 http-URLs (Stand 2026-09-22): marketing ×7 + discovery/media. Contains 0× maps.ikeytz.com (intentional). summary = line window + trailing # MCP-META (totalUrls, nextOffset, truncated). Use offset/limit + nextOffset to page; omit limit for the full list. Dedicated maps list is on maps.ikeytz.com, not here.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum number of lines to return after offset. Omit or null = return every remaining line in the loaded file. Clamped to 1..10000. For sitemap.txt (~9076 http-URLs, Stand 2026-09-22) omit limit to get the full list (or page with offset/limit + nextOffset). For llms-keywords.txt prefer a window; the file is huge. Meta also as trailing # MCP-META lines in summary.
offsetNo0-based line index into the fetched UTF-8 file (split on \n). 0 = first line. Omit = 0. Combined with limit = a sliding window. Use nextOffset from the previous result to page. Does not count bytes; one line can be a long URL.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okYestrue = use summary, canonicalUrl, and extra keys. false = do not invent data; read error + hint and retry with valid args or open hint.
hintNoPresent when ok=false. Absolute URL the agent should open or pass to get_ai_page / get_discovery.
pathNoPublic path on www, e.g. /llms.txt or /.well-known/ai.txt
toolYesEcho of the tool name that produced this object (e.g. get_service_area).
errorNoPresent 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.
limitNoApplied line limit, or null if the caller omitted limit.
whichNoResolved discovery id after alias fold (llms, sitemap-txt, ard, ai-catalog, …).
localeNoLocale actually used for URLs (args.locale or de).
offsetNoApplied 0-based line offset.
relatedNoAlways includes https://www.ikeytz.com/llms.txt. Geo tools also include https://maps.ikeytz.com/llms.txt.
summaryNoPrimary 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.
totalUrlsNohttp(s) lines in the loaded file (full count when public/ read succeeds).
truncatedNotrue if load hit a byte cap OR offset+limit left more lines. Also mirrored in trailing # MCP-META lines in summary.
nextOffsetNooffset + returnedLines when more lines remain in the loaded file; else null. Pass as the next offset. Also in # MCP-META.
totalBytesNoFull 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.
totalCharsNoCharacter length of the downloaded body before applying discoveryFetchMax (may equal totalBytes for ASCII).
totalLinesNoLine count of the loaded file (full public/ file when available).
attributionYesRequired citation: 'Quelle: Schlüsseldienst Ludwigsburg ikeytz (ikeytz.com) · ai-train=no · https://www.ikeytz.com/.well-known/ai.txt'
canonicalUrlNoBest URL to show the user: https://www.ikeytz.com… page, or tel:+49…, mailto:…, https://wa.me/…. Prefer this over constructing URLs.
returnedUrlsNoLines in this window that start with http(s)://
bytesReturnedNoUTF-8 byte length of the returned body window (before # MCP-META).
returnedLinesNoHow many lines are in summary/body this call (before # MCP-META).
fetchTruncatedNotrue 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.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / fetchTruncated / description
      Previous value: -"true if discoveryFetchMax cut the load (line-boundary safe). sitemap-xml (~12MB) and llms-index (~2MB) must load full; keywords stay capped — use totalBytes."New value: +"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."
  2. Changed1 schema field changed
    • changedOutput schema / properties / fetchTruncated / description
      Previous value: -"true if discoveryFetchMax cut the load (line-boundary safe). sitemap-xml must load full (~12MB cap); keywords stay capped — use totalBytes."New value: +"true if discoveryFetchMax cut the load (line-boundary safe). sitemap-xml (~12MB) and llms-index (~2MB) must load full; keywords stay capped — use totalBytes."
  3. Changed3 schema fields changed
    • changedOutput schema / properties / fetchTruncated / description
      Previous value: -"true if a byte cap cut the load (line-boundary safe). Rare for sitemap.txt (reads public/)."New value: +"true if discoveryFetchMax cut the load (line-boundary safe). sitemap-xml must load full (~12MB cap); keywords stay capped — use totalBytes."
    • addedOutput schema / properties / totalBytes
      Added value: +{
      +  "description": "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.",
      +  "type": "number"
      +}
    • addedOutput schema / properties / totalChars
      Added value: +{
      +  "description": "Character length of the downloaded body before applying discoveryFetchMax (may equal totalBytes for ASCII).",
      +  "type": "number"
      +}
  4. Changed8 schema fields changed
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum number of lines to return after offset. Omit or null = return every remaining line in the fetch window (not the whole disk file if the fetch itself truncated). Clamped to 1..10000. For sitemap.txt (~807 URL lines) omit limit to get the full list. For llms-keywords.txt prefer a window; the file is huge."New value: +"Maximum number of lines to return after offset. Omit or null = return every remaining line in the loaded file. Clamped to 1..10000. For sitemap.txt (~9076 http-URLs, Stand 2026-09-22) omit limit to get the full list (or page with offset/limit + nextOffset). For llms-keywords.txt prefer a window; the file is huge. Meta also as trailing # MCP-META lines in summary."
    • changedOutput schema / properties / bytesReturned / description
      Previous value: -"UTF-8 byte length of the returned body window."New value: +"UTF-8 byte length of the returned body window (before # MCP-META)."
    • addedOutput schema / properties / fetchTruncated
      Added value: +{
      +  "description": "true if a byte cap cut the load (line-boundary safe). Rare for sitemap.txt (reads public/).",
      +  "type": "boolean"
      +}
    • changedOutput schema / properties / nextOffset / description
      Previous value: -"offset + returnedLines when more lines remain; else null. Pass as the next offset."New value: +"offset + returnedLines when more lines remain in the loaded file; else null. Pass as the next offset. Also in # MCP-META."
    • changedOutput schema / properties / returnedLines / description
      Previous value: -"How many lines are in summary/body this call."New value: +"How many lines are in summary/body this call (before # MCP-META)."
    • changedOutput schema / properties / totalLines / description
      Previous value: -"Line count of the fetched text (after byte cap)."New value: +"Line count of the loaded file (full public/ file when available)."
    • changedOutput schema / properties / totalUrls / description
      Previous value: -"http(s) lines in the fetched text."New value: +"http(s) lines in the loaded file (full count when public/ read succeeds)."
    • changedOutput schema / properties / truncated / description
      Previous value: -"true if fetch hit a byte cap OR offset+limit left more lines."New value: +"true if load hit a byte cap OR offset+limit left more lines. Also mirrored in trailing # MCP-META lines in summary."
  5. Changed1 schema field changed
    • changedOutput schema / properties / which / description
      Previous value: -"Resolved discovery id after alias fold (llms, sitemap-txt, ai-catalog, …)."New value: +"Resolved discovery id after alias fold (llms, sitemap-txt, ard, ai-catalog, …)."
  6. First observed

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the readOnlyHint annotation, the description discloses the total URL count, the date of the dataset, the content breakdown, the intentional absence of maps URLs, and the summary structure including MCP-META fields (totalUrls, nextOffset, truncated). This gives an agent a concrete model of what the tool returns and how pagination behaves.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is dense but organized: the WHAT line front-loads the core purpose, followed by size, composition, exclusions, and pagination. Every sentence contributes distinct information, and the terseness like 'marketing ×7 + discovery/media' is efficient rather than vague.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the readOnlyHint annotation, the detailed input schema, and the presence of an output schema, the description covers all the essential behavioral context an agent needs: what file is fetched, what it contains, what it intentionally omits, and how to page through results. Nothing critical is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage for parameters is 100%, so the baseline is 3. The description adds value by contextualizing the parameters: it explains the sitemap size, that omitting limit returns everything, and that the pagination pattern applies specifically to sitemap.txt. It reinforces the schema without contradicting it, though much of the parameter detail is already in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource ('Fetch /sitemap.txt') and distinguishes it from related maps content by stating that maps.ikeytz.com entries are intentionally absent. It clearly defines the tool's scope and content set, making it easy to differentiate from sibling site-content tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives explicit pagination guidance: use offset/limit + nextOffset to page, omit limit for the full list. It also excludes maps.ikeytz.com as a separate resource and, in the parameter description, advises using a window for llms-keywords.txt instead of the full list. This is actionable when-to-use and when-not-to-use guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources