Skip to main content
Glama

ikeytz Einsatzgebiet-Karten

Get Discovery

get_discovery
Read-only

WHAT: 1:1 mirror of a maps discovery file (UTF-8 text/JSON). summary ≡ line window + trailing # MCP-META (truncated, totalUrls, nextOffset) — not a one-line stub. which is required — common ids: ard, ai-catalog, ai-txt, ai-plugin, answer-engine, agent-skills, llms, llms-full, llms-index, llms-keywords, llms-serp, llms-jsonld, llms-navigation, llms-impressum-kontakt, llms-orte-geo, llms-grenzen-koordinaten, llms-urheberrecht, llms-copyright, llms-mcp-server, llms-mcp-web, robots, sitemap-txt, sitemap-xml. Omit limit: if remaining >~30KB → first ~30KB window + nextOffset (O9); explicit limit keeps line window 1..10000 (not forced to 30KB). USE for agent-ready catalogs and robots/sitemap. DOES NOT invent missing files (missing=true). NEXT: find_by_keyword / find_by_serp for structured search; get_llms_txt / get_ai_txt aliases.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum number of lines to return after offset. Omit or null = if remaining payload ≤~30KB return all remaining lines; if larger, return first ~30KB window + nextOffset (O9). Explicit limit keeps 1..10000 line window (MCP caps unchanged — not forced to 30KB). Meta also as trailing # MCP-META lines in summary.
whichYesRequired discovery id. Examples: ard, ai-catalog, ai-txt, ai-plugin, answer-engine, agent-skills, llms, llms-full, llms-index, llms-keywords, llms-serp, llms-jsonld, llms-navigation, llms-impressum-kontakt, llms-orte-geo, llms-grenzen-koordinaten, llms-urheberrecht, llms-copyright, llms-mcp-server, llms-mcp-web, robots, sitemap-txt, sitemap-xml.
offsetNo0-based index into a list or discovery file lines (split on \n). 0 = first. Omit = 0. Combine with limit to page. Use nextOffset / offset+limit from a previous result when present.

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 or short recovery hint the agent should open or pass to another tool.
pathNoPublic relative path of the file on maps
textNoUTF-8 line window (file body before # MCP-META). Same bytes as summary without meta trailer.
toolYesEcho of the tool name that produced this object (e.g. get_service_area).
errorNoPresent when ok=false. Codes include: unknown_place, unknown_discovery, unknown_doc, q_required, plz_required, coords_required, outside_service_area, url_required, not_maps_host, bad_url, path_or_url_required, serp_not_found, slug_or_coords_required, path_required.
limitNoApplied line limit, or null if omitted
whichNoResolved discovery id (ard, ai-catalog, llms, robots, sitemap-txt, llms-mcp-server, …).
localeNoLocale actually used for URLs. maps is German-only: always de (MAPS-E8 — no /en on maps). Requested non-de is ignored; payload locale=de.
offsetNoApplied 0-based line offset
missingNotrue if the discovery file was not found on disk
relatedNoAlways includes https://maps.ikeytz.com/llms.txt.
summaryNoPrimary text for the model. For discovery tools this is the file window. For list tools a compact one-liner. Quote with attribution.
totalUrlsNohttp(s) lines in the full file
truncatedNotrue if offset+limit left more lines. Also in trailing # MCP-META.
nextOffsetNoPass as next offset when truncated; else null. Also in # MCP-META.
totalBytesNoFull discovery file size in bytes (UTF-8). Also in trailing # MCP-META.
totalCharsNoFull discovery file character length before offset/limit. Also in # MCP-META.
totalLinesNoAlias of total_lines
attributionYesRequired citation: 'Quelle: Schlüsseldienst Ludwigsburg ikeytz (ikeytz.com) · ai-train=no · https://maps.ikeytz.com/.well-known/ai.txt'
total_linesNoLine count of the full file
canonicalUrlNoBest URL to show the user: https://maps.ikeytz.com… page, public embed JSON, tel:+49…, mailto:…, https://wa.me/…, or a www pointer. Prefer this over constructing URLs.
returnedUrlsNohttp(s) lines in this window
bytesReturnedNoUTF-8 length of text window
returnedLinesNoLines in this window (before # MCP-META)
fetchTruncatedNotrue if a load cap cut the file before paging (www Cap). maps reads full from disk → always false.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum items or lines to return after offset. Omit = all remaining in the window (subject to tool-specific clamps). For geo near-search default is often 5 without radius_km, up to 52 with radius."New value: +"Maximum number of lines to return after offset. Omit or null = if remaining payload ≤~30KB return all remaining lines; if larger, return first ~30KB window + nextOffset (O9). Explicit limit keeps 1..10000 line window (MCP caps unchanged — not forced to 30KB). Meta also as trailing # MCP-META lines in summary."
    • addedInput schema / properties / limit / maximum
      Added value: +10000
  2. Changed1 schema field changed
    • changedInput schema / properties / which / description
      Previous value: -"Required discovery id. Examples: ard, ai-catalog, ai-txt, ai-plugin, answer-engine, agent-skills, llms, llms-full, llms-index, llms-keywords, llms-serp, llms-jsonld, llms-impressum-kontakt, llms-orte-geo, llms-grenzen-koordinaten, llms-urheberrecht, llms-copyright, llms-mcp-server, llms-mcp-web, robots, sitemap-txt, sitemap-xml."New value: +"Required discovery id. Examples: ard, ai-catalog, ai-txt, ai-plugin, answer-engine, agent-skills, llms, llms-full, llms-index, llms-keywords, llms-serp, llms-jsonld, llms-navigation, llms-impressum-kontakt, llms-orte-geo, llms-grenzen-koordinaten, llms-urheberrecht, llms-copyright, llms-mcp-server, llms-mcp-web, robots, sitemap-txt, sitemap-xml."
  3. Changed1 schema field changed
    • changedInput schema / properties / which / description
      Previous value: -"Required discovery id. Examples: ard, ai-catalog, ai-txt, ai-plugin, answer-engine, agent-skills, llms, llms-full, llms-index, llms-keywords, llms-serp, llms-impressum-kontakt, llms-orte-geo, llms-urheberrecht, llms-copyright, llms-mcp-server, llms-mcp-web, robots, sitemap-txt, sitemap-xml."New value: +"Required discovery id. Examples: ard, ai-catalog, ai-txt, ai-plugin, answer-engine, agent-skills, llms, llms-full, llms-index, llms-keywords, llms-serp, llms-jsonld, llms-impressum-kontakt, llms-orte-geo, llms-grenzen-koordinaten, llms-urheberrecht, llms-copyright, llms-mcp-server, llms-mcp-web, robots, sitemap-txt, sitemap-xml."
  4. Changed3 schema fields changed
    • addedOutput schema / properties / fetchTruncated
      Added value: +{
      +  "description": "true if a load cap cut the file before paging (www Cap). maps reads full from disk → always false.",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / totalBytes
      Added value: +{
      +  "description": "Full discovery file size in bytes (UTF-8). Also in trailing # MCP-META.",
      +  "type": "number"
      +}
    • addedOutput schema / properties / totalChars
      Added value: +{
      +  "description": "Full discovery file character length before offset/limit. Also in # MCP-META.",
      +  "type": "number"
      +}
  5. Changed9 schema fields changed
    • removedOutput schema / properties / body
      Removed value: -{
      -  "description": "UTF-8 text window after offset/limit",
      -  "type": "string"
      -}
    • addedOutput schema / properties / bytesReturned
      Added value: +{
      +  "description": "UTF-8 length of text window",
      +  "type": "number"
      +}
    • addedOutput schema / properties / nextOffset
      Added value: +{
      +  "description": "Pass as next offset when truncated; else null. Also in # MCP-META.",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / returnedLines
      Added value: +{
      +  "description": "Lines in this window (before # MCP-META)",
      +  "type": "number"
      +}
    • addedOutput schema / properties / returnedUrls
      Added value: +{
      +  "description": "http(s) lines in this window",
      +  "type": "number"
      +}
    • changedOutput schema / properties / text / description
      Previous value: -"Alias/window of body when present"New value: +"UTF-8 line window (file body before # MCP-META). Same bytes as summary without meta trailer."
    • addedOutput schema / properties / totalLines
      Added value: +{
      +  "description": "Alias of total_lines",
      +  "type": "number"
      +}
    • addedOutput schema / properties / totalUrls
      Added value: +{
      +  "description": "http(s) lines in the full file",
      +  "type": "number"
      +}
    • addedOutput schema / properties / truncated
      Added value: +{
      +  "description": "true if offset+limit left more lines. Also in trailing # MCP-META.",
      +  "type": "boolean"
      +}
  6. Changed8 schema fields changed
    • addedInput schema / properties / limit / description
      Added value: +"Maximum items or lines to return after offset. Omit = all remaining in the window (subject to tool-specific clamps). For geo near-search default is often 5 without radius_km, up to 52 with radius."
    • addedInput schema / properties / limit / minimum
      Added value: +1
    • addedInput schema / properties / offset / default
      Added value: +0
    • addedInput schema / properties / offset / description
      Added value: +"0-based index into a list or discovery file lines (split on \\n). 0 = first. Omit = 0. Combine with limit to page. Use nextOffset / offset+limit from a previous result when present."
    • addedInput schema / properties / offset / minimum
      Added value: +0
    • addedInput schema / properties / which / description
      Added value: +"Required discovery id. Examples: ard, ai-catalog, ai-txt, ai-plugin, answer-engine, agent-skills, llms, llms-full, llms-index, llms-keywords, llms-serp, llms-impressum-kontakt, llms-orte-geo, llms-urheberrecht, llms-copyright, llms-mcp-server, llms-mcp-web, robots, sitemap-txt, sitemap-xml."
    • removedInput schema / properties / which / enum
      Removed value: -[
      -  "llms",
      -  "llms-full",
      -  "llms-index",
      -  "llms-keywords",
      -  "llms-serp",
      -  "llms-impressum-kontakt",
      -  "llms-orte-geo",
      -  "llms-urheberrecht",
      -  "llms-copyright",
      -  "llms-mcp-server",
      -  "llms-mcp-web",
      -  "robots",
      -  "sitemap-txt",
      -  "sitemap-xml",
      -  "ai-txt",
      -  "ai-plugin",
      -  "answer-engine",
      -  "ai-catalog",
      -  "ard",
      -  "agent-skills"
      -]
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "description": "Always the same envelope. tools/call returns content[0].text = summary (or JSON) AND structuredContent = this object. On success ok=true with summary + canonicalUrl + extra fields. On failure ok=false with error (snake_case code) and hint (recovery URL). Never writes, never submits forms, never books. Attribution must be kept when quoting. Policy: ai-input yes with attribution; ai-train=no. Host is maps.ikeytz.com (geo/Einsatzgebiet). Prices/FAQ/legal HTML live on www — maps only points.",
      +  "properties": {
      +    "attribution": {
      +      "description": "Required citation: 'Quelle: Schlüsseldienst Ludwigsburg ikeytz (ikeytz.com) · ai-train=no · https://maps.ikeytz.com/.well-known/ai.txt'",
      +      "type": "string"
      +    },
      +    "body": {
      +      "description": "UTF-8 text window after offset/limit",
      +      "type": "string"
      +    },
      +    "canonicalUrl": {
      +      "description": "Best URL to show the user: https://maps.ikeytz.com… page, public embed JSON, tel:+49…, mailto:…, https://wa.me/…, or a www pointer. Prefer this over constructing URLs.",
      +      "type": "string"
      +    },
      +    "error": {
      +      "description": "Present when ok=false. Codes include: unknown_place, unknown_discovery, unknown_doc, q_required, plz_required, coords_required, outside_service_area, url_required, not_maps_host, bad_url, path_or_url_required, serp_not_found, slug_or_coords_required, path_required.",
      +      "type": "string"
      +    },
      +    "hint": {
      +      "description": "Present when ok=false. Absolute URL or short recovery hint the agent should open or pass to another tool.",
      +      "type": "string"
      +    },
      +    "limit": {
      +      "description": "Applied line limit, or null if omitted",
      +      "type": [
      +        "number",
      +        "null"
      +      ]
      +    },
      +    "locale": {
      +      "description": "Locale actually used for URLs. maps is German-only: always de (MAPS-E8 — no /en on maps). Requested non-de is ignored; payload locale=de.",
      +      "enum": [
      +        "de"
      +      ],
      +      "type": "string"
      +    },
      +    "missing": {
      +      "description": "true if the discovery file was not found on disk",
      +      "type": "boolean"
      +    },
      +    "offset": {
      +      "description": "Applied 0-based line offset",
      +      "type": "number"
      +    },
      +    "ok": {
      +      "description": "true = use summary, canonicalUrl, and extra keys. false = do not invent data; read error + hint and retry with valid args or open hint.",
      +      "type": "boolean"
      +    },
      +    "path": {
      +      "description": "Public relative path of the file on maps",
      +      "type": "string"
      +    },
      +    "related": {
      +      "description": "Always includes https://maps.ikeytz.com/llms.txt.",
      +      "items": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "summary": {
      +      "description": "Primary text for the model. For discovery tools this is the file window. For list tools a compact one-liner. Quote with attribution.",
      +      "type": "string"
      +    },
      +    "text": {
      +      "description": "Alias/window of body when present",
      +      "type": "string"
      +    },
      +    "tool": {
      +      "description": "Echo of the tool name that produced this object (e.g. get_service_area).",
      +      "type": "string"
      +    },
      +    "total_lines": {
      +      "description": "Line count of the full file",
      +      "type": "number"
      +    },
      +    "which": {
      +      "description": "Resolved discovery id (ard, ai-catalog, llms, robots, sitemap-txt, llms-mcp-server, …).",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "ok",
      +    "tool",
      +    "attribution"
      +  ],
      +  "type": "object"
      +}
  7. Changed1 schema field changed
    • changedInput schema / properties / which / enum
      Previous value: -[
      -  "llms",
      -  "llms-full",
      -  "llms-index",
      -  "llms-keywords",
      -  "llms-serp",
      -  "llms-impressum-kontakt",
      -  "llms-orte-geo",
      -  "llms-urheberrecht",
      -  "llms-copyright",
      -  "llms-mcp-server",
      -  "llms-mcp-web",
      -  "robots",
      -  "sitemap-txt",
      -  "sitemap-xml",
      -  "ai-txt",
      -  "ai-plugin",
      -  "answer-engine",
      -  "ai-catalog",
      -  "agent-skills"
      -]New value: +[
      +  "llms",
      +  "llms-full",
      +  "llms-index",
      +  "llms-keywords",
      +  "llms-serp",
      +  "llms-impressum-kontakt",
      +  "llms-orte-geo",
      +  "llms-urheberrecht",
      +  "llms-copyright",
      +  "llms-mcp-server",
      +  "llms-mcp-web",
      +  "robots",
      +  "sitemap-txt",
      +  "sitemap-xml",
      +  "ai-txt",
      +  "ai-plugin",
      +  "answer-engine",
      +  "ai-catalog",
      +  "ard",
      +  "agent-skills"
      +]
  8. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources